Files
jerryscript/docs/01.GETTING-STARTED.md
T
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

72 lines
1.4 KiB
Markdown

### 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`
```bash
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:
```bash
python tools/build.py --debug
```
To build debug version for Linux without LTO (Link Time Optimization):
```bash
python tools/build.py --debug --lto=off
```
Add custom arguments to CMake:
```bash
python tools/build.py --cmake-param CMAKE_PARAM
```
Add toolchain file:
The cmake dir already contains some usable toolchain files.
```bash
python tools/build.py --toolchain TOOLCHAIN
```
Use (jerry|compiler-default|external libc) libc:
```bash
python tools/build.py --libc LIBC
```
The possible arguments are `jerry` , `compiler` , `<path of external lib>`
To get more available buildoptions for Linux:
```bash
python tools/build.py --help
```
### Checking Patch
```bash
python tools/run-tests.py --precommit
```