鸿蒙5.0开发进阶：NDK代码开发-Node-API典型使用场景（使用Node-API接口创建ArkTS运行时环境）

最新推荐文章于 2025-04-01 14:16:09 发布

懂你的大海

最新推荐文章于 2025-04-01 14:16:09 发布

阅读量292

点赞数 3

分类专栏： NDK 鸿蒙开发 ArkUI 文章标签： harmonyos 华为 android 鸿蒙系统前端 ArkUI ArkTS

本文链接：https://blog.youkuaiyun.com/Androidbye/article/details/146910769

版权

鸿蒙开发同时被 3 个专栏收录

762 篇文章

订阅专栏

ArkUI

670 篇文章

订阅专栏

NDK

95 篇文章

订阅专栏

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

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

场景介绍

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

约束限制

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

使用示例

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

接口声明

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

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

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

模块注册

// 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。

// 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, "entry/src/main/ets/pages/ObjectUtils", "com.example.myapplication/entry", &objUtils);
    if (ret != napi_ok) {
        return nullptr;
    }

    // 3. 使用ArkTS中的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;
}

编写ArkTS侧示例代码。

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

// ArkTS侧调用接口
import testNapi from 'libentry.so';

testNapi.createArkRuntime();