鸿蒙中定制SO库以及使用

今天学了下如何在鸿蒙中使用 .so 文件，.so 文件的生成，以及使用方法。特此总结下，希望填坑

生成 .so

第一步：创建一个 Native 工程

创建工程

1.DevEco Studio -> File -> New -> Create Project -> Native C++

2.填写必要的信息，然后 点击 Finish， 等待创建完成

3.查看项目目录结构

项目目录结构

上图是项目目录结构，可以发现，跟新建一个 鸿蒙 项目几乎没有差异，特殊差异点在于，多了一个 cpp 目录，这个目录就是存放相关C++代码的目录

• Index.d.ts: 是一个声明文件，用来声明导出的 C++ 函数，在 JS 中可以直接使用这些函数。（其实等价于 Index.ets 导出类）
• oh-package.json5: 这是一个配置文件，用来配置so名称、版本等信息
• CMakeLists.txt、napi_init.cpp: C++代码以及 CMakeLists.txt 文件，用来编译生成 .so 文件，.cpp 文件内用于编写你的逻辑代码

比如我的案例中，写了一个 getGatewayKey5 方法，用于返回一个固定的 字符串 key_55555555555555

额外配置项目

考虑到不同的系统架构支持兼容性，需要手动设置下 abiFilters

在你的 module 下的 [build-profile.json5] 文件中，添加如下配置：

主要是添加 abiFilters 配置，其他的都是新建项目的时候会默认添加好的

  "buildOption": {
    "externalNativeOptions": {
      "path": "./src/main/cpp/CMakeLists.txt",
      "abiFilters": ["arm64-v8a", "x86_64"],
      "arguments": "",
      "cppFlags": "",
    }
  }

到这为止，一个完整的 C++ 项目算是配置完毕了，接下来就是构建 .so 文件了，继续往下看

第二步：编写 C++ 代码

如上所说，在 .cpp 文件中编写你所需要的 C++ 逻辑就行了，我不会太会写，就简单写了一个获取字符串的方法，其他的就不详细写了。。哈哈哈，等后边学习下C++再说吧。。。

第三步：编译成 .so

如何最终编译成 .so 呢？ 直接 菜单栏 -> Build -> Build Module xxx 即可

执行完毕后，在 build -> intermediates -> libs -> default 目录下，就会生成 .so 文件了(会根据 abiFilters 配置来生成不同的 .so 文件)

如图所示：

到这，我们已经生成了一个 .so 文件了

具体的源代码，在 code 目录下 的 NativeKey.zip 中，详细地址：https://gitee.com/yanftch/harmony_os/tree/master/code

使用 .so 方案一（直接在module中使用）

此处是直接在 module 中使用，也就是在一个 项目中，新建了一个 module，然后引用 .so 文件，然后调用其中的方法

具体步骤如下：

1. 新建一个 项目 NativeKeyDemo，然后创建了了一个 module lib_keyso，lib_keyso 是个 har 包
2. 在 lib_keyso中，新建一个 libs目录，将前边生成的不同架构的 .so 复制进入，如下图1
3. 新建如下目录：src/main/cpp/types 目录下新建目录并将index.d.ts、oh-package.json5移动到该目录下, 如下图2、图3
4. 在模块级oh-package.json5中（也就是 lib_keyso 中）声明这个so库根目录路径，如下图4
5. 在代码中使用import引用oh-package.json5中声明的依赖名称并调用，如下图5
6. 使用，同样如下图5中，代码如下：console.log(${this.TAG}: lib_keyso 组件内部代码：${getGatewayKey5})
7. 运行结果，如下图6所示，成功打印出来了我在 .cpp 中定义的 getGatewayKey5 方法返回的固定字符串

(图1)

(图2)

(图3)

(图4)

(图5)

(图6)

上述使用的源码，在此：https://gitee.com/yanftch/harmony_os/blob/master/code/NativeKeyDemo.zip

---

至此，结束~

参考链接：https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs-V5/faqs-ndk-21-V5

使用 .so 方案二

此方案，是考虑将 .so 文件，打包到一个 HAR中，后续其他的 HAR或者HAP 直接依赖 此 HAR即可，后续再调研吧，或者有了解的大佬贴一下链接吧~~