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/cloudjee/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

All of these need JAVA in the class path.

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