OpenHarmony实战开发-NAPI封装ArkTS接口案例。

介绍

部分应用的主要开发语言为C/C++，但是HarmonyOS的部分接口仅以ArkTS的形式暴露，因此需要将ArkTS的接口封装为Native接口。本例以DocumentViewPicker的Select方法为例，提供了Napi封装ArkTS API的通用方法，本例包含内容如下：

  1. Native侧与ArkTS侧的相互调用
  2. Native对象转换为ArkTS对象（包括如何在ArkTS侧调用一般形式的Native方法）
  3. 线程安全函数的使用
  4. 等待线程安全函数的执行结果
  5. 多实例情况下，如何在正确的窗口内执行方法

效果图预览

在这里插入图片描述
测试说明：

  1. 点击"JS线程调用"按钮，从native侧js线程拉起picker
  2. 点击"PThread线程调用"按钮，从native侧pthread子线程中拉起picker
  3. 拉起picker后，单击直接选择单个文件，长按可选择多个文件
  4. 本例在拉起picker时设置了maxSelectNumber=3，最多个选择3个文件

集成说明：

  1. 源码集成
  2. 参考aki方式集成

使用说明：

  1. [建议]在EntryAbility之外调用registryDocumentViewPickerFn方法，避免多实例下的重复注册
  2. [必须]给每个UIAbility生成唯一的ID属性，可使用generateAbilityID方法
  3. [必须]在UIAbility的onWindowStageCreate中的windowStage.loadContent的回调中调用addUIContext方法
  4. [必须]在UIAbility的onWindowStageCreate中的windowStage.loadContent之后调用setTopAbilityID
  5. [建议]在UIAbility的onWindowStageDestroy中调用removeUIContext方法

实现思路

  1. native侧需要主动调用ets侧的代码，需要将ets侧代码注入到native侧，并在注册时创建函数的引用及线程安全函数，并保存当前线程（js线程）的id及env供后续调用时使用
  2. ets侧：
etswrapper.registryDocumentViewPickerFn(documentViewPickerSelect, documentViewPickerSave);

native侧：

NODE_API_CALL(env, napi_create_threadsafe_function(env, args[0], nullptr, selectWork, 0, 1, nullptr, nullptr,nullptr, tsfn::callJSSelect, &(uniContext->selectTsfn)));
NODE_API_CALL(env, napi_create_threadsafe_function(env, args[1], nullptr, saveWork, 0, 1, nullptr, nullptr,nullptr, tsfn::callJSSave, &(uniContext->saveTsfn)));
NODE_API_CALL(env, napi_create_reference(env, args[0], 1, &(uniContext->selectRef)));
NODE_API_CALL(env, napi_create_reference(env, args[1], 1, &(uniContext->saveRef)));
uniContext->pickerEnv = env;
uniContext->jsThreadID = fns::getCurrentThreadID();

2.对于某些有返回值的ets函数，为了获取其返回值，需要对调用线程进行区分：如果是js线程，直接通过napi_call_function发起调用并获得返回值；否则需要等异步线程执行完毕并通过全局变量获取结果然后返回

if (uniContext->jsThreadID != fns::getCurrentThreadID()) {status = napi_acquire_threadsafe_function(uniContext->selectTsfn);status = napi_call_threadsafe_function(uniContext->selectTsfn, selectParam, napi_tsfn_blocking);std::unique_lock<std::mutex> unil(uniContext->resultWaitUtil.lock);uniContext->resultWaitUtil.cv.wait(unil, [] { return uniContext->resultWaitUtil.isFinished; });return;} else {status = napi_call_function(uniContext->pickerEnv, nullptr, tsSelect, 4, args, &result);}

3.因为napi中的线程安全函数只能通过napi_threadsafe_function_call_js中的data参数进行传参，因此需要将所需参数全部封装到一个对象中

DocumentViewPickerSelectParam *selectParam = new DocumentViewPickerSelectParam(options, thenWrapper, catchWrapper)

4.因为本例中的filepicker是异步的，回调函数需要调用者传入，而napi中若需要将native方法直接封装为ets方法对于函数类型是有要求的。因此这里通过将回调函数封装到对象中，通过对象包装来实现将一般类型的函数封装为ets侧的函数：

native侧：

// 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.本例仅实现了DocumentViewPicker的Select方法，对于Save方法，本例搭建了整体框架，因其实现流程基本与Select方法别无二致，因此本例没有具体实现

2.TODO：当前使用的是windowStage.on(“windowStageEvent”) 来获取当前活跃窗口对应的UIContext，从理论上来讲，因为事件的处理流程有如下两条并行路径，因此在2in1设备的多实例场景下，直接点击失焦窗口的按钮时，可能会在错误的窗口内响应事件:

               |->焦点切换->on事件分发
多模事件输入->窗口管理|->arkui->button事件触发

如果大家还没有掌握鸿蒙，现在想要在最短的时间里吃透它，我这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

《鸿蒙开发学习手册》：

如何快速入门：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.基本概念
2.构建第一个ArkTS应用
3.……
在这里插入图片描述

