JerryScript 教程：入门与配置

1. 项目目录结构及介绍

JerryScript 的源代码组织如下：

.
├── CMakeLists.txt      # 主 CMake 构建脚本
├── docs                 # 文档相关材料
├── include              # 公共头文件
│   └── jerry-core        # 核心库头文件
│   └── jerry-ext         # 扩展功能头文件
├── jerry-core           # JavaScript 引擎核心实现
├── jerry-port           # 端口层实现，用于平台适配
└── scripts               # 脚本工具，如构建和测试辅助脚本

• CMakeLists.txt: 项目主要的构建配置文件。
• docs: 包含项目文档，例如 API 参考和教程。
• include: 头文件存放处，为 JerryScript 提供接口定义。
  • jerry-core: 存放引擎的核心组件头文件。
  • jerry-ext: 提供扩展功能的头文件，非必需但可增强功能。
• jerry-core: 实现 JavaScript 引擎的核心组件。
• jerry-port: 平台相关代码，用于移植到不同硬件或操作系统。
• scripts: 各种辅助脚本，如编译和测试。

2. 项目的启动文件介绍

JerryScript 没有一个标准的 main.c 文件，因为它的设计是为了嵌入到其他应用中。通常，你需要自己创建一个主程序来初始化 JerryScript 引擎并执行 JavaScript 代码。以下是一个简单的示例：

#include <stdio.h>
#include "jerry-api.h"

int main(void)
{
    const char *script = "print('Hello, World!');";

    // 初始化 JerryScript
    jerry_init(JERRY_INIT_EMPTY);

    // 运行 JavaScript 代码
    jerry_value_t result = jerry_eval ((const jerry_char_t *) script,
                                       strlen (script),
                                       JERRY_EVAL_FLAG_NONE);
    
    // 处理结果（如果有的话）
    if (jerry_value_is_error(result))
    {
        printf("Evaluation error\n");
    }
    else
    {
        // 如果没有错误，清理并打印结果
        jerry_release_value(jerry_get_string_length(result));
    }

    // 清理 JerryScript
    jerry_cleanup();

    return 0;
}

请注意，这个例子是简化的，实际使用时可能需要更多的配置选项和错误处理。

3. 项目的配置文件介绍

JerryScript 使用 CMake 编译系统进行构建，因此配置主要通过在 CMakeLists.txt 文件中设置变量进行。你可以通过修改这些变量以适应你的平台和需求。以下是一些关键的 CMake 变量：

• JERRY_ENABLE_DEBUGGER: 是否启用调试器支持，默认关闭。
• JERRY_CMDLINE_ENABLE_ALL: 是否启用所有命令行选项，默认关闭。
• JERRY_GLOBAL_HEAP_SIZE: 设置全局堆的大小，单位为字节。
• JERRY_BUILD_MODE: 构建模式，可以是 release 或 debug。

要使用这些变量，可以在运行 cmake 命令时指定：

$ cmake -DJERRY_ENABLE_DEBUGGER=ON -DJERRY_GLOBAL_HEAP_SIZE=102400 ..

这将打开调试器支持并将全局堆大小设置为 100KB。具体配置请参考项目文档和 CMakeLists.txt 中的说明。