内容摘要：想了解更多内容，请访问：和华为官方合作共建的鸿蒙技术社区https://harmonyos.51cto.com1、简介开源鸿蒙(OpenHarmony)的APP开发框架是ACE，开发语言是JS/eTS

想了解更多内容，码解请访问：

和华为官方合作共建的码解鸿蒙技术社区

https://harmonyos.51cto.com

1、简介

开源鸿蒙(OpenHarmony)的码解APP开发框架是ACE，开发语言是码解JS/eTS。有时候需要增加一些额外功能，码解依赖现有的码解C/C++ 开源库，或者遇到一些CPU密集计算的码解场合，就需要使用C/C++ 语言来编写更底层的码解函数，供上层JS调用。码解

OpenHarmony提供了统一的码解NAPI接口函数，通过编译系统的码解裁剪，方便增加新的码解JS功能模块。

本文以最简单的码解NAPI接口函数为例，详细说明在OpenHarmony系统如何编写模块文件、码解本地调试、码解系统集成、上机测试。

1.1 UI架构相关系列

《OpenHarmony 源码解析之ACE (JavaScript运行环境初始化)》 《OpenHarmony 源码解析之JavaScript API框架(NAPI)》 《OpenHarmony 源码解析之JavaScript API框架(NAPI-C接口)》 《OpenHarmony 源码解析之JavaScript API框架(NAPI实践)》 《OpenHarmony 源码解析之JavaScript(文件管理API)》

1.2 OpenHarmony架构图

1.3 JS UI架构

JS UI框架包括应用层(Application)、前端框架层(Framework)、引擎层(Engine)和平台适配层(Porting Layer)，其架构如下图所示：

2、快速实现

建立模块目录，编写基础编译文件

模块目录理论上可以建立在OpenHarmony代码库的服务器租用任何地方，为行文方便，假设OpenHarmony代码库的目录为OHOS_SRC，在OHOS_SRC目录下，建立此次测试模块目录：myapp。

此时，OHOS_SRC目录下应该有 ark, foundation, device, …, myapp 等目录，其中myapp就是刚刚建立的，在myapp目录下，建立以下文件：

|-- BUILD.gn |-- app.cpp |-- ohos.build 

BUILD.gn：

