Copyright 2009-2013 the original author or authors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
The GIT version of this project is currently being restructured. The project may not be completely stable in all configurations and uses.
The source code for the latest, stable version of this project can be downloaded as a tar bundle from: http://dev.wavemaker.com/wiki/bin/wmdoc_6.4/644Download In the 'Source Code Bundle' section.
In order to build WaveMaker you will need the following applications:
- Java JDK 6 (http://www.oracle.com/technetwork/java/javase/downloads/index.html).
- Apache Maven 3.x (http://maven.apache.org/)
To clone the WaveMaker repository, use git clone:
git clone https://github.com/SpringSource/wavemaker.git
To build the complete WaveMaker distribution, including installer, run the maven from the root directory:
mvn clean install
To build only WaveMaker studio and required libraries, build in the wavemaker sub folder:
cd wavemaker
mvn clean install
The resultant WAR file can be deployed to your own tomcat, see also Inplace Deployment.
If git is in the path of the build environment, the last commit SHA1 object name will be recorded in boot.js and the installer's version file.
Use the DojoBuild profile to build the gzip version of the libraries. This will enable you to run without ?debug
mvn -PDojoBuild clean install
The installer package built will be dependent on your operating system. The following operating systems are currently supported:
- Mac OSX
- Linux (Centos or Ubuntu)
- Windows
Building the windows installer requires zip file of the jdk to be redistributed be available. This zip file can not be in the public repository and must be provided. Set BUILD_JDK_ZIP to the folder containing the zip file. e.g. set BUILD_JDK_ZIP=c:\downloads The file should be named 'jdk1.6.0_24.zip' and include the folder jdk-1.6.0_24 at the top level of the archive.
To develop WaveMaker using Eclipse or STS run the following from the root directory:
mvn eclipse:eclipse
From Eclipse choose File, Import Existing Projects to load projects into eclipse.
WaveMaker studio can be deployed using Eclipse Webtools to an Apache Tomcat 6 installation.
If you are primarily working on the JavaScript aspects of WaveMaker you might want to use inplace deployment. Inplace deployment allows changes to be immediately updated in the deployed application.
To use live deployment follow these steps: Download and install Apache Tomcat 6 from http://tomcat.apache.org/download-60.cgi
Enable the manager application by editing /conf/tomcat-users.xml and adding the following:
<tomcat-users>
<role rolename="manager"/>
<user username="manager" password="manager" roles="manager"/>
</tomcat-users>
Build and deploy the project using Maven:
cd wavemaker
mvn clean install
cd wavemaker-studio
mvn -PInplace resources:resources war:inplace tomcat:inplace
Use the deployed application http://localhost:8080/wavemaker/?debug