mirror of
https://gitee.com/openharmony/arkcompiler_ets_runtime
synced 2024-10-08 00:24:00 +00:00
83 lines
3.6 KiB
Markdown
83 lines
3.6 KiB
Markdown
# 方舟JS运行时组件<a name="ZH-CN_TOPIC_0000001183610495"></a>
|
||
|
||
- [方舟JS运行时组件<a name="ZH-CN_TOPIC_0000001183610495"></a>](#方舟js运行时组件)
|
||
- [简介<a name="section190813718209"></a>](#简介)
|
||
- [目录<a name="section161941989596"></a>](#目录)
|
||
- [约束<a name="section119744591305"></a>](#约束)
|
||
- [编译构建<a name="section137768191623"></a>](#编译构建)
|
||
- [接口说明<a name="section175841548124517"></a>](#接口说明)
|
||
- [使用说明<a name="section129654513264"></a>](#使用说明)
|
||
- [相关仓<a name="section1371113476307"></a>](#相关仓)
|
||
|
||
### 简介<a name="section190813718209"></a>
|
||
|
||
方舟JS运行时（ARK JavaScript Runtime）是OpenHarmony上JS应用使用的运行时。包含JS对象的分配器以及垃圾回收器（GC）、符合ECMAScript规范的标准库、用于运行ARK前端组件生成的方舟字节码（ARK Bytecode，abc）的解释器、用于存储隐藏类的内联缓存、方舟JS运行时对外的函数接口（AFFI）等模块。
|
||
|
||
更多信息请参考：[方舟运行时子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/ARK-Runtime-Subsystem-zh.md)
|
||
|
||
**方舟JS运行时组件架构图：**
|
||
|
||
|
||
|
||
## 目录<a name="section161941989596"></a>
|
||
|
||
```
|
||
/ark/js_runtime
|
||
├─ ecmascript # 方舟JS运行时实现，包括ECMAScript标准库、解释器、内存管理等
|
||
│ ├─ base # 基础帮助类
|
||
│ ├─ builtins # ECMAScript标准库
|
||
│ ├─ class_linker # 字节码预处理模块
|
||
│ ├─ compiler # JS编译器
|
||
│ ├─ hprof # 内存分析工具
|
||
│ ├─ ic # 内联缓存模块
|
||
│ ├─ interpreter # JS解释器
|
||
│ ├─ jobs # 微任务队列
|
||
│ ├─ js_vm # 命令行工具
|
||
│ ├─ mem # 内存管理模块
|
||
│ ├─ napi # C++接口模块
|
||
│ ├─ regexp # 正则引擎模块
|
||
│ ├─ snapshot # 快照模块
|
||
│ ├─ tests # 单元测试用例
|
||
│ ├─ thread # 线程池
|
||
│ ├─ tooling # JS调试器
|
||
│ └─ vmstat # 运行时profiling工具
|
||
└─ test # 模块测试用例
|
||
```
|
||
|
||
## 约束<a name="section119744591305"></a>
|
||
|
||
* 仅支持运行方舟JS前端工具链\(ts2abc\)生成的方舟字节码文件
|
||
* 只支持ES2015标准和严格模式（use strict)
|
||
* 不支持通过字符串动态创建函数(比如new Function("console.log(1);"))
|
||
|
||
## 编译构建<a name="section137768191623"></a>
|
||
|
||
```
|
||
$ ./build.sh --product-name Hi3516DV300 --build-target ark_js_runtime
|
||
```
|
||
|
||
### 接口说明<a name="section175841548124517"></a>
|
||
|
||
NAPI接口说明参考[NAPI组件](https://gitee.com/openharmony/ace_napi/blob/master/README_zh.md)
|
||
|
||
### 使用说明<a name="section129654513264"></a>
|
||
|
||
JS生成字节码参考[工具链使用](docs/using-the-toolchain-zh.md)
|
||
|
||
字节码执行：
|
||
```
|
||
$ cd out/release
|
||
$ export LD_LIBRARY_PATH=clang_x64/ark/ark_js_runtime:clang_x64/ark/ark:clang_x64/global/i18n:../../prebuilts/clang/ohos/linux-x86_64/llvm/lib/
|
||
$ ./clang_x64/ark/ark_js_runtime/ark_js_vm helloworld.abc
|
||
```
|
||
|
||
更多使用说明请参考：[方舟运行时使用指南](https://gitee.com/openharmony/ark_js_runtime/blob/master/docs/ARK-Runtime-Usage-Guide-zh.md)
|
||
|
||
## 相关仓<a name="section1371113476307"></a>
|
||
|
||
[ark\_runtime\_core](https://gitee.com/openharmony/ark_runtime_core)
|
||
|
||
**[ark\_js\_runtime](https://gitee.com/openharmony/ark_js_runtime)**
|
||
|
||
[ark\_ts2abc](https://gitee.com/openharmony/ark_ts2abc)
|