mirror of https://gitee.com/openharmony/arkcompiler_ets_runtime synced 2024-10-07 16:13:49 +00:00

Go to file

wengchangcheng 033440162f modify logger init in ark_js_vm issue: #I4SIRR [https://gitee.com/openharmony/ark_js_runtime/issues/I4SIRR] Signed-off-by: wengchangcheng <wengchangcheng@huawei.com>		2022-01-29 12:15:53 +08:00
docs	Path changes for the compiled product	2021-12-24 17:04:42 +08:00
ecmascript	modify logger init in ark_js_vm	2022-01-29 12:15:53 +08:00
test	fix testcase resource	2022-01-26 14:50:25 +08:00
.gitignore	modify debugger events and api test	2022-01-14 15:24:38 +08:00
BUILD.gn	!484 add debugger testcase and modify testcase resource	2022-01-26 14:04:53 +00:00
bundle.json	add bundle.json for componentize	2022-01-24 18:29:28 +08:00
js_runtime_config.gni	independent running ts aot	2022-01-26 15:22:50 +08:00
LICENSE	add ark js_runtime	2021-09-05 16:05:06 +08:00
OAT.xml	shield js_runtime binary files with master	2021-09-27 20:18:16 +08:00
README_zh.md	add container in readme	2022-01-24 15:32:38 +08:00
README.md	add container in readme	2022-01-24 15:32:38 +08:00
run_test262.sh	Description:sync from code from wgr_master to ohos	2021-12-21 09:36:03 +08:00

README.md

ARK JS Runtime Module

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
│   ├─ containers         # Non-ECMAScript container library
│   ├─ cpu_profiler       # CPU Performance Analyzer
│   ├─ 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