Setup build environment. Install a git client, jdk8, ant, python, C++ compiler and linker

1. Install the latest jdk8u20
2. Ensure ant is installed and ant -version is 1.8+
3. Ensure python is installed and python --version is 2.7.5+
   tip: python3 does not work
4. Ensure ant, jdk8, python and appropriate platform-specific C++ compiler and linker are in the PATH
5. If needed, install a git client for your OS. Windows users see below
6. Extra steps for Windows users
   1. Install a unix emulation like cygwin or mingw/msys. If using Git for Windows, a version of msys is already included. This unix emulation provides the gnu diff and patch utilities.
   2. Install Microsoft Visual Studio. Any recent version should be OK (2010, 2012, 2013 have been known to work). Express versions will do.
   3. Ensure that link.exe is the one from Visual Studio and not from cygwin or mingw/msys.
   4. If a unix user, start bash --login from within a Visual Studio Command Prompt to ensure that the Visual Studio environment is inherited.

Download node.js source

1. git clone https://github.com/joyent/node.git source
2. cd source
3. git checkout v0.10.32
   tip: run git pull to refresh the repo if you get an error saying that this version is unknown
4. cd ..

Clone dependencies. Substitute <id> with your java.net id in the URLs below. Use the read-only URLs below if you do not have a java.net id. It is strongly recommended that all dependencies be cloned at the same level as node.js as in step 2.1 above

1. git clone git://java.net/avatar-js~libuv-java libuv-java (read-only)
   git clone ssh://<id>@git.java.net/avatar-js~libuv-java libuv-java

2. git clone git://java.net/avatar-js~http-parser-java http-parser-java (read-only)
   git clone ssh://<id>@git.java.net/avatar-js~http-parser-java http-parser-java

3. git clone git://java.net/avatar-js~src avatar-js (read-only)
   git clone ssh://<id>@git.java.net/avatar-js~src avatar-js

4. Download test-ng. Unzip the downloaded bundle and place testng jar somewhere in your workspace

Edit ~/.avatar-js.properties to set various locations. Ensure that there are no double slashes and no trailing slash, for example

source.home = /ws/source (from 2.1)
libuv.home = /ws/libuv-java (from 3.1)
http-parser.home = /ws/http-parser-java (from 3.2)
avatar-js.home = /ws/avatar-js (from 3.3)
testng.jar = /ws/lib/testng.jar (from 3.4)

Setup your environment so that native libraries can be found

export LD_LIBRARY_PATH=$PWD/dist:$LD_LIBRARY_PATH (linux)
export DYLD_LIBRARY_PATH=$PWD/dist:$DYLD_LIBRARY_PATH (mac)
export PATH=%CWD%/dist;%PATH% (windows)

Configure

cd avatar-js
ant setup

Build

ant clean-all
ant jar-all
tip: ant -Dbuild.type=Release jar-all builds the Release configuration

Test

java -jar dist/avatar-js.jar src/test/js/test-runner.js test/simple (runs the unit tests)
java -jar dist/avatar-js.jar src/test/js/test-runner.js test/crypto (runs the crypto tests)
java -jar dist/avatar-js.jar src/test/js/test-runner.js -timeout 180 test/pummel (runs the pummel tests)

tip: Some crypto tests require Java Cryptography Extension Unlimited Jurisdiction Policy Files. Follow the instructions in the download. Files for Java7 work in Java8.

tip: Might need to set LANG=en_US.UTF-8

tip: test-runner.js supports many options, run it with -help or look at its source for more information

Running applications. For example

java -jar dist/avatar-js.jar app.js
or
java -Djava.library.path=dist -jar dist/avatar-js.jar app.js
or
java -Xmx4g -Djava.library.path=dist -jar dist/avatar-js.jar app.js