A browser-based development environment for rich data-driven web applications
JavaScript Java CSS PHP XSLT Shell Other

README.md

WaveMaker

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.

NOTICE

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.

INSTRUCTIONS

Building

In order to build WaveMaker you will need the following applications:

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.

Dojo Build

Use the DojoBuild profile to build the gzip version of the libraries. This will enable you to run without ?debug

    mvn -PDojoBuild clean install

Installer Builds

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.

Importing into Eclipse/STS

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.

Inplace Deployment

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