# ark_js_runtime

**Repository Path**: sivalee/ark_js_runtime

## Basic Information

- **Project Name**: ark_js_runtime
- **Description**: 方舟JS运行时（ARK JavaScript Runtime）是OpenHarmony上JS应用使用的运行时。包含JS对象的分配器以及垃圾回收器（GC）、符合ECMAScript规范的标准库、用于运行ARK前端组件生成的方舟字节码（ARK Bytecode，abc）的解释器、用于存储隐藏类的内联缓存、方舟JS运行时对外的函数接口（AFFI）等模块。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1032
- **Created**: 2022-03-16
- **Last Updated**: 2022-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 方舟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运行时组件架构图：**

![](docs/figures/zh-cn_image_0000001196712959.png)

## 目录<a name="section161941989596"></a>

```
/ark/js_runtime
├─ ecmascript             # 方舟JS运行时实现，包括ECMAScript标准库、解释器、内存管理等
│   ├─ base               # 基础帮助类
│   ├─ builtins           # ECMAScript标准库
│   ├─ class_linker       # 字节码预处理模块
│   ├─ compiler           # JS编译器
│   ├─ containers         # 非ECMAScript标准容器类库
│   ├─ cpu_profiler       # CPU性能分析器
│   ├─ 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)