NAPI 类对象导出及其生命周期管理(上)

已于 2024-04-12 21:40:52 修改
阅读量700 收藏 25
点赞数 24
分类专栏： HarmonyOS OpenHarmony 移动开发 文章标签： java 开发语言 harmonyos 鸿蒙开发 移动开发 openharmony 华为
于 2024-04-12 21:31:19 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/maniuT/article/details/137695688
版权
移动开发 同时被 3 个专栏收录
956 篇文章 8 订阅
订阅专栏
HarmonyOS
871 篇文章 13 订阅
订阅专栏
OpenHarmony
695 篇文章 17 订阅
订阅专栏

1.NAPI 类对象导出

  • OpenHarmony NAPI提供了一种“包装”C ++类和实例的方法，以便JS应用可以调用类的构造函数和方法。
  • Node.js Node-API中关于导出类对象的内容，

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++ 实例 。

这里的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的形式返回。这些句柄必须保持对象“活动”，直到本地代码不再需要它们。

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版本。购买后的体验是非常不错的。

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的信息。

调试信息如下：

08-05 11:09:03.413 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI 2 + 3 = 5
08-05 11:09:03.414 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(2, 3) 1
08-05 11:09:03.414 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(2, 3) 2
08-05 11:09:03.415 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(2, 3) 3
08-05 11:09:03.415 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest]Test NAPI 2+3 = 5
08-05 11:09:52.123 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI 2 + 3 = 5
08-05 11:09:52.123 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(0, 0) 1
08-05 11:09:52.123 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(0, 0) 2
08-05 11:09:52.124 1802-1802/com.example.objectwraptest I A0fefe/JsApp: [NapiTest] Test NAPI add(0, 0) 3
08-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 = 5
08-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 shell
snapshot_display
# 截图默认保存在/data/目录下
exit
hdc_std file recv OpenHarmony设备端截图文件路径 PC端路径

为了能让大家更好的学习鸿蒙（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.鸿蒙南向开发方向

