Skip to content

Latest commit

 

History

History
177 lines (116 loc) · 3.58 KB

01.GETTING-STARTED.md

File metadata and controls

177 lines (116 loc) · 3.58 KB
Raw

Setting up prerequisites

Currently, only Ubuntu 14.04+ is officially supported as primary development environment.

There are several dependencies, that should be installed manually. The following list is the absolute minimum for building:

  • gcc or any C99-compliant compiler (native or cross, e.g., arm-none-eabi)
  • cmake >= 2.8.12.2

Several scripts and tools help the building and development process, thus it is recommended to have the following installed as well:

  • bash >= 4.3.11
  • cppcheck >= 1.61
  • vera++ >= 1.2.1
  • python >= 2.7.6
sudo apt-get install gcc gcc-arm-none-eabi cmake cppcheck vera++ python

To make our scripts run correctly, several shell utilities should be available on the system:

  • awk
  • bc
  • find
  • sed

Building JerryScript

To build debug version for Linux

python tools/build.py --debug

To build debug version for Linux without LTO (Link Time Optimization)

python tools/build.py --debug --lto=off

Add custom arguments to CMake

python tools/build.py --cmake-param=CMAKE_PARAM

Set a profile mode (ES5.1, subset of ES2015, minimal)

python tools/build.py --profile=es5.1|es2015-subset|minimal

See also the related README.md.

Use (jerry, compiler-default, external) libc

The default libc is jerry-libc, but you can use compiler-default libc or an external libc:

  • compiler-default libc:
python tools/build.py --jerry-libc=off
  • external libc:
python tools/build.py --jerry-libc=off --compile-flag="-nostdlib -I/path/to/ext-libc/include" --link-lib="ext-c"

Add toolchain file

The cmake dir already contains some usable toolchain files, which you can use in the following format:

python tools/build.py --toolchain=TOOLCHAIN

For example the cross-compile to RaspberryPi 2 is something like this:

python tools/build.py --toolchain=cmake/toolchain_linux_armv7l.cmake

Use system memory allocator

python tools/build.py --system-allocator=on --jerry-libc=off

Note: System allocator is only supported on 32 bit systems.

Enable 32bit compressed pointers

python tools/build.py --cpointer-32bit=on

Note: There is no compression/decompression on 32 bit systems, if enabled.

Change default heap size (512K)

python tools/build.py --mem-heap=256

If you would like to use more than 512K, then you must enable the 32 bit compressed pointers.

python tools/build.py --cpointer-32bit=on --mem-heap=1024

Note: The heap size will be allocated statically at compile time, when JerryScript memory allocator is used.

To get a list of all the available buildoptions for Linux

python tools/build.py --help

Checking patch

python tools/run-tests.py --precommit

Running only one type of test

To run build option tests

python tools/run-tests.py --buildoption-test

To run unittests

python tools/run-tests.py --unittests

To run jerry-tests

python tools/run-tests.py --jerry-tests

To run jerry-test-suite

python tools/run-tests.py --jerry-test-suite

To run signed-off check

python tools/run-tests.py --check-signed-off

To run cppcheck

python tools/run-tests.py --check-cppcheck

To run vera check

python tools/run-tests.py --check-vera

To get a list of all the available test options

python tools/run-tests.py --help