Sencha build steps for SSP

Currently, Sencha is part of the maven build process for SSP 2.0. Eventually, the same configuration will be added to the rel-1-2-patches and rel-1-1-patches branches.

Sencha Installation

Sencha SDK Tools can be downloaded from here: http://www.sencha.com/products/sdk-tools/download/

These steps are relevant for both the automated process as well as the manual process:

1) Install sencha tools. Especially if installing in a Windows environment, it has proven problematic if there is a space in the path name (if installed in Program Files.) It is best to install Sencha tools to a directory in which there are no embedded spaces.

2) Add the installation directory to your PATH. Will look something like:

for OSX:
export PATH="/Applications/SenchaSDKTools-2.0.0-beta3:$PATH"

for Windows (easiest to add environment variable; or set from cmd prompt):

set path=%path%;<Sencha SDK Tools Installation Dir>

You can validate your Sencha installation by typing the following command (should get usage information back):
%> sencha --help

GENERAL DEVELOPMENT PROCESS

Developers should note that when adding new Ext classes, it is important to edit the ssp.jsb3 file so that the new classes will be included in the minification process. This isn't currently automated.

If a developer is working on a JavaScript-heavy part of the application, he would typically modify ssp-main.jsp to include app.js rather than app-all.js, hack away on the .js files in the the source tree, and copy them to the running Tomcat instance in order to see the effects of the change. This process is still proper if development is happening on the 1.1 or 1.2 branch. The 2.0 branch handles much of this due to some additional maven profiles and an additional configuration setting that properly adjusts the ssp-main.jsp file accordingly.

AUTOMATED PROCESS (SSP 2.0)

Critical parts of the Sencha build to process automatically are:

1) An additional environment variable was added to ssp-config.properties called ssp_main_use_minified_js.

When set to true, ssp-main.jsp will include the reference to the minified js called app-all.js

When set to false, ssp-main.jsp will include the reference to the non-minified app.js

2) Three additional profiles added to SSP's pom.xml

profile for calling Sencha from Windows (called WINS)

provile for calling Sencha from *inux (called LINUX)

profile for skipping the sencha build (called SKIP_SENCHA)

The default behavior is to generate the aggregated files (app-all.js and all-classes.js). To build without the aggregated files, one can call:

%> mvn -PSKIP_SENCHA clean install

If this is done, it is also advisable to set ssp_main_use_minifed_js=false in ssp-config.properties so that ssp-main.jsp will look for and utilize app.js.

MANUAL PROCESS (SSP 1.1.x and SSP 1.2.x)

Eventually, the same automated configuration will be added to the 1.2.x and 1.1.x. Until then, the manual process for these versions is:

1) cd over to the directory with your ssp.jsb3 file:
%> cd {src_root}/src/main/webapp

2) Run the sencha tool (note the dot at the end):
%> sencha build -p ssp.jsb3 -d .

3) Add the resulting files to git:
%> git add app-all.js all-classes.js