鸿蒙开发实践案例分析——使用Node-API接口创建ArkTs运行时环境

📝往期推文全新看点（文中附带最新·鸿蒙全栈学习笔记）

1️⃣ 鸿蒙应用开发与鸿蒙系统开发哪个更有前景？

2️⃣ 嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~

3️⃣ 对于大前端开发来说，转鸿蒙开发究竟是福还是祸？

4️⃣ 鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？

5️⃣ 记录一场鸿蒙开发岗位面试经历~

6️⃣ 持续更新中……

---

场景介绍

开发者通过pthread_create创建新线程后，可以通过napi_create_ark_runtime来创建一个新的ArkTs基础运行时环境，并通过该运行时环境加载ArkTs模块，目前仅支持在ArkTs模块中使用console接口打印日志，使用timer定时器功能。当使用结束后，开发者需要通过napi_destroy_ark_runtime来销毁所创建的ArkTs基础运行时环境。

使用示例

1. 接口声明、编译配置以及模块注册

接口声明

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

编译配置

// CMakeLists.txt
# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(MyApplication)

set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})

include_directories(${NATIVERENDER_ROOT_PATH}
                    ${NATIVERENDER_ROOT_PATH}/include)
add_library(entry SHARED create_ark_runtime.cpp)
target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so)

模块注册

// 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);
}

2. 新建线程并创建基ArkTs础运行时环境

// create_ark_runtime.cpp
#include <pthread.h>

#include "napi/native_api.h"

static void *CreateArkRuntimeFunc(void *arg)
{
    // 1. 创建基础运行环境
    napi_env env;
    napi_status ret = napi_create_ark_runtime(&env);
    if (ret != napi_ok) {
        return nullptr;
    }

    // 2. 加载自定义模块
    napi_value objUtils;
    ret = napi_load_module_with_info(env, "ets/pages/ObjectUtils", "com.exmaple.myapplication/entry", &objUtils);
    if (ret != napi_ok) {
        return nullptr;
    }

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

    // 4. 销毁arkts环境
    ret = napi_destroy_ark_runtime(&env);

    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;
}

3. ArkTS侧示例代码

// ObjectUtils.ets
export function Logger() {
    console.log("print log");
}