写在结尾:
OpenHarmony 中的 N-API组件定义了由ArkTS (JS/ETS)语言编写的代码和 native 代码(应用 C/C++ 编写)交互的形式,由 Node.js Node-API 框架扩大而来。
什么是Node.js Node-API 框架
Node.js Node-API为开发者提供了一套C/C++ API用于开发Node.js的Native扩大模块。从Node.js 8.0.0开始,Node-API以实验性个性作为Node.js自身的一部分被引入,并且从Node.js 10.0.0开始正式全面反对Node-API。- 本文以OpenHarmony 3.2beta3源码中的node.js三方库为例,从third_party/node/README.OpenSource中可得悉3.2beta3移植的node版本为14.19.1,因而可参考的Node.js N-API链接为14.19.1版本,如下:https://nodejs.org/docs/lates...
- 接口名方面,OpenHarmony 中的 N-API 组件提供的接口名与三方库Node.js统一,目前反对局部接口,详情见libnapi.ndk.json文件。
本篇是该系列文章的第5篇上半局部。有离北况归的中央就肯定会有样例源码,本文提供了一个IDE开发的NAPI工程用来学习本篇知识点,下半局部将对源码进行解析。通过本文您将相熟:
- NAPI 导出类对象
- NAPI 对象生命周期治理
往期回顾:
[三方库移植之NAPI开发[1]—Hello OpenHarmony NAPI](https://ost.51cto.com/posts/1...)
[三方库移植之NAPI开发[2]C/C++与JS的数据类型转换](https://ost.51cto.com/posts/1...)
[三方库移植之NAPI开发[3]通过IDE开发NAPI工程](https://ost.51cto.com/posts/1...)
[三方库移植之NAPI开发[4]异步调用:Callback&Promise](https://ost.51cto.com/posts/1...)
@toc
1.NAPI 类对象导出
- OpenHarmony NAPI提供了一种“包装”C ++类和实例的办法,以便JS利用能够调用类的构造函数和办法。
- Node.js Node-API中对于导出
类对象
的内容,参考链接 : https://nodejs.org/docs/lates...
1.1. NAPI导出类对象流程
通过
napi_define_class
定义一个JS类- 它蕴含了与 C++ 类对应的构造函数、动态属性、办法、实例属性和办法。
通过
napi_wrap
将 C++ 实例绑定在 JS对象中- 当 JS代码调用构造函数时,构造函数回调会应用napi_wrap将一个新的 C++ 实例绑定在 JS对象中,而后返回绑定的C++ 实例。
通过
napi_unwrap
获取作为调用指标的C++ 实例- 当 JS调用C++ 类 的办法或属性时,会调用相应的napi_callback C++ 函数。对于实例回调,
napi_unwrap
获取作为调用指标的 C++ 实例 。
- 当 JS调用C++ 类 的办法或属性时,会调用相应的napi_callback C++ 函数。对于实例回调,
这里的napi_callback C++ 函数是指被 Node.js Node-API调用的C++ 函数
2. NAPI 对象生命周期
- 程序的生命周期是指程序从启动,运行到完结的整个过程。
NAPI 对象的生命周期代表着从对象创立到开释的整个过程,如下图所示:
- 在ArkTS利用启动时会加载NAPI模块,而在NAPI模块加载过程中会创立一个对象A提供给利用应用,在利用退出或者被动开释A对象前,A对象必须始终放弃"沉闷"状态。从A对象创立到开释的整个过程也代表着A对象的生命周期。
以下是Node-API 中对于对象生命周期的解释:
- 当调用Node-API时,底层虚拟机在堆中对象的句柄可能以napi_values的模式返回。这些句柄必须放弃对象“流动”,直到本地代码不再须要它们。参考链接:https://nodejs.org/docs/lates...
句柄是一个标识符,是用来标识对象的。
NAPI 环境生命周期API的内容参考链接如下:https://nodejs.org/docs/lates...
3. 对于本文提供的样例工程
- 本文提供了一个IDE开发的NAPI工程用来学习NAPI
类对象导出
和对象生命周期治理
。 笔者运行环境:
- 触觉智能 IDO-EVB3568-V1 开发板
- OpenHarmony 3.2Beta2
- DevEco Studio 3.1.0.100
3.1 触觉智能 IDO-EVB3568-V1 开发板
- 触觉智能的这个rk3568开发板是笔者去年8月份网上冲浪购买的,4GB+32GB开发板 + 一块10.1英寸的MIPI屏幕 + 电源适配器 + usb调试器(搞开源鸿蒙用不上) 一共 739米 。笔者认为是性价比无敌的开源鸿蒙规范零碎开发板。
- 触觉智能始终在给 IDO-EVB3568-V1 开发板适配最新的OpenHarmony版本。例如2月1号公布Beta5,作为消费者的笔者立马收到了适配了IDO-EVB3568-V1的Beta5镜像包,有MIPI版本的和HDMI版本。购买后的体验是十分不错的。购买链接如下:https://item.taobao.com/item....
3.2. 样例工程运行
- 1、样例装置运行后,触觉智能 IDO-EVB3568-V1开发板显示如下
以下图片通过OpenHarmony预置的屏幕截图性能获取。截图文件放在上面这四个文件夹下
/data/service/el2/100/hmdfs/account/files/Pictures/Screenshots/
/storage/media/100/local/files/Pictures/Screenshots/
/mnt/hmdfs/100/account/device_view/local/files/Pictures/Screenshots/
/mnt/hmdfs/100/account/merge_view/files/Pictures/Screenshots/
而后通过hdc工具导出到PC端。
2、再点击两头的"导出对象"后,PC端DevEco Studio工具的Log窗口查看到对应的调试信息。
- 零碎的调试信息也在Hilog窗口显示,且信息量大,不不便查看本人的调试信息,能够在log窗口设置过滤信息,让窗口只显示咱们过滤关键字
NapiTest
的信息。
- 零碎的调试信息也在Hilog窗口显示,且信息量大,不不便查看本人的调试信息,能够在log窗口设置过滤信息,让窗口只显示咱们过滤关键字
调试信息如下:
08-05 11:09:03.413 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI 2 + 3 = 508-05 11:09:03.414 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(2, 3) 108-05 11:09:03.414 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(2, 3) 208-05 11:09:03.415 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(2, 3) 308-05 11:09:03.415 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest]Test NAPI 2+3 = 508-05 11:09:52.123 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI 2 + 3 = 508-05 11:09:52.123 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(0, 0) 108-05 11:09:52.123 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(0, 0) 208-05 11:09:52.124 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(0, 0) 308-05 11:09:52.124 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest]Test NAPI 4+5 = 0
- 3、再在index.ets中勾销上面这四行代码的正文。
Hilog窗口打印调试信息如下:
08-05 09:03:38.156 1911-1911/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI 2 + 3 = 508-05 09:03:38.157 1911-1911/com.example.objectwraptest I A0fefe/JsApp: [NapiTest]Test NAPI error{}08-05 09:03:38.157 1911-1911/com.example.objectwraptest I A0fefe/JsApp: [NapiTest]Test NAPI hello NapiTest = undefined
- 以上HiLog窗口打印信息中的com.example.objectwraptest是样例工程的包名,在样例利用工程AppScope\app.json5文件中定义。AppScope\app.json5中还能够定义样例利用hap的其余属性。
entry\src\main\module.json5中startWindowBackground字段能够查看利用开启时过渡动画的色彩,然而在指向的同级目录下具体的文件中设置
- 在样例利用工程entry\src\main\resources\base\element\string.json中能够查看 利用名称
- 样例图标批改entry\src\main\resources\base\media\icon.png,大小是114*114像素
知识点附送
OpenHarmony截屏命令:
# 进入sdk\版本号\toolchain输出cmd关上命令行hdc_std shellsnapshot_display# 截图默认保留在/data/目录下exithdc_std file recv OpenHarmony设施端截图文件门路 PC端门路