开发基础知识：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……
在这里插入图片描述

基于ArkTS 开发：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……
在这里插入图片描述

鸿蒙语法ArkTS、TypeScript、ArkUI等…视频教程：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

在这里插入图片描述

鸿蒙生态应用开发白皮书V2.0PDF：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

在这里插入图片描述

HarmonyOS APP开发教程案列：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

在这里插入图片描述

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/823527.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

8个视频剪辑素材网，免费下载！

8个视频剪辑素材网，免费下载！

视频剪辑从业者应该去哪里找免费的剪辑素材&#xff1f;收藏好下面这8个网站&#xff0c;告别付费&#xff0c;永久免费。 免费视频素材 1、菜鸟图库 https://www.sucai999.com/video.html?vNTYwNDUx 菜鸟图库虽然是个设计素材网站&#xff0c;但除了设计类素材之外还有很多…
阅读更多...
短视频素材在哪里可以找到？8个视频素材软件app免费

短视频素材在哪里可以找到？8个视频素材软件app免费

在这个视觉内容占据重要地位的时代&#xff0c;每一位视频创作者都需要从全球各种独特的资源中寻找灵感。以下精选的优质视频素材网站不仅能提供高质量的无水印视频素材&#xff0c;还能帮助你把握项目的视觉冲击力&#xff0c;使你的作品在众多内容中脱颖而出。 1. 蛙学府&…
阅读更多...
Vue2:标签页一个页面拆分成俩个选项卡

Vue2:标签页一个页面拆分成俩个选项卡

概要 在自己的项目中&#xff0c;标签页组件显示一般就是点击一个页面&#xff0c;然后标签页组件显示该页面的名称。但是如果你是一个页面文件中展示不同的内容比如( 某模块的新增页面 和 详情页面)一般内容新建页面和详情页面差别不是很大&#xff0c;有的内容甚至俩边都会用…
阅读更多...
【kubeEdge】离线部署

【kubeEdge】离线部署

部署 kubeEdge 在线部署 在线方式部署直接执行以下命令&#xff0c;会联网下载需要的安装文件执行安装 $ keadm init --advertise-address{ip} --kubeedge-version{version} --kube-config{config_path}&#xff0c; 离线部署 离线准备工作 所有下载操作均在可以联网的机…
阅读更多...
CSS3 新特性 box-shadow 阴影效果、圆角border-radius

CSS3 新特性 box-shadow 阴影效果、圆角border-radius

圆角 使用CSS3 border-radius属性&#xff0c;你可以给任何元素制作"圆角"&#xff0c;border-radius属性&#xff0c;可以使用以下规则&#xff1a; &#xff08;1&#xff09;四个值&#xff1a;第一个值为左上角&#xff0c;第二个值为右上角&#xff0c;第三个值…
阅读更多...
Trigger触发器

Trigger触发器

触发器是指当满足预设的条件时去执行一些事务的工具&#xff0c;比如我们希望鼠标移到某个按钮上方时&#xff0c;这个按钮的颜色、大小发生一些改变。这个时候&#xff0c;条件是鼠标移到按钮上&#xff0c;执行的事务是改变按钮的颜色和大小。 触发器种类 触发器主要运用的场…
阅读更多...
组织机构代码是哪几位?营业执照怎么看组织机构代码?

组织机构代码是哪几位?营业执照怎么看组织机构代码?

组织机构代码是哪几位? 组织机构代码通常指的是组织机构代码证上的一组特定数字&#xff0c;它用于唯一标识一个组织或机构。在中国&#xff0c;组织机构代码由9位数字组成&#xff0c;前8位是本体代码&#xff0c;最后1位是校验码。这组代码是按照国家有关标准编制的&#x…
阅读更多...
GitHub repository - Pulse - Contributors - Network

GitHub repository - Pulse - Contributors - Network

GitHub repository - Pulse - Contributors - Network 1. Pulse2. Contributors3. NetworkReferences 1. Pulse 显示该仓库最近的活动信息。该仓库中的软件是无人问津&#xff0c;还是在火热地开发之中&#xff0c;从这里可以一目了然。 2. Contributors 显示对该仓库进行过…
阅读更多...
Realsense D455 调试

Realsense D455 调试

1 Realsense D455 配置&#xff1a; RGB&#xff1a;彩色相机&#xff0c;FOV&#xff08;h&#xff0c;v&#xff09;&#xff08; 90*65 &#xff09;红外点阵发射&#xff1a;位于上图中RGB右边&#xff0c;发射特定模式的红外光&#xff0c;通常是一种点阵图案&#xff0c…
阅读更多...
用Skimage学习数字图像处理（021）：图像特征提取之线检测（下）

用Skimage学习数字图像处理（021）：图像特征提取之线检测（下）

本节是特征提取之线检测的下篇&#xff0c;讨论基于Hough变换的线检测方法。首先简要介绍Hough变换的基本原理&#xff0c;然后重点介绍Skimage中含有的基于Hough变换的直线和圆形检测到实现。 目录 10.4 Hough变换 10.4.1 原理 10.4.2 实现 10.4 Hough变换 Hough变换&…
阅读更多...
项目实现：Boost搜索引擎

