JerryScript项目入门指南：从环境搭建到编译测试

JerryScript项目入门指南：从环境搭建到编译测试

jerryscript 项目地址: https://gitcode.com/gh_mirrors/jer/jerryscript

前言

JerryScript是一个轻量级的JavaScript引擎，专为资源受限的设备设计，如微控制器和嵌入式系统。本文将详细介绍如何搭建JerryScript的开发环境，以及各种编译和测试方法。

环境准备

系统要求

目前官方主要支持Ubuntu 18.04及以上版本作为开发环境。虽然其他Linux发行版可能也能运行，但建议使用官方推荐的系统以避免兼容性问题。

基础依赖安装

构建JerryScript需要以下基本组件：

1. 编译器：支持C99标准的编译器，如gcc或arm-none-eabi（用于交叉编译）
2. 构建工具：CMake 2.8.12.2或更高版本

推荐安装的开发辅助工具：

• Bash 4.3.11或更高版本
• Cppcheck 1.61或更高版本（用于静态代码分析）
• Clang-format 10.0.0或更高版本（用于代码格式化）
• Python 2.7.6或更高版本

安装命令：

sudo apt-get install gcc gcc-arm-none-eabi cmake cppcheck clang-format-10 python

必要的Shell工具

确保系统中已安装以下基础工具：

• awk
• bc
• find
• sed

编译JerryScript

基本编译命令

调试版本编译：

python tools/build.py --debug

禁用LTO优化：

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

调试选项

开启详细日志输出有助于调试：

python tools/build.py --debug --logging=on --error-messages=on --line-info=on

高级编译选项

1. 自定义CMake参数：

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

2. 选择编译模式： 支持"es.next"和"minimal"两种模式：

python tools/build.py --profile=es.next|minimal

3. 内存管理配置：

• 使用系统内存分配器（仅支持32位系统）：

python tools/build.py --system-allocator=on

• 修改默认堆大小（默认为512KB）：

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

• 大内存配置（需启用32位压缩指针）：

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

4. 交叉编译： 使用预置的工具链文件进行交叉编译，如Raspberry Pi 2：

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

5. 模糊测试支持：

CC=clang python tools/build.py --libfuzzer=on --compile-flag=-fsanitize=address --lto=off

查看所有编译选项

python tools/build.py --help

测试与验证

预提交检查

运行全面的预提交检查：

python tools/run-tests.py --precommit

选择性测试

1. 构建选项测试：

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

2. 单元测试：

python tools/run-tests.py --unittests

3. Jerry专用测试：

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

4. 代码规范检查：

• 签名检查：

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

• 静态代码分析：

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

• 代码格式检查：

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

查看所有测试选项

python tools/run-tests.py --help

结语

本文详细介绍了JerryScript项目的环境搭建、编译配置和测试方法。通过灵活的编译选项，开发者可以根据目标平台的特点进行定制化构建。对于嵌入式开发而言，合理配置内存分配和指针压缩等选项尤为重要。建议初次接触JerryScript的开发者从基础编译开始，逐步尝试各种高级选项，以充分了解引擎的特性和潜力。

jerryscript 项目地址: https://gitcode.com/gh_mirrors/jer/jerryscript