mirror of
https://github.com/openharmony/arkcompiler_ets_runtime.git
synced 2026-08-25 13:00:20 -04:00
openharmony_ci
1ca80f88ff
fix: preserve hybrid heap dump thread state and profiler lifetime Created-by: yangxiaoshuai2022 Commit-by: yangxiaoshuai2022 Merged-by: openharmony_ci Description: ### 关联的Issue https://gitcode.com/openharmony/arkcompiler_ets_runtime/issues/13574 ### 修改原因 修复混合堆转储中进程级线程状态管理不完整，以及 DynamicDump 恢复 runtime 与销毁自建 profiler 的时序竞态。 ### 修改描述 - 进程级动态 dump 在堆准备和实际转储期间，对全部 JSThread 成组管理 cross-thread execution 状态，并保留进入转储前已启用的状态。 - 按 raw dump、文件流、快照/字符串表、自建 profiler 的顺序释放资源，最后恢复 runtime；外部持有的 profiler 不由本次转储销毁。 - 增加进程级跨线程状态和 profiler 所有权/生命周期回归测试。 ### 范围说明 本 PR 不包含 ObjectID 跨 session 持久化，也不再包含异步任务保存目标 tid/统一批次时间，以及 JSON/Binary 路径接收调用方 DumpIdentity 的修改。相关接口和测试已恢复基线；runtime_core PR #14754 保持关闭。 ### 自测试项 - [x] rk3568 ARM HybridHeapSnapshotTest 完整目标编译、链接通过 - [x] x86_64 HybridHeapSnapshotTest 完整目标编译、链接通过 - [x] HybridHeapSnapshotTest 全量执行 55/55 PASS - [x] git diff --check 通过 - [x] 设备验证：通过 - [x] JIT/workload、解释器性能、IR、字节码格式均不涉及 See merge request: openharmony/arkcompiler_ets_runtime!15119
ArkCompiler_ets_Runtime
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.