arkcompiler_ets_runtime/README_zh.md

方舟编译器JS运行时组件

• 方舟JS运行时组件
  • 简介
  • 目录
  • 约束
  • 编译构建
    • 接口说明
    • 使用说明
  • 相关仓

简介

方舟编译器JS运行时（ArkCompiler JavaScript Runtime）是OpenHarmony上默认的JavaScript语言运行时。支持Ecmascript规范定义的标准库和高效container容器库，提供完备的C++交互JSNAPI和各种高性能的垃圾回收器，驱动着万物互联时代的OpenHarmony应用程序。

更多信息请参考：方舟运行时子系统

方舟JS运行时组件架构图：

目录

/ark/js_runtime
├─ ecmascript             # 方舟JS运行时实现，包括ECMAScript标准库、解释器、内存管理等
│   ├─ base               # 基础帮助类
│   ├─ builtins           # ECMAScript标准库
│   ├─ compiler           # JS编译器
│   ├─ containers         # 非ECMAScript标准容器类库
│   ├─ dfx                # 内存与性能分析工具
│   ├─ ic                 # 内联缓存模块
│   ├─ interpreter        # JS解释器
│   ├─ jobs               # 微任务队列
│   ├─ js_vm              # 命令行工具
│   ├─ jspandafile        # abc文件管理模块
│   ├─ mem                # 内存管理模块
│   ├─ module             # ECMAScript module模块
│   ├─ napi               # C++接口模块
│   ├─ taskpool           # 任务池
│   ├─ regexp             # 正则引擎模块
│   ├─ snapshot           # 快照模块
│   ├─ stubs              # runtime桩函数
│   ├─ tests              # 单元测试用例
│   ├─ tooling            # JS调试器
│   ├─ trampoline         # 跳转桥函数
│   ├─ ts_type            # TS类型管理模块
└─ test                   # 模块测试用例     

约束

• 仅支持运行方舟JS前端工具链(ts2abc)生成的方舟字节码文件
• 只支持ES2015标准和严格模式（use strict)
• 不支持通过字符串动态创建函数(比如new Function("console.log(1);"))

编译构建

$ ./build.sh --product-name Hi3516DV300 --build-target ark_js_host_linux_tools_packages

接口说明

NAPI接口说明参考NAPI组件

使用说明

JS生成字节码参考工具链使用

字节码执行：

$ export LD_LIBRARY_PATH=out/hi3516dv300/clang_x64/ark/ark:out/hi3516dv300/clang_x64/ark/ark_js_runtime:out/hi3516dv300/clang_x64/global/i18n_standard:prebuilts/clang/ohos/linux-x86_64/llvm/lib
$ ./out/hi3516dv300/clang_x64/ark/ark_js_runtime/ark_js_vm helloworld.abc

更多使用说明请参考：方舟运行时使用指南

相关仓

ark_runtime_core

ark_js_runtime

ark_ts2abc