HarmonyOS Next 使用NAPI封装ArkTS接口案例_homony next 设置api

最新推荐文章于 2024-05-21 20:09:47 发布
最新推荐文章于 2024-05-21 20:09:47 发布
阅读量959 收藏 21
点赞数 12
分类专栏： 程序员 文章标签： harmonyos 华为
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_84164595/article/details/137705148
版权

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数HarmonyOS鸿蒙开发工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年HarmonyOS鸿蒙开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。
img

img
img
htt

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）
img

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

// step：类型声明
class DocumentViewPickerSelectThenCbWrapper {
public:
documentSelectThenFn thenFn;
DocumentViewPickerSelectThenCbWrapper(documentSelectThenFn fn) : thenFn(fn) {}
/**
* 将对象实例包装为js对象
/
napi_value convert2NapiValue(napi_env env);
/*
* 参数是string[]，这里面会调用thenFn，ets侧调用
*/
static napi_value call(napi_env env, napi_callback_info info);
};
// step2：convert2NapiValue方法实现
napi_value etswrapper::DocumentViewPickerSelectThenCbWrapper::convert2NapiValue(napi_env env) {
napi_value object;
DocumentViewPickerSelectThenCbWrapper *thenWrapper = new DocumentViewPickerSelectThenCbWrapper(this->thenFn);
NODE_API_CALL(env, napi_create_object(env, &object));
NODE_API_CALL(env, napi_wrap(
env, object, thenWrapper,
[](napi_env env, void *finalize_data, void *finalize_hint) -> void {
delete reinterpret_cast<DocumentViewPickerSelectThenCbWrapper *>(finalize_data);
},
nullptr, nullptr));
napi_property_descriptor desc[] = {
{“call”, nullptr, DocumentViewPickerSelectThenCbWrapper::call, nullptr, nullptr, nullptr, napi_default,
nullptr},
};
NODE_API_CALL(env, napi_define_properties(env, object, sizeof(desc) / sizeof(*desc), desc));
return object;
}
// step3：call方法实现
napi_value etswrapper::DocumentViewPickerSelectThenCbWrapper::call(napi_env env, napi_callback_info info) {
// …
napi_value thisArg;
NODE_API_CALL(env, napi_get_cb_info(env, info, &argc, args, &thisArg, nullptr));
DocumentViewPickerSelectThenCbWrapper *thenWrapper;
NODE_API_CALL(env, napi_unwrap(env, thisArg, reinterpret_cast<void **>(&thenWrapper)));
// …
thenWrapper->thenFn(data);
return nullptr;
}

 ets侧：

function documentViewPickerSelect(uiContext: UIContext, options: picker.DocumentSelectOptions, thenWrapper:
StringArrayThenCbWrapper, catchWrapper: CatchCbWrapper): void {
let documentViewPicker: picker.DocumentViewPicker = new picker.DocumentViewPicker();
documentViewPicker.select(options).then((value: string[]) => {
thenWrapper.call(value);
}).catch((error: BusinessError) => {
// …
})
}

5. 多实例情况下，需要在正确的窗口/UIAbility内执行方法。本例通过监听windowStage的状态加上UIContext.runScopedTask方法来实现：

