HOW_TO_COMPILE.md

Prerequisites (Unix only):

* GCC 4.2 or newer (for SpiderMonkey builds 4.7+)
* Python 2.6 or 2.7
* GNU Make 3.81 or newer
* libexecinfo (FreeBSD and OpenBSD only)
* for SpiderMonkey : 'which' python module (sudo easy_install tools/which-1.1.0-py2.7.egg)
* for Windows (VS2012+) and Visual C++ Redistributable

First clone the source codes from Github: (or Download as a .zip file)

git clone https://github.com/jxcore/jxcore.git

You may want to jump into Android, or iOS compilation details.

To compile for desktop/server environments:

SpiderMonkey

./configure --prefix=/jxcoreSM --engine-mozilla
make install

V8

./configure --prefix=/jxcoreV8
make install

On Windows:

/ $> vcbuild.bat

To compile with SpiderMonkey, --engine-mozilla key also applies to Windows builds. i.e. vcbuild.bat --engine-mozilla

After a successful compilation process, you should have jxcore installed into /jxcoreSM/bin or /jxcoreV8/bin folder (depending on the engine selection).

JXcore internal JavaScript files can be embedded in two ways (compressed, or as-is). If you are planning to use jx binary for a native package creation, we advice you to use the compressed build. !! In order to compile with compressed build, you should have a jx binary ready on your platform. You may compile the non-compressed version first and then compressed one second.

SpiderMonkey and Compressed Internals

./configure --prefix=/jxcoreSM --engine-mozilla --compress-internals
make install

V8 and Compressed Internals

./configure --prefix=/jxcoreV8 --compress-internals
make install

Windows;

/ $> vcbuild.bat --compress-internals

Compile as a Static Library You can compile JXcore as a static library and embed it into your solution.

Simply add --static-library parameter to one of the above configure definitions. You should have the compiled lib files inside the target installation folder.

On Windows;

/ $> vcbuild.bat --shared-library

Notes

If your python binary is in a non-standard location or has a non-standard name, run the following instead:

export PYTHON=/path/to/python
$PYTHON ./configure
make
make install

You can download (latest stable) binaries for various operating systems from
http://jxcore.com/downloads/
(Future jxcore.io releases will be shared from http://jxcore.io)

For Windows

If you run vcbuild.bat without specifying the target architecture, it will be determined by a current Python version you have installed (not the operating system architecture). Thus, if you have Python x86 installed on Windows x64, then vcbuild.bat will build x86 JXcore binaries (instead of probably expected JXcore x64). To build JXcore x64 on Windows x64, you need to make sure, that you use Python installer for x64 platforms, e.g. python-2.7.9.amd64.msi.

Then you can still build JXcore x32 on Windows x64:

/ $> vcbuild.bat ia32

For CentOS/Red Hat

If you'll ever have problem with GCC 4.7+ installation on Red Hat, please see #297.

Compiling against Mipsel

Your linux distro might be using an older version of GCC. We encoruage you to set --dest-os=mipsel explicitly within the ./configure call