jerryscript/02.how-to.md

layout	title	permalink
page	How To	/how-to/

How to Get the Sources

This step should be simple:

git clone https://github.com/Samsung/jerryscript.git
cd jerryscript

How to Setup Recommended Prerequisites

Currently, we are using Ubuntu Linux 14.04+ as our development environment, so this tutorial was written based on this assumption. Additionaly, it'd be useful to read [Prerequisites]({{ site.baseurl }}/wiki/Prerequisites) wiki page, also.

There are dependencies, that should be installed manually. The following list is required for building:

• gcc or g++ higher than 4.8.2
  • native
  • arm-none-eabi
• cmake higher than 2.8.12.2
• make higher than 3.81
• bash higher than 4.3.11

These tools are required for development:

• cppcheck requires libpcre
• vera++ requires tcl, tk and boost

sudo apt-get install gcc g++
sudo apt-get install gcc-arm-none-eabi g++-arm-none-eabi
sudo apt-get install cmake
sudo apt-get install libpcre3 libpcre3-dev
sudo apt-get install tcl8.6 tcl8.6-dev tk8.6-dev libboost-all-dev

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

• find
• bc
• awk
• sed
• sha256sum
• wget

How to Build

After setting up prerequisites, let's built the engine:

make

Upon first build, make would try to setup prerequisites, required for further development and pre-commit testing:

• stm32f3 and stm32f4 libraries
• nuttx's headers
• cppcheck 1.66
• vera++ 1.2.1

It may take time, so go grab some coffee:

Setting up prerequisites... (log file: ./build/prerequisites/prerequisites.log)

How to Build Debug Version

To build debug version for Linux:

make debug.linux

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

LTO=off make debug.linux

How to Run Unittests

make unittests

How to Check the Patch

make precommit -j

Sometimes pre-commit testing fails, in that case you'll see message like that:

Build failed. See ./build/bin/unittests/make.log for details.