ArkCompiler_ets_Runtime

• ArkCompiler_ets_Runtime
  • Introduction
  • Directory_Structure
  • Constraints
  • Building
    • Available_APIs
    • Usage
  • Repositories_Involved

Introduction

ArkCompiler ets Runtime is the default ets runtime on OpenHarmony. It supports ECMAScript libraries and efficient container libraries. It also provides a set of native APIs for C++ and a variety of garbage collectors that features high performance.

For more information, see ArkCompiler ets Runtime.

ArkCompiler ets Runtime architecture

Directory_Structure

/arkcompiler/ets_runtime
├─ ecmascript             # Implementation of ArkCompiler ets Runtime, including the ECMAScript library, interpreter, and memory management
│   ├─ base               # Base helper class
│   ├─ builtins           # ECMAScript libraries
│   ├─ checkpoint         # Virtual machine safepoint
│   ├─ compiler           # ets compiler
│   ├─ containers         # Non-ECMAScript containers
│   ├─ daemon             # Shared GC concurrent thread
│   ├─ debugger           # ets debugger
│   ├─ deoptimizer        # Compiler deoptimization
│   ├─ dfx                # Memory and profiling tool
│   ├─ extractortool      # Sourcemap parsing
│   ├─ ic                 # Inline cache module
│   ├─ interpreter        # ets interpreter
│   ├─ intl               # Internationalization
│   ├─ jit                # Jit compiler
│   ├─ jobs               # Queue of jobs
│   ├─ js_api             # Non-ecma standard object model
│   ├─ js_type_metadata   # Object layout file
│   ├─ js_vm              # Command line tool
│   ├─ jspandafile        # abc file management module
│   ├─ mem                # Memory management module
│   ├─ module             # ECMAScript module
│   ├─ napi               # C++ API module
│   ├─ ohos               # System-related logic
│   ├─ patch              # Cold patch, hot patch
│   ├─ pgo_profiler       # A performance analyzer based on profile-guided optimization (pgo), used for performance analysis and optimization
│   ├─ platform           # Cross-platform processing
│   ├─ quick_fix          # Quickly fix the command-line tool
│   ├─ regexp             # Regular expression engine module
│   ├─ require            # Commonjs module specification
│   ├─ sdk                # Integration of sdk tools
│   ├─ serializer         # Serialization
│   ├─ shared_mm          # Shared memory management module
│   ├─ shared_objects     # Implementation of shared objects
│   ├─ snapshot           # Snapshot module
│   ├─ stackmap           # Location information of active variables
│   ├─ stubs              # Runtime stub functions
│   ├─ taskpool           # Task pool
│   ├─ tests              # Unit test cases
│   ├─ ts_types           # TS type management module
└─ test                   # Module test cases    

Constraints

• Only the ArkCompiler bytecode files generated by ts2abc, which is the ArkCompiler ets 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 ets bytecodes, see Ark ets compiler.

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.

Repositories_Involved

arkcompiler_runtime_core

arkcompiler_ets_runtime

arkcompiler_ets_frontend