// step1：
windowStage.on(“windowStageEvent”, (data: window.WindowStageEventType) => {
if (data === window.WindowStageEventType.ACTIVE) {
etswrapper.setTopAbilityID(abilityID);
}
}

// step2：
function documentViewPickerSelect(uiContext: UIContext, options: picker.DocumentSelectOptions, thenWrapper:
StringArrayThenCbWrapper, catchWrapper: CatchCbWrapper): void {
uiContext.runScopedTask(() => {
// …
})
}



#### 工程结构&模块类型

dragtoswitchpictures // har包
|—cpp // cpp源码
| |—include // 头文件
| |—src // 源码
|—ets/view
| |—MockNativeCallPickerView.ets // 模拟cpp侧发起调用
|—ets/wrapper
| |—wrapper.ets // 封装的js方法


#### 模块依赖


1. [routermodule]( )：模块动态导入使用
2. [common/utils]( )：使用功能描述组件


#### 高性能知识点


**不涉及**


#### 参考资料


1. [NAPI]( )
2. [aki]( )


#### 其他说明


1. 本例仅实现了DocumentViewPicker的Select方法，对于Save方法，本例搭建了整体框架，因其实现流程基本与Select方法别无二致，因此本例没有具体实现
2. TODO：当前使用的是windowStage.on("windowStageEvent") 来获取当前活跃窗口对应的UIContext，从理论上来讲，因为事件的处理流程有如下两条并行路径，因此在2in1设备的多实例场景下，直接点击失焦窗口的按钮时，可能会在错误的窗口内响应事件: 

             |->焦点切换->on事件分发

多模事件输入->窗口管理
|->arkui->button事件触发



最后，有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的**鸿蒙（HarmonyOS NEXT）资料**用来跟着学习是非常有必要的。 


**这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了**（**ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony****多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）**技术知识点。


希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，**限时开源，先到先得~无套路领取！！**


**如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员，可以直接领取这份资料**


**获取这份完整版高清学习路线，请点击→**[纯血版全套鸿蒙HarmonyOS学习资料]( )****


### **鸿蒙（HarmonyOS NEXT）最新学习路线**


**![](https://img-blog.csdnimg.cn/direct/2636417e951b4ec9b5a1334224fcd239.png)**


* **HarmonOS基础技能**


![](https://img-blog.csdnimg.cn/direct/72fd2509a44e4bf98bbe1f983b5a4ff6.png)


* **HarmonOS就业必备技能** ![](https://img-blog.csdnimg.cn/direct/18f024bc5f0a4353912996010ed6cc81.png)
* **HarmonOS多媒体技术**


![](https://img-blog.csdnimg.cn/direct/b9ead66dadc245fdadce4d77feb47a28.png)


* **鸿蒙NaPi组件进阶**


![](https://img-blog.csdnimg.cn/direct/0744fbd1454f41b0a3f605fb4a51f5f3.png)


* **HarmonOS高级技能**


![](https://img-blog.csdnimg.cn/direct/743b668910224b259a5ffe804fa6d0db.png)


* **初识HarmonOS内核**![](https://img-blog.csdnimg.cn/direct/9e79fbdc4bb74f179584c5552aa547d5.png)
* **实战就业级设备开发**


![](https://img-blog.csdnimg.cn/direct/d2012fa9c57a400da25a2182a38cbdcb.png)


 有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的**鸿蒙（OpenHarmony ）学习手册（共计1236页）**与**鸿蒙（OpenHarmony ）开发入门教学视频**，内容包含：**ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。**


**获取以上完整版高清学习路线，请点击→[纯血版全套鸿蒙HarmonyOS学习资料]( )**


#### **《鸿蒙 (OpenHarmony)开发入门教学视频》**


![](https://img-blog.csdnimg.cn/direct/ad3cb3acb77e470fa93ac0471d4e7f0f.png)


#### 《鸿蒙生态应用开发V2.0白皮书》


![图片](https://img-blog.csdnimg.cn/img_convert/bf439a395d3ce8e8cf3dee8e8b75e3a9.jpeg)


#### **《鸿蒙 (OpenHarmony)开发基础到实战手册》**


OpenHarmony北向、南向开发环境搭建


![图片](https://img-blog.csdnimg.cn/img_convert/aff76dc1c3c84c360a9ff825908b2e98.png)


#### **《鸿蒙开发基础》**


* ArkTS语言
* 安装DevEco Studio
* 运用你的第一个ArkTS应用
* ArkUI声明式UI开发
* .……


![图片](https://img-blog.csdnimg.cn/img_convert/2b8f290e39e52efb0a5709be96ff82ea.png)


#### **《鸿蒙开发进阶》**

1c3c84c360a9ff825908b2e98.png)


#### **《鸿蒙开发基础》**


* ArkTS语言
* 安装DevEco Studio
* 运用你的第一个ArkTS应用
* ArkUI声明式UI开发
* .……


![图片](https://img-blog.csdnimg.cn/img_convert/2b8f290e39e52efb0a5709be96ff82ea.png)


#### **《鸿蒙开发进阶》**
2401_84164595
关注
  • 12
    点赞
  • 踩
  • 21
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
【HarmonyOS NEXT】是否有重启App的API
Mayism123的博客
03-12 464
2.新建一个ets页面（以AbilityStage为例），在onCreate中给应用赋能。3.在module.json5的srcEntry中配置新建ets的路径。重启 / restartApp / appRecovery / 恢复。1.在module.json5中配置支持恢复的Ability。4.页面调用appRecovery.restartApp();是否有重启App的API？作用相当于清除后台应用，再次进入。注意：该功能有内置CD，60秒内只能重启1次。
【HarmonyOS NEXT】怎么用API区分App的运行环境是模拟器还是root
Mayism123的博客
02-08 482
ohos.sensor (传感器) - AMBIENT_LIGHT。@ohos.telephony.call (拨打电话)可以通过如下方式来判断应用的运行环境是模拟器。电量信息：因为模拟器电量一般不变、判断充电信息。@ohos.deviceInfo (设备信息)设备信息：因为CPU指令集abiList。传感器：因为模拟器一般没有光传感器。拨号：因为模拟器一般无法拨号。
三方库移植之NAPI开发[1]—Hello OpenHarmony NAPI
m0_70748458的博客
05-15 322
NAPI（Native API）组件是一套对外接口基于Node.js N-API规范开发的原生模块扩展开发框架。OpenHarmony中组件有一种是C和C++语言的三方组件，通常以源码或OpenHarmony hpm包的方式引入，在应用开发中以NAPI的方式使用，或直接编译在OpenHarmony操作系统镜像NAPI组件架构图OpenHarmony 标准系统应用开发基于ArkUI框架，开发语言使用JS/eTS。部分业务场景依赖使用现有的C/C++ 库，或为了获取更高的性能。
HarmonyOS开发：NEXT版本开发新体验
知足常乐
03-12 2199
年前，公司团队接洽了鸿蒙方团队，确认了生态合作，于是开通了白名单权限，授权了新的IDE和相关文档的使用和查看，历经一月有余，谈谈NEXT版本有哪些开发上的区别。
HarmonyOS Next 使用NAPI封装ArkTS接口案例_homony next 设置api(1)
2401_84164595的博客
04-13 946
（**ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony****多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）**技术知识点。最后，有很多小伙伴不知道学习哪些鸿蒙开发技术？有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的。希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，
基于HarmonyOS ArkUI和napi的MQTT客户端实现
11-09
在这个案例中，原生的 paho-mqtt C 库被移植并改造以适应 HarmonyOS 的 napi 环境，使得 MQTT 功能可以在 HarmonyOS 上运行。 2. **C 库和 ArkUI 连接部分的实现**：这部分代码负责处理 MQTT 连接的建立、维护以及...
napi.rar_V2 _linux napi
09-23
标题中的“napi.rar_V2_linux napi”表明这是一个与Linux内核网络接口相关的更新，具体是Network API（Network Application Programming Interface）的版本2。NAPI是一个用于优化Linux内核网络接收路径的机制，旨在...
napi_demo:适用于N-API的简单http服务器演示项目
05-08
克隆克隆napi_demo项目以运行该应用程序： git clone https://github.com/boingoing/napi_demo.git正在安装通过标准npm方法安装应用程序： npm install建造我们在此处使用的leveldown模块已启用N-API，但该模块没有...
Particle Factory template.rar_EDEM颗粒工厂API_EDEM颗粒工厂API编译程序_factor
07-14
1. **颗粒属性**：包括颗粒的形状（如球形、立方体等）、尺寸、质量、颜色、摩擦系数等，这些属性通过API设置，影响颗粒的运动和相互作用。 2. **碰撞模型**：EDEM支持多种碰撞模型，如刚性碰撞、塑性碰撞等，...
napi-canon-cameras:佳能相机的Node AddOn Api模块
03-11
@ Dimension / napi-canon-cameras 适用于Node.js的EDSDK（佳能相机）包装器模块 特征 EDSDK提供了许多功能，但并非所有功能都在模块中实现。 我们的用例是照相亭应用程序。 列出相机 相机事件 读取相机属性 ...
OpenHarmony系统之Napi框架生成工具介绍
wjianwei666的专栏
02-22 1102
当开发者为OpenHarmony系统上开发JS与C++ 交互的接口时，需要使用NAPI进行接口封装：首先需要用户定义JS接口，然后创建NAPI模块、实现NAPI初始化函数、封装JS接口、处理JS调用，最后进行构建和部署。这需要开发人员熟悉NAPI，有一定的学习成本。而Napi框架生成工具可以根据用户指定路径下的ts(typescript)接口文件一键生成NAPI框架代码、业务代码框架，这为开发者提供了一种快速、高效的开发方式，可以大大提高开发效率。
北向应用集成三方库——NAPI生命周期
m0_71263309的博客
04-13 864
我们都知道，程序的生命周期是指程序从启动，运行到最后的结束的整个过程。生命周期的管理自然是指控制程序的启动，调用以及结束的方法。而NAPI中的生命周期又是怎样的呢？如下图所示：从图上我们可以看出，在js应用启动时会加载napi模块，而在napi模块加载过程中会创建一个napi对象A提供给应用使用，在应用退出或者主动释放A对象前，A对象必须一直保持"活跃"状态。从A对象创建到释放的整个过程也代表着A对象的生命周期。
napi系列学习高阶篇——通过IDE集成C/C++三方库并开发napi接口
maniuT的博客
04-13 1513
应用在调用系统固件集成的C/C++三方库时，可能会由于系统固件集成端与IDE的NDK中libc++版本不一致导致调用失败，而且系统固件集成的C/C++三方库对于应用的调式也很不友好，需要多方编译调试，很不方便。因此本文将通过在IDE上适配openjpeg 三方库为例介绍IDE上适配一个C/C++三方库的具体流程。根据原生库的测试用例，我们封装2个测试用例接口} J2K_Info;
北向应用集成三方库——Napi接口封装工具aki
m0_71263309的博客
04-13 905
用户业务 C++ 代码 hello.cpp:全程无感。
北向应用集成三方库——NAPI数据类型转换与同步调用
m0_71263309的博客
04-13 863
在 通过IDE创建工程 的示例代码中，我们使用napi_create_string_utf8函数将C/C++ string转换成NAPI类型——napi_value。NAPI定义API方法时的接收参数为(napi_env, napi_callback_info)，其中napi_callback_info为上下文的信息。因传入的参数是Javascript值类型，并被框架封装成统一的唯一类型——napi_value类型，为了能够进行计算，我们需要获取其对应在C/C++中的类型的值。4.鸿蒙开发系统底层方向。
napi系列学习进阶篇——NAPI 导出类对象
maniuT的博客
04-13 972
js调用napi的数据，对于简单的数据类型，只需要napi返回对应类型的napi_value数据即可 (详情参照napi数据类型类型与同步调用)。但是对于一些复杂的数据类型(如我们常用C++的类对象)，是不能直接返回一个napi_value数据的。这时我们需要对这些数据进行一系列操作后将其导出，这样js才能使用导出后的对象。本文以导出类对象为例来说明napi导出对象的具体过程。
三方库移植之NAPI开发[4]异步调用:Callback&Promise
maniuT的博客
04-12 1108
以下图片为个人总结，可以在文末下载清晰的图片
OpenHarmony 入门——初识JS/ArkTS 侧的“JNI” NAPI（一）
最新发布
最美不过，心中有梦，身旁有你！
05-21 987
NAPI全称Native Application Programming Interface（最新版的文档已经改为Node-API了）属于UI框架ArkUI子系统的一部分，类似于Java中使用的 JNI机制
napi_get_reference_value 函数
06-03
napi_get_reference_value 是 Node.js 的 N-API 中的一个函数，其作用是将一个 N-API 的引用转换为对应的 JavaScript 值。这个函数的原型如下： ```c++ napi_status napi_get_reference_value(napi_env env, napi_ref ref, napi_value* result); ``` 参数说明： - env：N-API 的环境对象。 - ref：N-API 引用。 - result：用于存储转换后的 JavaScript 值的指针。 函数返回值为一个枚举值 napi_status，表示函数执行的状态，如果状态为 napi_ok，则表示函数执行成功。 使用 napi_get_reference_value 函数时，需要先创建一个 N-API 的引用，然后将这个引用传给函数，函数就会将引用转换为对应的 JavaScript 值。这个函数主要用于在 C++ 中访问 JavaScript 对象或函数。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值