Skip to content

Latest commit

 

History

History
133 lines (97 loc) · 3.86 KB

HOW_TO_COMPILE.md

File metadata and controls

133 lines (97 loc) · 3.86 KB
Raw

Prerequisites (Unix only):

* GCC 4.2 or newer (for SpiderMonkey builds 4.7+)
* Python 2.7.x
* GNU Make 3.81 or newer
* libexecinfo (FreeBSD and OpenBSD only)
* for Windows (VS2012+) and Visual C++ Redistributable

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

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

If all you want to compile JXcore for mobile platforms, 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). (Check Release folder on Windows)

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 use the 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
Additional keys

--no-sqlite : do not embed sqlite3 (by default JXcore embeds sqlite)

--embed-leveldown : embed leveldown engine into JXcore (by default JXcore doesn't embed leveldown)

You need to init git submodule to compile JXcore with leveldown embedded

git submodule init
git submodule update

For leveldown-mobile API, see https://github.com/Level/leveldown-mobile

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
Download JXcore

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)

Notes 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
Notes 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 encourage you to set --dest-os=mipsel explicitly within the ./configure call

./configure ...... --dest-os=mipsel