鸿蒙OH实战开发：三方库移植之NAPI开发[1]—Hello OpenHarmony NAPI

本文链接：https://blog.csdn.net/liuhaojiabin/article/details/144299704

📚往期学习笔录📝：

📝 鸿蒙（HarmonyOS）北向开发知识点记录~
📝 鸿蒙（OpenHarmony）南向开发保姆级知识点汇总~
📝 鸿蒙应用开发与鸿蒙系统开发哪个更有前景？
📝 嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~
📝 对于大前端开发来说，转鸿蒙开发究竟是福还是祸？
📝 鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？
📝 记录一场鸿蒙开发岗位面试经历~
📝 持续更新中……

通过本文您将熟悉：

如何注册NAPI模块及接口。
如何在ArkUI eTS代码中调用扩展的NAPI接口。
full-SDK的替换。

什么是NAPI

NAPI（Native API）组件是一套对外接口基于Node.js N-API规范开发的原生模块扩展开发框架。
OpenHarmony中组件有一种是C和C++语言的三方组件，通常以源码或OpenHarmony hpm包的方式引入，在应用开发中以NAPI的方式使用，或直接编译在OpenHarmony操作系统镜像

NAPI组件架构图

OpenHarmony 标准系统应用开发基于ArkUI框架，开发语言使用JS/eTS。部分业务场景依赖使用现有的C/C++ 库，或为了获取更高的性能。OpenHarmony提供NAPI机制，用于规范封装IO、CPU密集型、OS底层等能力并对外暴露JS接口，通过NAPI实现JS和C/C++代码的互相访问.
- 重点讲解了NAPI接口如何实现OpenCV以及SeetaFace的调用。一句话概括就是，钟禄平和林嘉诚老师讲述了移植了三方库后通过NAPI将库的C/C++接口变成JS/ETS接口给应用层调用。
OpenHarmony 中的 N-API 定义了由 JS/ETS 语言编写的代码和 native 代码（使用 C/C++ 编写）交互的方式，由 Node.js N-API 框架扩展而来。

N-API：Native Application Programming Interface（本地应用程序接接口）

什么是Node.js N-API 框架
Node.js N-API为开发者提供了一套C/C++ API用于开发Node.js的Native扩展模块。从Node.js 8.0.0开始，N-API以实验性特性作为Node.js本身的一部分被引入，并且从Node.js 10.0.0开始正式全面支持N-API。

添加OpenHarmony自定义子系统、组件、模块

这部分内容涉及三方库移植，为便于本篇NAPI基础的学习。笔者在此自定义一个子系统用于开发NAPI。如在已存在的子系统组件中添加扩展NAPI，则跳过此步。
需要准备好OpenHarmonyBeta3源码和编译环境

添加子系统、组件

直接在OpenHarmony源码根目录创建子系统文件夹，取名mysubsys。并在目录下添加子系统的构建配置文件ohos.build
完整内容如下：

{
  "subsystem": "mysubsys",
  "parts": {
    "hello": {
      "module_list": [
        "//mysubsys/hello/hellonapi:hellonapi"
      ],
      "inner_kits": [
      ],
      "system_kits": [
      ],
      "test_list": [
      ]
    }
  }
}

另外ohos.build里面不支持加注释，后面编译的时候会莫名其妙报错。别问，问就是笔者踩过坑了。（好像也没必要加注释）

需要明白以下知识点：

  "subsystem": "mysubsys",

subsystem后面的mysubsy是子系统的名称。

  "parts": {
    "hello": {
   }
  }

hello是组件名称，被mysubsys子系统包含

"module_list": [
        "//mysubsys/hello/hellonapi:hellonapi"

hellonapi是模块名，被hello组件包含。

接着将子系统配置到源码下build\subsystem_config.json文件，在该文件中插入如下内容。

  "mysubsys": {
    "project": "hmf/mysubsys",
    "path": "mysubsys",
    "name": "mysubsys",
    "dir": ""
  }

OpenHarmony系统架构中，子系统是一个逻辑概念，它具体由对应的组件构成。组件是对子系统的进一步拆分，可复用的软件单元，它包含源码、配置文件、资源文件和编译脚本；能独立构建，以二进制方式集成，具备独立验证能力的二进制单元。

本示例按子系统system > 组件part > 组件module 创建了3级目录

mysubsys                    -- 子系统目录
├── hello                   -- 组件目录
│   └── hellonapi