jerryscript/docs/01.GETTING-STARTED.md
Robert Sipka ddab1d8152 Re-thinking the build system to bring it more into line with the conventions.
We removed that implementation where the build directory isn't set up to build with exactly one
configuration of the project but potentially several variants: the same build directory
can/must be used for debug and release builds, for full or compact profile versions, etc.
So we reworked the CMakeLists, and now one build dir deal with exactly one configuration
of the project's libraries and tools.

JerryScript-DCO-1.0-Signed-off-by: Zsolt Borbély zsborbely.u-szeged@partner.samsung.com
JerryScript-DCO-1.0-Signed-off-by: Robert Sipka rsipka.uszeged@partner.samsung.com
2016-07-28 12:29:55 +02:00

1.4 KiB

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 required for building:

  • gcc or any C99-compliant compiler
    • native
    • arm-none-eabi
  • cmake >= 2.8.12.2
  • bash >= 4.3.11
  • cppcheck >= 1.61
  • vera++ >= 1.2.1
  • python >= 2.7.6
sudo apt-get install gcc g++ gcc-arm-none-eabi cmake cppcheck vera++ python

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

  • find
  • awk
  • wget

Building Debug Version

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

Add toolchain file:

The cmake dir already contains some usable toolchain files.

python tools/build.py --toolchain TOOLCHAIN

Use (jerry|compiler-default|external libc) libc:

python tools/build.py --libc LIBC

The possible arguments are jerry , compiler , <path of external lib>

To get more available buildoptions for Linux:

python tools/build.py --help

Checking Patch

python tools/run-tests.py --precommit