openharmony/arkcompiler_ets_runtime
1
0
Fork 0
mirror of https://gitee.com/openharmony/arkcompiler_ets_runtime synced 2024-10-07 16:13:49 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
316 Commits 181 Branches 40 Tags 198 MiB
C++ 82.1%
JavaScript 13.1%
TypeScript 3.2%
C 0.9%
Python 0.6%
0f0321fac3
Go to file
songzhengchao 0f0321fac3 code review 
Signed-off-by: songzhengchao <songzhengchao@huawei.com>
2021-10-30 11:11:19 +08:00
docs patch_2 2021-09-23 16:42:06 +08:00
ecmascript code review 2021-10-30 11:11:19 +08:00
test ark_js_vm support multi pandafile 2021-10-27 15:29:53 +08:00
.gitignore add ark js_runtime 2021-09-05 16:05:06 +08:00
BUILD.gn fixed for review comment by wuzhefeng 2021-10-27 16:22:43 +08:00
js_runtime_config.gni fixed for review comment by wuzhefeng 2021-10-27 16:22:43 +08:00
LICENSE add ark js_runtime 2021-09-05 16:05:06 +08:00
llvm.patch conflict 2021-10-10 10:43:27 +08:00
OAT.xml code review 2021-10-25 10:25:17 +08:00
ohos.build enable run ark unittest and use dynamic link 2021-09-28 10:30:21 +08:00
README_zh.md update README_zh.md. 2021-09-19 14:39:00 +00:00
README.md fix README 2021-09-19 22:05:41 +08:00
run_test262.sh modify compile warning 2021-09-27 17:12:25 +08:00

README.md

ARK JS Runtime Module

Introduction

ARK JS Runtime is the runtime used by JavaScript JS applications on OpenHarmony. It consists of the JS object allocator, garbage collector GC, a standard library compliant with ECMAScript specifications, ARK bytecode interpreter, inline caches that store hidden classes, and the ARK Foreign Function Interface AFFI.

For more infomation, see: ARK Runtime Subsystem.

ARK JS runtime architecture

Directory Structure

/ark/js_runtime
├─ ecmascript             # JS object definition
│   ├─ base               # Base helper class
│   ├─ builtins           # ECMAScript library
│   ├─ class_linker       # Bytecode pre-processing module
│   ├─ compiler           # JS compiler
│   ├─ hprof              # Memory analysis utility class
│   ├─ ic                 # Inline cache module
│   ├─ interpreter        # JS interpreter
│   ├─ jobs               # Queue of jobs
│   ├─ js_vm              # ARK command line tool
│   ├─ mem                # Memory management module
│   ├─ napi               # External native interface
│   ├─ regexp             # Regular expression engine module
│   ├─ snapshot/mem       # Snapshot module
│   ├─ tests              # Unit test cases
│   ├─ thread             # Thread pool
│   ├─ tooling            # JS debugger
│   └─ vmstat             # Runtime status utility classes
└─ test                   # Module test cases

Constraints

  • Only the bytecode file generated by the ARK JS frontend can be run.
  • Only support ES2015 standard and strict mode ("use strict").
  • Don't support dynamically create functions via string (e.g., new Function("console.log(1))).

Build

./build.sh --product-name Hi3516DV300 --build-target ark_js_runtime

Available APIs

For details, see NAPI.

Usage Guidelines

For details about how to generate JS bytecodes, see Using the Toolchain.

To run bytecodes:

$ 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

For more infomation, please see: ARK-Runtime-Usage-Guide.

Repositories Involved

ark_runtime_core

ark_js_runtime

ark_ts2abc