文档管理中心
指南NDK开发代码开发使用Node-API实现ArkTS/JS与C/C++语言交互Node-API典型使用场景使用Node-API接口创建ArkTS运行时环境

使用Node-API接口创建ArkTS运行时环境

场景介绍

开发者通过pthread_create创建新线程后,可以通过napi_create_ark_runtime来创建一个新的ArkTS基础运行时环境,并通过该运行时环境加载ArkTS模块。当使用结束后,开发者需要通过napi_destroy_ark_runtime来销毁所创建的ArkTS基础运行时环境。

约束限制

一个进程最多只能创建64个运行时环境。

示例代码

  • 接口声明

    收起
    自动换行
    深色代码主题
    复制
    1. // index.d.ts
    2. export const createArkRuntime: () => object;
  • 编译配置

    收起
    自动换行
    深色代码主题
    复制
    1. # the minimum version of CMake.
    2. cmake_minimum_required(VERSION 3.5.0)
    3. project(MyApplication3)
    4. set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})
    5. if(DEFINED PACKAGE_FIND_FILE)
    6. include(${PACKAGE_FIND_FILE})
    7. endif()
    8. add_definitions( "-DLOG_TAG=\"LOG_TAG\"" )
    9. include_directories(${NATIVERENDER_ROOT_PATH}
    10. ${NATIVERENDER_ROOT_PATH}/include)
    11. add_library(entry SHARED napi_init.cpp)
    12. target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so)

    在当前模块的build-profile.json5文件中进行以下配置:

    收起
    自动换行
    深色代码主题
    复制
    1. "buildOption": {
    2. "arkOptions" : {
    3. "runtimeOnly" : {
    4. "sources": [
    5. "./src/main/ets/pages/ObjectUtils.ets"
    6. ]
    7. }
    8. },
  • 模块注册

    收起
    自动换行
    深色代码主题
    复制
    1. // create_ark_runtime.cpp
    2. EXTERN_C_START
    3. static napi_value Init(napi_env env, napi_value exports)
    4. {
    5. napi_property_descriptor desc[] = {
    6. { "createArkRuntime", nullptr, CreateArkRuntime, nullptr, nullptr, nullptr, napi_default, nullptr }
    7. };
    8. napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
    9. return exports;
    10. }
    11. EXTERN_C_END
    12. static napi_module nativeModule = {
    13. .nm_version = 1,
    14. .nm_flags = 0,
    15. .nm_filename = nullptr,
    16. .nm_register_func = Init,
    17. .nm_modname = "entry",
    18. .nm_priv = nullptr,
    19. .reserved = { 0 },
    20. };
    21. extern "C" __attribute__((constructor)) void RegisterQueueWorkModule()
    22. {
    23. napi_module_register(&nativeModule);
    24. }
  • 功能实现

    新建线程并创建ArkTS基础运行时环境,加载自定义模块请参考napi_load_module_with_info

    收起
    自动换行
    深色代码主题
    复制
    1. #include "napi/native_api.h"
    2. #include <pthread.h>
    3. // ...
    4. static void *CreateArkRuntimeFunc(void *arg)
    5. {
    6. // 1. 创建基础运行环境
    7. napi_env env = nullptr;
    8. napi_status ret = napi_create_ark_runtime(&env);
    9. if (ret != napi_ok) {
    10. return nullptr;
    11. }
    12. napi_handle_scope scope = nullptr;
    13. if (napi_open_handle_scope(env, &scope) != napi_ok) {
    14. napi_destroy_ark_runtime(&env);
    15. return nullptr;
    16. }
    17. // 2. 加载自定义模块
    18. napi_value objUtils = nullptr;
    19. ret = napi_load_module_with_info(env, "entry/src/main/ets/pages/ObjectUtils", "com.example.myapplication/entry",
    20. &objUtils);
    21. if (ret != napi_ok) {
    22. OH_LOG_INFO(LOG_APP, "Failed to load module");
    23. napi_close_handle_scope(env, scope);
    24. napi_destroy_ark_runtime(&env);
    25. return nullptr;
    26. }
    27. // 3. 使用ArkTS中的logger
    28. napi_value logger = nullptr;
    29. ret = napi_get_named_property(env, objUtils, "Logger", &logger);
    30. if (ret != napi_ok) {
    31. napi_close_handle_scope(env, scope);
    32. napi_destroy_ark_runtime(&env);
    33. return nullptr;
    34. }
    35. ret = napi_call_function(env, objUtils, logger, 0, nullptr, nullptr);
    36. if (ret != napi_ok) {
    37. napi_close_handle_scope(env, scope);
    38. napi_destroy_ark_runtime(&env);
    39. return nullptr;
    40. }
    41. napi_close_handle_scope(env, scope);
    42. // 4. 销毁ArkTS环境
    43. ret = napi_destroy_ark_runtime(&env);
    44. if (ret != napi_ok) {
    45. OH_LOG_INFO(LOG_APP, "Failed to destroy ark runtime");
    46. }
    47. return nullptr;
    48. }
    49. static napi_value CreateArkRuntime(napi_env env, napi_callback_info info)
    50. {
    51. pthread_t tid;
    52. pthread_create(&tid, nullptr, CreateArkRuntimeFunc, nullptr);
    53. pthread_join(tid, nullptr);
    54. return nullptr;
    55. }
  • ArkTS导入头文件

    收起
    自动换行
    深色代码主题
    复制
    1. import testNapi from 'libentry.so';
  • ArkTS代码示例

    收起
    自动换行
    深色代码主题
    复制
    1. export function Logger() {
    2. console.info('print log');
    3. }
    收起
    自动换行
    深色代码主题
    复制
    1. // index.ets
    2. testNapi.createArkRuntime();
在 指南 中进行搜索
请输入您想要搜索的关键词