OpenHarmony_小贾
关注
  • 24
    点赞
  • 踩
  • 25
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
鸿蒙应用开发之OpenGL应用和X组件4
大坡3D软件开发
05-21 150
接着就是做主要的事情，映射库的导出方法getContext，这是在ArkTS里看到的方法，在C++里实际上是函数PluginManager::GetContext，这个函数也是一个静态的全局函数，可以任何地方调用，并且这个函数里的访问变量也是全局的。这行代码干的活比较多，首先要拿到X组件在C++里的指针，然后绑定这个X组件和ID关系，并且注册X组件的回调函数，这样才能根据X组件的生命周期来处理界面，最后还需要导出X组件交互函数，以便用户在X组件点击时触发C++层的代码运行。接着查找GLES库。
鸿蒙应用开发之OpenGL应用和X组件5
大坡3D软件开发
05-22 167
这段代码就通过NAPI的函数napi_get_named_property获取X组件的通用指针，它定义名称为OH_NATIVE_XCOMPONENT_OBJ，这是X组件在C++端的名称。这段代码就是使用获得的X组件的指针，然后通过函数OH_NativeXComponent_GetXComponentId来获取X组件的ID，这个ID保存在idStr数组里，给后面使用。因此，我们需要注册C++层的回调函数OnSurfaceCreated，这样当X组件创建成功之后调用我们在C++里的代码。
JS调用C++模块中的函数
Hens_Hello_Mr的博客
10-28 2167
此API允许从C++侧调用 JavaScript 函数对象，例如本文的napi_call_function(env, global, cb, 0 , nullptr, &result);值得注意的是，本文JS侧传递给C++的回调函数是匿名函数，C++侧先将JS回调函数先在C++侧注册，即使用napi_create_reference将JS函数创建为ref，ref最终会作为napi_call_function的第三个参数，可以放心并没有在global对象里面直接去取函数引用。例如Add方法的代码，
NAPI注册JS模块
11-07 423
4.3 BindNativeFunction 绑定一个类的接口，也就是公开给JS。4.2 napi_set_named_property 声明一个枚举类型给JS。4.1 napi_wrap用来创建一个js的类，注册给V8。对应d.ts的接口，C++侧需要注册相应的模块与之对应。1.需要 napi_module_register。2. moudule 参数。
OpenHarmony 入门——初识JS/ArkTS 侧的“JNI” NAPI 常见的函数详解（二）
最新发布
最美不过，心中有梦，身旁有你！
07-24 1158
重点介绍下NAPI中重要的函数。
harmony 鸿蒙安全和高效的使用N-API开发Native模块
maniuT的博客
02-21 1377
N-API 是 Node.js Addon Programming Interface 的缩写，是 Node.js 提供的一组 C++ API，封装了V8 引擎的能力，用于编写 Node.js 的 Native 扩展模块。通过 N-API，开发者可以使用 C++ 编写高性能的 Node.js 模块，同时保持与 Node.js 的兼容性。
Openharmony应用NAPI详解--基础篇
热门推荐
流风的专栏
01-20 1万+
NAPI应用 Openharmony
OpenHarmony NAPI 类对象导出及其生命周期管理(下)
weixin_58069108的博客
03-13 1301
OpenHarmony NAPI 类对象导出及其生命周期管理
Openharmony应用NAPI详解--进阶篇1
流风的专栏
01-20 1万+
NAPI面向C++的异步接口 callback napi_create_async_work napi_queue_async_work
Node.js C++插件实践指南
daydream13580130043的博客
01-21 2420
简介 熟悉Node.js的人都知道，Node.js是基于C++开发的一个JavaScript运行时，既然Node.js是用C++开发的，那么我能否将C++代码引入到Node.js中呢，这当然是可以的，这项技术被称为C++模块。官方对Node.js C++模块解释如下 Node.JS插件是使用C++编写的动态链接库，可以被Node.JS以require的形式载入，在使用时就像Node.js原生模块...
Linux 内核游记 (2)
qtxzh的博客
04-25 2332
文章目录网络设备驱动e100参考资料 网络设备驱动 上一篇分析的loopback是所谓的"伪设备"，即它不对应真实世界中的硬件，而只是一种软件抽象。今天我们来看一个真实硬件设备的驱动程序，它就是Intel 8255x 10/100 Mbps网卡，对应的内核文件是drivers/net/ethernet/intel/e100.c。 e100 8255x是一系列网卡的统称，包括82557, 82558...
【鸿蒙OS开发入门】11 - 启动流程代码分析之第一个用户态进程：init 进程 之 Services简介
|~~~热爱生活、努力学习的小伙汁~~~|
12-23 1821
【鸿蒙OS开发入门】11 - 启动流程代码分析之第一个用户态进程：init 进程 之 Services详解
NAPI 类对象导出及其生命周期管理(下)
maniuT的博客
04-12 1053
Napi.h文件内容如下：public:// 创建NapiTest类的实体，并将实体返回到应用端，该方法为js创建一个类实体，因此需要将该接口对外导出// 初始化js类并设置对应属性并将其导出private:// 设置数据，此方法给到js直接调用，因此需要将该接口对外导出// 获取数据，此方法给到js直接调用，因此需要将该接口对外导出// 定义js结构体时实际的构建函数// 释放资源的函数(类似类的析构函数)// 生命周期变量// 设置和获取数据的变量。
napi系列学习进阶篇——NAPI异步调用
maniuT的博客
04-13 2323
OpenHarmony Napi 标准系统异步接口实现支持Callback方式和Promise方式。标准系统异步接口实现规范要求，若引擎开启Promise特性支持，则异步方法必须同时支持Callback方式和Promise方式。使用哪种方式由应用开发者决定，通过是否传递Callback函数进行区分。不传递Callback即为Promise方式，方法执行结果为Promise实例对象。
数据包接收系列 — NAPI的原理和实现
weixin_30646315的博客
03-27 956
本文主要内容：简单分析NAPI的原理和实现。 内核版本：2.6.37 Author：zhangskd @ csdn 概述 NAPI是linux新的网卡数据处理API，据说是由于找不到更好的名字，所以就叫NAPI(New API)，在2.5之后引入。 简单来说，NAPI是综合中断方式与轮询方式的技术。 中断的好处是响应及时，如果数据量较小，则不会占用太多的CPU事件；...
Linux NAPI机制分析
zheng的博客
06-25 5097
1、概述 在NAPI之前，网卡每收到一个包就会触发一个中断通知cpu读取数据包，当数据包比较多时，中断数过多势必影响cpu性能，因此Linux引入NAPI机制，NAPI就是在收到中断后，先将网卡收包模式切换成poll模式，等收包完成后重新进入中断模式，本节主要分析Linux的NAPI实现机制。 NAPI的主要流程如下图，物理网卡收到包后触发irq中断通知cpu（触发中断后，默认disable该中断），中断上半部处理里将网卡设备的napi->poll_list加入到softnet_data->
numpy的unwrap函数
李树花开，风中摇曳
12-15 1万+
最近处理相位角的时候用到了这个函数,所以在这里稍稍用一点篇幅来记录一下我的理解.unwrap函数究竟是用来是用来干什么的呢?它是用来解卷绕的.至于什么是卷绕,网上的说法是: 要计算一个系统相频特性，就要用到反正切函数，计算机中反正切函数规定，在一、二象限中的角度为0～pi，三四象限的角度为0～-pi。 若一个角度从0变到2pi，但实际得到的结果是0～pi，再由-pi～0，在w=pi处发生跳
napi机制
weixin_43300893的博客
09-02 829
napi简要记录netif_napi_add软中断NIC硬件中断napi_threaded_poll任务函数软中断处理函数 netif_napi_add 创建了一个内核任务，调用napi_kthread_create函数创建了一个 napi任务，任务函数为：napi_threaded_poll 软中断 在 net/core/dev.c 文件中，有一个函数 net_dev_init()，里面为每一个CPU初始化了skb的队列，还是我们的软中断： NET_TX_SOFTIRQ和NET_RX_SOFTIRQ,对
使用NAPI调用TS对象中的方法
06-09
首先，需要在C++代码中引入napi.h头文件。然后，可以通过以下步骤调用TS对象中的方法： 1. 获取TS对象 ```c++ napi_value tsObj; napi_get_named_property(env, exports, "TS", &tsObj); ``` 2. 获取要调用的方法 ```c++ napi_value method; napi_get_named_property(env, tsObj, "methodName", &method); ``` 3. 构建参数列表 ```c++ napi_value arg1; napi_create_int32(env, 123, &arg1); napi_value arg2; napi_create_string_utf8(env, "hello", NAPI_AUTO_LENGTH, &arg2); napi_value args[] = { arg1, arg2 }; ``` 4. 调用方法 ```c++ napi_value result; napi_call_function(env, tsObj, method, 2, args, &result); ``` 其中，env为当前napi_env实例，exports为当前addon的导出对象。在构建参数列表时，可以根据方法的参数个数和类型，自定义参数变量。调用方法时，可以根据返回值类型，自定义返回值变量。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值