项目实现：Boost搜索引擎

目录 一.项目背景 二. 搜索引擎的宏观原理 三.使用到的技术栈与项目环境 四.正排索引vs倒排索引 五.认识标签与去标签 六.建立索引模块 七&#xff0c;编写http服务端 八&#xff0c;编写前端页面 九.搜索结果的优化 遇到的问题&#xff1a; 项目源码&#xff1a;boos…
阅读更多...
JS/TS笔记学习1

JS/TS笔记学习1

周末总得学点什么吧~ 奥利给! 跑火车 递归 减速 let currentIndex 0; let speed 500; // 初始速度&#xff0c;单位是毫秒 let decrement 20; // 每次迭代速度减少的量 const cells document.querySelectorAll(.cell); function highlightCell() { cells.forEach(…
阅读更多...
Boost电感的作用

Boost电感的作用

Boost电感在Boost升压电路中起着关键的作用。Boost电路是一种DC-DC电源转换器&#xff0c;其主要功能是将低电压直流&#xff08;DC&#xff09;信号转换为高电压直流&#xff08;DC&#xff09;信号。Boost电感在这个过程中起着平滑电流、储存能量和提高电路效率的作用。 具体…
阅读更多...
柯桥商务口语之怎么样说英语更加礼貌？十个礼貌用语get起来！

柯桥商务口语之怎么样说英语更加礼貌？十个礼貌用语get起来！

当你在国外需要帮助的时候&#xff0c;这些礼貌用语真的是能够帮到你的哦 1.Would/Could you help me? 你可帮助我吗&#xff1f; 相信有些人想请求帮助的时候&#xff0c;一开口就用Can you&#xff0c;这个用在朋友或者熟人上面当然是没有问题的&#xff0c;但是如果是向…
阅读更多...
Node.js 中的 RSA 加密、解密、签名与验证详解

Node.js 中的 RSA 加密、解密、签名与验证详解

引言 在现代的网络通信中&#xff0c;数据安全显得尤为重要。RSA加密算法因其非对称的特性&#xff0c;广泛应用于数据的加密、解密、签名和验证等安全领域。本文将详细介绍RSA算法的基本原理&#xff0c;并结合Node.js环境&#xff0c;展示如何使用内置的crypto模块和第三方库…
阅读更多...
基于 LSTM 模型的古诗词自动生成算法实现及系统实现

基于 LSTM 模型的古诗词自动生成算法实现及系统实现

近年来&#xff0c;研究者在利用循环神经网络&#xff08;Recurrent Neural Network&#xff0c;RNN&#xff09;进行古诗自动生成方面取得了显著的效果。但 RNN 存在梯度问题&#xff0c;导致处理时间跨度较长的序列时 RNN 并不具备长期记忆存储功能。随后&#xff0c;出现的基…
阅读更多...
【架构方法论（一）】架构的定义与架构要解决的问题

【架构方法论（一）】架构的定义与架构要解决的问题

文章目录 一. 架构定义与架构的作用1. 系统与子系统2. 模块与组件3. 框架与架构4. 重新定义架构&#xff1a;4R 架构 二、架构设计的真正目的-别掉入架构设计的误区1. 是为了解决软件复杂度2. 简单的复杂度分析案例 三. 案例思考 本文关键字 架构定义 架构与系统的关系从业务逻…
阅读更多...
企业linux-堡垒机与跳板机测试案例-6140字详谈

企业linux-堡垒机与跳板机测试案例-6140字详谈

在开始今天内容前&#xff0c;小编先把专栏前面学的Linux命令&#xff08;部分&#xff09;做了思维导图帮助各位平时的学习&#xff1a; 场景&#xff1a; 运维人员管理三台机器&#xff0c;通过远程连接工具连接上三台机器&#xff0c;也知道这三台机器root密码&#xff0c…
阅读更多...
【Java探索之旅】掌握数组操作，轻松应对编程挑战

【Java探索之旅】掌握数组操作，轻松应对编程挑战

&#x1f3a5; 屿小夏 &#xff1a; 个人主页 &#x1f525;个人专栏 &#xff1a; Java编程秘籍 &#x1f304; 莫道桑榆晚&#xff0c;为霞尚满天&#xff01; 文章目录 &#x1f4d1;前言一、数组巩固练习1.1 数组转字符串1.2 数组拷贝1.3 求数组中的平均值1.4 查找数组中指…
阅读更多...
Windows版Apache 2.4.59解压直用（免安装-绿色-项目打包直接使用）

Windows版Apache 2.4.59解压直用（免安装-绿色-项目打包直接使用）

windows下Apache分类 Apache分为 安装版和解压版 安装版: 安装方便&#xff0c;下一步------下一步就OK了&#xff0c;但重装系统更换环境又要重新来一遍&#xff0c;会特别麻烦 解压版&#xff08;推荐&#xff09;&#xff1a; 这种方式&#xff08;项目打包特别方便&#x…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023