GDevelop/GDevelop.js

GDevelop.js

This is a port of some parts of GDevelop to Javascript using Emscripten.

GDevelop is a full featured, cross-platform, open-source game creator software requiring no programming skills. Download it on the official website.

How to build

• Make sure you have CMake 3.5+

• Install Emscripten, as explained on the Emscripten installation instructions:

git clone https://github.com/juj/emsdk.git
cd emsdk
./emsdk update
./emsdk install sdk-1.37.37-64bit
./emsdk activate sdk-1.37.37-64bit
source ./emsdk_env.sh

(on Windows run emsdk instead of ./emsdk, and emsdk_env.bat instead of source ./emsdk_env.sh. For up-to-date information, check again Emscripten installation instructions).

• Make sure you have Node.js installed and grunt:

    npm install -g grunt-cli

• Launch the build from GDevelop.js folder:

    cd GDevelop.js
    npm install
    npm run build

Output is created in /path/to/GD/Binaries/Output/libGD.js/.

• You can then launch GDevelop 5 that will use your build of Gdevelop.js:

    cd ..
    cd newIDE/app
    npm install
    npm start

More information in GDevelop 5 readme.

Tests

npm test

About the internal steps of compilation

The grunt build task:

• create Binaries/embuild directory,
• patch SFML Config.hpp file to make Emscripten recognized as a linux target,
• launch CMake inside to compile GDevelop with Emscripten toolchain file,
• update the glue.cpp and glue.js from Bindings.idl using Emscripten WebIDL Binder,
• launch the compilation with make and wrap the generated libGD.js.raw into the final libGD.js file.

It also create a compressed libGD.js.gz file which is handy for distributing the library pre-compressed to web browsers.

Documentation

• The file Bindings.idl describes all the classes available in GDevelop.js.
• Refer to GDevelop documentation for detailed documentation of the original C++ classes.