HarmonyOS 鸿蒙Next中NAPI使用

HarmonyOS 鸿蒙Next中NAPI使用 1、在应用开发文档找到了cmake代码直接引用的示例，如果需要直接引用.so，需要怎么配置。我尝试新建了一个Empty Ability，创建libs目录，并在不同架构放置了.so，在页面中import **.so，报错Cannot read property Test of undefined。

包括在Native工程中，除了自己的代码还需要引用其它.so应该怎么配置

2、如何将目前的项目打包提供给其它应用使用，类似于.jar.aar的方式，还是目前只能以源文件的方式提供和引用

3 回复
  1. Native工程中自动生成entry/libs目录，可以将so文件放入文件夹中，在CMakeLists.txt文件中链接xx.so，然后import libentry.so文件
target_link_libraries(entry PUBLIC
${CMAKE_CURRENT_SOURCE_DIR}/…/…/…/libs/**.so)

CMAKE_CURRENT_SOURCE_DIR：CMakeLists.txt文件所处的文件夹

  1. 导入的so文件ets文件不能直接使用，需要类似Native项目中如下的方式进行关联注册：
static napi_value Init(napi_env env, napi_value exports)
{
napi_property_descriptor desc[] = {
{"add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr}
};
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}

更多关于HarmonyOS 鸿蒙Next中NAPI使用的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS鸿蒙Next中，NAPI（Native API）是用于在ArkTS/JS与C/C++之间进行交互的接口。NAPI允许开发者通过C/C++编写高性能的模块，并在ArkTS/JS中调用这些模块，以实现更高效的代码执行和更复杂的功能。

NAPI的使用主要包括以下几个步骤：

  1. 环境配置：首先需要配置开发环境，确保Node.js和CMake等工具已安装，并配置好相关路径。

  2. 创建NAPI模块：通过C/C++编写NAPI模块，定义需要暴露给ArkTS/JS的函数和对象。使用napi.h头文件中提供的API进行开发。

  3. 编译NAPI模块：使用CMake或Node-gyp等工具编译C/C++代码，生成动态链接库（如.node文件）。

  4. 在ArkTS/JS中调用NAPI模块：在ArkTS/JS代码中，通过require或import引入编译好的NAPI模块，并调用其中定义的函数。

NAPI的主要API包括：

  • napi_create_function：创建一个JavaScript函数。
  • napi_get_cb_info：获取函数调用的参数信息。
  • napi_create_object：创建一个JavaScript对象。
  • napi_set_named_property：为对象设置属性。

NAPI的使用场景包括但不限于：

  • 高性能计算：例如图像处理、加密解密等需要高计算性能的任务。
  • 系统级操作：例如文件系统操作、网络通信等需要直接调用系统API的任务。
  • 第三方库集成：例如将现有的C/C++库集成到ArkTS/JS应用中。

NAPI的使用需要注意内存管理和线程安全，避免内存泄露和竞态条件等问题。

在HarmonyOS的鸿蒙Next中，NAPI（Native API）是用于在JavaScript与C/C++原生代码之间实现交互的接口。通过NAPI，开发者可以在JavaScript中调用C/C++编写的原生模块，以提升性能或访问系统底层功能。使用NAPI时，首先需要在C/C++中实现相应的功能模块，并通过napi_define_properties等函数将模块暴露给JavaScript。然后，在JavaScript中通过require引入原生模块并调用其方法。NAPI的设计遵循跨平台原则，确保代码在不同设备上的一致性。

回到顶部