import("//build/ohos.gni")    ohos_shared_library("myapp") {       # 指定编译源文件      sources = [        "app.cpp",      ]      # 指定编译依赖，如果依赖第三方库，需要在此添加      deps = [ "//foundation/ace/napi:ace_napi" ]      # 指定库生成的路径      relative_install_dir = "module"      # 子系统及其组件，后面会引用      subsystem_name = "myapp"      part_name = "myapp_part"    }    

 最终会生成system/lib/module/libmyapp.z.so，并且在APP中：import myapp from @ohos.myapp

这几处的myapp都是统一名称：

“module_list”: [ “//myapp:myapp” ] 

//myapp指的是myapp目录，:myapp指的是上面BUILD.gn中的目标ohos_shared_library("myapp")

ohos.build：

{    "subsystem": "myapp",   "parts": {      "myapp_part": {        "module_list": [         "//myapp:myapp"       ],       "test_list": [ ]     }   } } 

app.cpp：

#include <assert.h> #include "napi/native_api.h" #include "napi/native_node_api.h" static napi_value Method(napi_env env, napi_callback_info info) {    napi_status status;   napi_value world;   status = napi_create_string_utf8(env, "Hello, world!", 13, &world);   assert(status == napi_ok);   return world; } static napi_value Init(napi_env env, napi_value exports) {    napi_status status;     napi_property_descriptor desc[] = {          DECLARE_NAPI_FUNCTION("hello", Method),     };   status = napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);   assert(status == napi_ok);   return exports; } NAPI_MODULE(myapp, Init) 

这里只简单写了一个JS模块，只有一个hello函数，返回"Hello, world!"字符串。

3、本地测试

利用 node-gyp进行本地测试，先确保系统安装了node.js。

node --version 

在myapp目录下，建立test目录，源码库然后编写binding.gyp和test.js文件：

|-- BUILD.gn |-- app.cpp |-- ohos.build `-- test     |-- binding.gyp     `-- test.js 

binding.gyp：

按自己系统的实际情况，填写编译器、源代码(sources)、头文件目录(include_dirs)、依赖库(dependencies)、编译参数(cflags、cflags_cc)、链接参数(link_settings: libraries)。

这里的目标名称(target_name)就是下一步test.js引用测试的名称。

{    targets: [     {        cc: clang,       c++: clang++,       target_name: test-native,       sources: [ ../app.cpp],       include_dirs: ["/OHOS_SRC/foundation/ace/napi/interfaces/kits"],       dependencies: [],       cflags!: [ -DTESTDEBUG, -std=gnu2x ],       cflags_cc: [ -DTESTDEBUG, -std=c++17 ],       link_settings: {            libraries: []       },     }   ] } 

接下来，确保系统安装了node-gyp

node-gyp --version 

如果系统没有安装，那么在测试目录下临时安装也是可以的。

cd OHOS_SRC/myapp/test npm install node-gyp ./node_modules/.bin/node-gyp --version 

运行如下命令，确保app.cpp文件无语法错误，可以正确通过编译链接。

cd OHOS_SRC/myapp/test node-gyp configure node-gyp build 

 之后如果修改了binding.gyp文件，需要node-gyp rebuild，

test.js：

var myapp = require(./build/Release/test-native) console.log(myapp) console.log(myapp.hello) console.log(myapp.hello()) 

 如果编译正常，那么就可以进行本地测试了：

node test.js 

4、集成

集成到系统，在本地测试通过后，各种功能看起来正常，那么就可以集成到OpenHarmony系统，烧录上机测试了。

集成到OpenHarmony的步骤参考鸿蒙子系统的集成步骤：标准系统编译构建指导

这里简单描述一下：

在OHOS_SRC/build/subsystem_config.json文件中，高防服务器增加(注意前后逗号，保持文件格式正确)：

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

 在产品配置中添加上述子系统的功能模块，编译到产品产出文件中(注意前后逗号，保持文件格式正确)

OHOS_SRC/productdefine/common/products/产品名称.json  “myapp:myapp_part”:{ } 

即可开始编译。

./build.sh --product-name 产品名称 

编译完成后，可以在OHOS_SRC/out目录找到生成的.so文件。

root@1fe862aba551:/home/openharmony# find out -name libmyapp* out/ohos-arm-release/packages/phone/NOTICE_FILES/system/lib/module/libmyapp.z.so.txt out/ohos-arm-release/packages/phone/system/lib/module/libmyapp.z.so out/ohos-arm-release/lib.unstripped/myapp/myapp_part/libmyapp.z.so out/ohos-arm-release/myapp/myapp_part/libmyapp.z.so 

 镜像输出在 out/ohos-arm-release/packages/phone/images/ 目录下。

5、上机测试及小技巧

第一次编写完成后，需要烧录镜像文件。之后再修改，就可以利用hdc工具，只上传.so文件覆盖原文件即可。

hdc.exe file send libmyapp.z.so system/lib/module/libmyapp.z.so 

编写测试HAP：

import myapp from @ohos.myapp export default {    testGetAppName() {      console.log(myapp.hello())   } } 

假设测试APP的包是com.example.testmyapp，可以使用hdc工具很方便进行的安装、启动、关闭APP等操作。

安装：

hdc install -r 安装包的本地路径.hap 

卸载：

hdc uninstall com.example.testmyapp 

列出已经安装的包：

hdc shell bm dump -a 

启动：

hdc shell aa start -b com.example.testmyapp -a com.example.testmyapp.MainAbility 

关闭：

hdc shell killall com.example.testmyapp 

hdc工具查看日志，可以根据进程号只看测试进程的，这样就更清晰方便了。：

hdc.exe shell ps -elf |grep com.example.testmyapp # 输出的第二列是pid hilog -P pid #这里的pid是上面第二列的数字 

6、小结

OpenHarmony系统的ACE框架已经具备了基础的APP功能，可以很方便的利用NAPI扩展来增强APP，补充JS的不足之处。

想了解更多内容，请访问：

和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com