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

## 场景介绍

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

## 约束限制

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

### 示例代码

* 接口声明

  ```TypeScript
  // index.d.ts
  export const createArkRuntime: () => object;
  ```

* 编译配置

  ```txt
  # the minimum version of CMake.
  cmake_minimum_required(VERSION 3.5.0)
  project(MyApplication3)

  set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})
  if(DEFINED PACKAGE_FIND_FILE)
      include(${PACKAGE_FIND_FILE})
  endif()
  add_definitions( "-DLOG_TAG=\"LOG_TAG\"" )
  include_directories(${NATIVERENDER_ROOT_PATH}
                      ${NATIVERENDER_ROOT_PATH}/include)

  add_library(entry SHARED napi_init.cpp)
  target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so)
  ```

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

  ```JSON5
    "buildOption": {
      "arkOptions" : {
        "runtimeOnly" : {
          "sources": [
            "./src/main/ets/pages/ObjectUtils.ets"
          ]
        }
      },
  // ...
    },
  ```

* 模块注册

  ```cpp
  // create_ark_runtime.cpp
  EXTERN_C_START
  static napi_value Init(napi_env env, napi_value exports)
  {
      napi_property_descriptor desc[] = {
          { "createArkRuntime", nullptr, CreateArkRuntime, nullptr, nullptr, nullptr, napi_default, nullptr }
      };
      napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
      return exports;
  }
  EXTERN_C_END

  static napi_module nativeModule = {
      .nm_version = 1,
      .nm_flags = 0,
      .nm_filename = nullptr,
      .nm_register_func = Init,
      .nm_modname = "entry",
      .nm_priv = nullptr,
      .reserved = { 0 },
  };

  extern "C" __attribute__((constructor)) void RegisterQueueWorkModule()
  {
      napi_module_register(&nativeModule);
  }
  ```

* 功能实现

  新建线程并创建ArkTS基础运行时环境，加载自定义模块请参考[napi_load_module_with_info](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/use-napi-load-module-with-info)。

      #include "napi/native_api.h"
      #include <pthread.h>
      // ...
      static void *CreateArkRuntimeFunc(void *arg)
      {
          // 1. 创建基础运行环境
          napi_env env = nullptr;
          napi_status ret = napi_create_ark_runtime(&env);
          if (ret != napi_ok) {
              return nullptr;
          }

          napi_handle_scope scope = nullptr;
          if (napi_open_handle_scope(env, &scope) != napi_ok) {
              napi_destroy_ark_runtime(&env);
              return nullptr;
          }

          // 2. 加载自定义模块
          napi_value objUtils = nullptr;
          ret = napi_load_module_with_info(env, "entry/src/main/ets/pages/ObjectUtils", "com.example.myapplication/entry",
                                           &objUtils);
          if (ret != napi_ok) {
              OH_LOG_INFO(LOG_APP, "Failed to load module");
              napi_close_handle_scope(env, scope);
              napi_destroy_ark_runtime(&env);
              return nullptr;
          }

          // 3. 使用ArkTS中的logger
          napi_value logger = nullptr;
          ret = napi_get_named_property(env, objUtils, "Logger", &logger);
          if (ret != napi_ok) {
              napi_close_handle_scope(env, scope);
              napi_destroy_ark_runtime(&env);
              return nullptr;
          }
          ret = napi_call_function(env, objUtils, logger, 0, nullptr, nullptr);
          if (ret != napi_ok) {
              napi_close_handle_scope(env, scope);
              napi_destroy_ark_runtime(&env);
              return nullptr;
          }

          napi_close_handle_scope(env, scope);

          // 4. 销毁ArkTS环境
          ret = napi_destroy_ark_runtime(&env);
          if (ret != napi_ok) {
              OH_LOG_INFO(LOG_APP, "Failed to destroy ark runtime");
          }

          return nullptr;
      }

      static napi_value CreateArkRuntime(napi_env env, napi_callback_info info)
      {
          pthread_t tid;
          pthread_create(&tid, nullptr, CreateArkRuntimeFunc, nullptr);
          pthread_join(tid, nullptr);
          return nullptr;
      }

* ArkTS导入头文件

  ```TypeScript
  import testNapi from 'libentry.so';
  ```

* ArkTS代码示例

  ```TypeScript
  export function Logger() {
    console.info('print log');
  }
  ```

  ```TypeScript
  // index.ets
  testNapi.createArkRuntime();
  ```