mirror of
https://gitee.com/openharmony/arkcompiler_ets_runtime
synced 2024-11-30 13:40:51 +00:00
c711131d28
Signed-off-by: linxin <linxinyq@foxmail.com> Change-Id: I33b0d9b5d07703335b203dbc87a3d86ce30b54cd |
||
|---|---|---|
| .gitee | ||
| compiler_service | ||
| docs | ||
| ecmascript | ||
| etc | ||
| script | ||
| test | ||
| tools/circuit_viewer | ||
| .gitignore | ||
| BUILD.gn | ||
| bundle.json | ||
| hisysevent.yaml | ||
| js_runtime_config.gni | ||
| libark_jsruntime.map | ||
| LICENSE | ||
| OAT.xml | ||
| README_zh.md | ||
| README.md | ||
ArkCompiler JS Runtime
Introduction
ArkCompiler JS Runtime is the default JS runtime on OpenHarmony. It supports ECMAScript libraries and efficient container libraries. It also provides a set of native APIs for C++ and JS interaction and a variety of garbage collectors that features high performance.
For more information, see ArkCompiler JS Runtime.
ArkCompiler JS Runtime architecture
Directory Structure
/arkcompiler/ets_runtime
├─ ecmascript # Implementation of ArkCompiler JS Runtime, including the ECMAScript library, interpreter, and memory management
│ ├─ base # Base helper class
│ ├─ builtins # ECMAScript libraries
│ ├─ compiler # JS compiler
│ ├─ containers # Non-ECMAScript containers
│ ├─ dfx # Memory and profiling tool
│ ├─ ic # Inline cache module
│ ├─ interpreter # JS interpreter
│ ├─ jobs # Queue of jobs
│ ├─ js_vm # Command line tool
│ ├─ jspandafile # abc file management module
│ ├─ mem # Memory management module
│ ├─ module # ECMAScript module
│ ├─ napi # C++ API module
│ ├─ taskpool # Task pool
│ ├─ regexp # Regular expression engine module
│ ├─ snapshot # Snapshot module
│ ├─ stubs # Runtime stub functions
│ ├─ tests # Unit test cases
│ ├─ debugger # JS debugger
│ ├─ trampoline # Trampoline function
│ ├─ ts_type # TS type management module
└─ test # Module test cases
Constraints
- Only the ArkCompiler bytecode files generated by ts2abc, which is the ArkCompiler JS frontend toolchain, can be run.
- Only the ES2021 standard and strict modes are supported.
- Functions cannot be dynamically created using strings, such as new Function("console.log(1);")).
Building
$./build.sh --product-name hispark_taurus_standard --build-target ark_js_host_linux_tools_packages
Available APIs
See NAPI.
Usage
For details about how to generate JS bytecodes, see Using the Toolchain.
To run bytecodes:
LD_LIBRARY_PATH=out/hispark_taurus/clang_x64/arkcompiler/ets_runtime:out/hispark_taurus/clang_x64/thirdparty/icu:prebuilts/clang/ohos/linux-x86_64/llvm/lib ./out/hispark_taurus/clang_x64/arkcompiler/ets_runtime/ark_js_vm helloworld.abc
For more information, see [ARK Runtime Usage Guide](https://gitee.com/openharmony/arkcompiler_ets_runtime/blob/master/ docs/ARK-Runtime-Usage-Guide.md).