PrimJS安装与配置指南

PrimJS安装与配置指南

1. 项目基础介绍

PrimJS 是一个为 Lynx 跨平台框架量身打造的轻量级、高性能 JavaScript 引擎。它完全支持 ES2019 标准，基于 QuickJS 构建，提供更佳的性能和开发体验。PrimJS 引擎的特点包括优化的解释器、无缝的对象模型集成、先进的内存管理以及全面的调试支持。

2. 主要编程语言

该项目主要使用以下编程语言：

• C++
• 汇编
• JavaScript
• C
• Python
• CMake

3. 关键技术和框架

• 模板解释器：利用栈缓存和寄存器优化，显著提升性能。
• 对象模型集成：与 Lynx 对象模型高效集成，减少数据通信开销，提高渲染性能。
• 内存管理：使用垃圾收集器（GC）替代 QuickJS 的引用计数，提供更好的性能、内存可分析性和降低内存泄漏风险。
• 调试支持：完全实现 Chrome 开发者工具协议（CDP），实现与 Chrome 调试器的无缝集成。

4. 安装和配置准备工作

在开始安装之前，请确保您的系统中已安装以下工具和依赖项：

• Git：用于克隆项目仓库。
• gn：构建系统工具。
• ninja：构建系统工具。
• Python 3：运行安装脚本和单元测试。

5. 安装步骤

克隆仓库

首先，使用 Git 克隆项目仓库到本地：

git clone git@github.com:lynx-family/primjs.git

安装依赖

进入项目目录并安装依赖：

cd primjs
source tools/envsetup.sh
hab sync .

构建项目

PrimJS 使用 gn 和 ninja 进行构建。以下步骤用于生成 qjs 二进制文件：

gn gen out/Default
ninja -C out/Default qjs_exe

若要启用模板解释器和垃圾收集器，请在构建时使用以下 gn 参数（以下示例为 arm64 平台配置）：

gn gen out/Default --args='
target_cpu="arm64"
enable_primjs_snapshot = true
enable_compatible_mm = true
enable_tracing_gc = true
'

然后，构建 qjs 二进制文件：

ninja -C out/Default -j32 qjs_exe

运行 PrimJS

主二进制文件 qjs 位于 out/Default/qjs。使用它来运行 JavaScript 文件：

./out/Default/qjs test.js

运行测试

从项目根目录运行以下步骤来构建并执行单元测试：

• 构建单元测试：

python3 tools/ci/check_test_build.py

• 运行单元测试：

python3 tools/ci/check_test_run.py

以上步骤为 PrimJS 的基础安装与配置指南，按照这些步骤，您应该能够成功地在您的环境中安装和运行 PrimJS。