EaselJS uses Grunt to manage the build process.

To use

Note that this requires a familiarity with using the command line. The example commands shown are for use with the OSX Terminal.

Install dependencies

sass (3.3 or greater is required):

# ruby is required for sass. Check http://sass-lang.com/install for dependencies.
# Install (or update) sass
gem install sass;

Node (0.10.x or greater is required):

# check the version via the command line
node -v

If your Node install is out of date, get the latest from NodeJS.org

After node is setup, install the other dependencies. You may want to familiarize yourself with the Node Packager Manager (NPM) before proceeding.

# Install the grunt command line utility globally
sudo npm install grunt-cli -g

# Change to the build directory, which contains package.json
cd /path/to/libraryName/build/

# Install all the dependencies from package.json
npm install

Setup

You can change the default settings to suit your local work environment by overriding them in a "config.local.json" file in the build directory. All paths can either be relative to the build folder, or absolute paths.

• docs_out_path - Location of the uncompressed generated docs.

Building

To export a release build for this library run:

grunt build

This command will:

• Update the version.js file(s) with the current date and version number from config
• Create the {PROJECT_NAME}-{VERSION}.min.js file, and move it to ../lib
• Generate the documentation in the docs_out_path from config
• Create a zip file of the documentation and move it to ../docs

NEXT version

The same process as above, but uses "NEXT" as the version. This is used to generate minified builds with the latest source between release versions.

grunt next

Combined File

The same as the NEXT process, but will not minify the source code. All code formatting and comments are left intact.

grunt combine

All commands

• grunt build - Build everything based on the version in package.json
• grunt next - Build everything using the NEXT version.
• grunt combine - Build a NEXT version, but leave comments and formatting intact.
• grunt docs - Build only the docs
• grunt exportScriptTags - Export valid <script /> tags from the config.json file.
• grunt nextlib - Export NEXT versions of the lib.