OpenHarmony ArkUI实战开发-初识 NAPI

在移动应用开发中需要使用 C/C++ 实现的场景有很多，比如音视频处理，图像处理等较高性能要求的场景。OpenHarmony 提供了 NAPI 框架用于实现 JS 和 C/C++ 互相调用的能力，DevEco Studio 默认支持创建 NAPI 应用，本节笔者简单介绍一下创建的默认 NAPI 工程的相关知识。

NAPI工程创建

DevEco Studio 默认支持创建 NAPI 工程，在 DevEco Studio 的菜单栏里依次点击 File -> New -> Create Project，如下图所示：

在弹出选择工程模版对话框里，选择 OpenHarmony 标签下的 Navite C++ 模板，然后点击 Next 按钮，如下图所示：

点击 Next 按钮后，在工程配置页面填写工程名字，Project type 填写 Application，Compile SDK 选择 9，Mode 选择 Stage，其它按照默认选择即可，截图如下所示：

填写完成后，点击 Finish，一个 NAPI 工程已经创建完毕，NAPI 工程结构如下图所示：

NAPI工程简介

NAPI 工程创建完后，在 entry 目录下多了一个 cpp 目录，该目录用来存放 cpp 的源码及相关配置文件，各文件说明如下：

• hello.cpp：index.d.ts 文件中声明的方法的 C++ 实现源码。
• CMakeLists.txt：是cmake用来生成Makefile文件需要的一个描述编译链接的脚本文件。
• index.d.ts：对 ts 提供的方法声明。
• package.json：打包的配置文件。

另外 CMakeLists.txt 文件还会在 build-profile.json5 里做配置，代码如下所示：

{
  "apiType": 'stageMode',
  "buildOption": {
    "externalNativeOptions": {                 // CPP相关配置
      "path": "./src/main/cpp/CMakeLists.txt", // CMake 文件的路径
      "arguments": "",                         // 传递给 CMake 的可选参数
      "cppFlags": "",                          // 传递给 C++编译器的可选参数
    }
  }
}

externalNativeOptions 是对 CPP 的相关配置，path 表示 CMake 文件的配置路径，arguments 表示传递给 CMake 的可选编译参数，cppFlags 表示传递给 C++ 编译器的可选参数。

NAPI工程签名

NAPI 项目目前只能在真机上验证，在真机上运行前需要添加签名，否则无法安装运行，依次点击DevEco Studio 的 File -> Project Structure，如下图所示：

在打开的 Project Structure 面板中，选择 Signing Configs 标签，在该标签下选中 Automatically generate signature 复选框，如下所示：

点击 OK 按钮，则会自动添加签名配置，此时可以链接设备运行项目了。

NAPI工程运行

更改默认生成的 Index.ets ，代码如下所示：

import testNapi from 'libentry.so'

@Entry @Component struct ArkUIClubNAPITest {

  @State message: string = 'Hello，OpenHarmony'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            var result = testNapi.add(2, 3);
            this.message = "OpenHarmony, value: " + result;
            console.log(this.message);
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

点击 Text，调用 testNapi 的 add() 方法并把结果 赋值给 message，此时 message 的值经过 add() 方法计算后为：OpenHarmony, value: 5，在设置上运行该项目

小结

本节简单介绍了 DevEco Stuido 创建的默认 NAPI 工程，读者有个大致印象即可，后续笔者将继续介绍NAPI 的相关内容，敬请期待。

为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05

《鸿蒙开发学习手册》：

如何快速入门：https://qr21.cn/FV7h05

1. 基本概念
2. 构建第一个ArkTS应用
3. ……

开发基础知识：https://qr21.cn/FV7h05

1. 应用基础知识
2. 配置文件
3. 应用数据管理
4. 应用安全管理
5. 应用隐私保护
6. 三方应用调用管控机制
7. 资源分类与访问
8. 学习ArkTS语言
9. ……

基于ArkTS 开发：https://qr21.cn/FV7h05

1. Ability开发
2. UI开发
3. 公共事件与通知
4. 窗口管理
5. 媒体
6. 安全
7. 网络与链接
8. 电话服务
9. 数据管理
10. 后台任务(Background Task)管理
11. 设备管理
12. 设备使用信息统计
13. DFX
14. 国际化开发
15. 折叠屏系列
16. ……

鸿蒙开发面试真题（含参考答案）：https://qr18.cn/F781PH

鸿蒙开发面试大盘集篇（共计319页）：https://qr18.cn/F781PH

1.项目开发必备面试题
2.性能优化方向
3.架构方向
4.鸿蒙开发系统底层方向
5.鸿蒙音视频开发方向
6.鸿蒙车载开发方向
7.鸿蒙南向开发方向