鸿蒙5.0开发进阶:NDK代码开发-Node-API使用指南(使用Node-API进行自定义异步操作相关开发)

鸿蒙开发实战(HarmonyOS)通过Node-API进行自定义异步操作场景 使用Node-API的自定义异步操作功能,可以使ArkTS的使用更加灵活和高效,可以处理那些可能阻塞事件循环的长时间运行任务,同时保持ArkTS应用的响应性和性能。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


使用Node-API进行自定义异步操作相关开发

简介

使用Node-API的自定义异步操作功能,可以使ArkTS的使用更加灵活和高效,可以处理那些可能阻塞事件循环的长时间运行任务,同时保持ArkTS应用的响应性和性能。

基本概念

Node-API支持异步操作,这对于处理IO密集型或计算密集型的任务非常重要,因为这些任务通常需要非阻塞的执行方式以避免阻塞主线程。以下是一些关于自定义异步操作的基本概念:

  • 异步模型: Node-API支持异步模型,提供了Promise和Callback两种方式来实现异步操作。Promise是一种基于未来值的编程模型,它允许开发者将异步操作的结果封装在一个对象中,并通过链式调用的方式处理异步操作的结果。Callback则是一种传统的异步编程方式,通过回调函数来处理异步操作的结果。
  • 临时结果: 当原生方法(即Node-API代码)被调用时,它会立即返回一个临时结果给ArkTS调用者。这个临时结果通常是一个表示异步操作正在进行中的标志,或者是用于后续处理异步操作结果的句柄。
  • 回调或Promise: 当异步操作完成后,结果会通过回调函数或Promise对象返回给ArkTS调用者。这样,ArkTS代码就可以在异步操作完成后继续执行后续的逻辑。

场景和功能介绍

这些Node-API接口可以在Node-API模块中执行异步操作、进行ArkTS回调以及管理相关资源的生命周期。通过使用这些函数,可以有效地与ArkTS环境进行交互,并实现复杂的异步操作。他们的使用场景如下:

接口描述
napi_async_init、napi_async_destroy用于创建和销毁异步资源上下文环境。这些函数可以用于处理长时间运行的异步操作,例如文件I/O操作、网络请求等。在这些情况下,创建异步资源上下文环境,执行必要的异步任务,然后销毁资源以释放相关的资源和内容。
napi_make_callback用于在异步资源上下文环境中执行ArkTS回调函数。在处理异步操作的结果后,将结果传递回ArkTS代码。
napi_open_callback_scope、napi_close_callback_scope用于创建和关闭回调作用域。在异步操作期间执行ArkTS代码并管理其上下文。

使用示例

Node-API接口开发流程参考使用Node-API实现跨语言交互开发流程,本文仅对接口对应C++及ArkTS相关代码进行展示。

napi_async_init、napi_async_destroy

在需要管理异步资源上下文环境的创建和销毁时,可以使用napi_async_init和napi_async_destroy来管理这些环境。需要注意的是,这些函数不支持与async_hook相关的能力,所以在使用时需要注意可能会存在的限制。

napi_make_callback

在编写Node-API模块时,需要在异步操作完成后调用ArkTS回调函数。可以使用napi_async_init创建异步资源上下文环境,然后使用napi_make_callback在该环境中执行ArkTS回调函数。

napi_open_callback_scope、napi_close_callback_scope

在需要创建一个回调作用域来确保异步操作期间ArkTS环境仍然可用时。可以使用napi_open_callback_scope创建回调作用域,然后在异步操作完成后使用napi_close_callback_scope关闭该作用域。

cpp部分代码

#include "napi/native_api.h"

static constexpr int INT_ARG_2 = 2; // 入参索引
static constexpr int INT_ARG_3 = 3; // 入参索引

static napi_value AsynchronousWork(napi_env env, napi_callback_info info)
{
    // 接受四个参数
    size_t argc = 4;
    napi_value args[4] = {nullptr};
    // 从回调信息中获取参数
    napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);
    // 提取参数中的资源、接收器对象和函数
    napi_value resource = args[0];
    napi_value recv = args[1];
    napi_value func = args[INT_ARG_2];
    napi_value argv[1] = {nullptr};
    argv[0] = args[INT_ARG_3];
    // 获取函数的类型
    napi_valuetype funcType;
    napi_typeof(env, func, &funcType);
    // 创建一个资源名称为"test"的字符串
    napi_value resourceName = nullptr;
    napi_create_string_utf8(env, "test", NAPI_AUTO_LENGTH, &resourceName);
    // 初始化异步上下文
    napi_async_context context;
    napi_status status = napi_async_init(env, resource, resourceName, &context);
    if (status != napi_ok) {
        napi_throw_error(env, nullptr, "napi_async_init fail");
        return nullptr;
    }
    // 打开回调作用域
    napi_callback_scope scope = nullptr;
    napi_open_callback_scope(env, resource, context, &scope);
    if (status != napi_ok) {
        napi_throw_error(env, nullptr, "napi_open_callback_scope fail");
        return nullptr;
    }
    // 调用回调函数
    napi_value result = nullptr;
    if (funcType == napi_function) {
        napi_make_callback(env, context, recv, func, 1, argv, &result);
    } else {
        napi_throw_error(env, nullptr, "Unexpected argument type");
        return nullptr;
    }
    // 关闭回调作用域
    napi_close_callback_scope(env, scope);
    if (status != napi_ok) {
        napi_throw_error(env, nullptr, "napi_close_callback_scope fail");
        return nullptr;
    }
    // 销毁异步上下文
    napi_async_destroy(env, context);
    return result;
}

接口声明

// index.d.ts
export const asynchronousWork: (object: Object, obj: Object, fun: Function, num: number) => number | void;

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'
import process from '@ohos.process'
try {
  hilog.info(0x0000, 'testTag', 'Test Node-API asynchronousWork: %{public}d', testNapi.asynchronousWork({}, process.ProcessManager, (num: number)=>{return num;}, 123));
} catch (error) {
  hilog.error(0x0000, 'testTag', 'Test Node-API asynchronousWork error: %{public}s', error.message);
}

以上代码如果要在native cpp中打印日志,需在CMakeLists.txt文件中添加以下配置信息(并添加头文件:#include "hilog/log.h"):

// CMakeLists.txt
add_definitions( "-DLOG_DOMAIN=0xd0d0" )
add_definitions( "-DLOG_TAG=\"testTag\"" )
target_link_libraries(entry PUBLIC libhilog_ndk.z.so )

鸿蒙HarmonyOS应用开发之NDK开发指南 build目录:放置预定义的toolchain脚本文件ohos.toolchain.cmakeCMake编译时需要读取该文件中的默认值,比如编译器架构、C++库链接方式等,因此在编译时会通过CMAKE_TOOLCHAIN_FILE指出该文件的路径,便于CMake在编译时定位到该文件。build-tools文件夹:放置NDK提供的编译工具# 键入下一行命令查看CMake的版本# 结果llvm文件夹:放置NDK提供的编译器。 阅读详情

相关推荐

PowerBI参数化实战:3分钟搞定动态数据源切换(附常见错误排查)

本文详细介绍了PowerBI参数化实战技巧,教你3分钟实现动态数据源切换。通过创建参数、改造查询和测试切换三步,轻松应对多环境部署与团队协作中的路径问题,并附上常见错误排查指南,有效提升报表的可维护性和工作效率。

p1q2r的博客 586

NAPI 提供回调

5.因为要保持生命周期,需要做持久化。4.把callback对象给JS。1.创建callback对象。前置:声明一下d.ts。

714

如何在huggingface上申请下载使用llama2/3模型

huggingface-cli download --resume-download 模型名称 --local-dir 存放模型的位置 --local-dir-use-symlinks False --resume-download --token token序列号xxxxxxx。登录huggingface,在模型详情页面上,找到这个表单,填写内容,提交申请。需要使用梯子,country填写梯子的位置吧(比如美国)等待一小时左右,会有邮件通知。

a61022706的博客 1万+

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

OpenHarmony 中的 [N-API](https://gitee.com/openharmony/arkui_napi/tree/master)组件定义了由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.

weixin_58069108的博客 3577

22、光无线通信调制技术详解

本文详细介绍了光无线通信中的多种调制技术,包括开关键控(OOK)、脉冲位置调制(PPM)、数字脉冲间隔调制(DPIM)、副载波强度调制(SCM)、相移键控(PSK)、正交幅度调制(QAM)以及多载波调制(MCM)如OFDM和MSIM。文章分析了各类调制技术在带宽需求、功率效率、传输容量、传输速率和PAPR等方面的性能差异,并通过Matlab仿真展示了其在AWGN信道下的误码率表现。同时,对比了不同技术的适用场景,提出了调制选择流程,并结合室内光通信与自由空间光通信的应用案例,展望了未来调制技术向高频谱效率、

net55的博客 117

面试问题总结——关于YOLO系列(一)

自从刚开始接到的第一个面试开始,到现在为止,陆陆续续也参加了许多场,我像是一个刚从新手村出来的小白,一路的打怪升级刷经验,期间遇到了很多不会的,我都会及时记录总结。 到现在仍然清晰记得,第一次去面试的时候,当时被怼的多惨。。。 说明:本人是非科班出身,本科是机械电子工程专业,硕士期间的研究方向是机器学习和深度学习,因为我的简历上有关于YOLO的项目,所以我着重准备了YOLO系列的面试可能遇到的问题。 决定开启这个面试问题总结的系列,包括YOLO、C++的内容、OpenCV的内容和深度学习方面被提问的问题

boss-dog 1万+

鸿蒙5.0开发进阶:NDK开发-使用Node-API进行自定义异步操作相关开发

使用Node-API的自定义异步操作功能...........

Androidbye的博客 727

计算机组成原理(第三版)唐朔飞-第七章指令系统-课后习题

机器字长是指CPU一次能处理数据的位数通常与CPU的寄存器位数有关。指令字长是指机器指令中二进制代码的总位数。存储字长是指存储单元中存放二进制代码的总位数。三者可以相等也可以不等视不同机器而定。答:OP(4位)A1(6位)A_1(6位)A1​(6位)A2(6位)A_2(6位)A2​(6位)设二地址指令格式为该指令系统的基本格式,4位操作码共有16种编码,其中13种用来定义二地址指令,还剩3种可用作扩展标志。一地址指令条数=3∗26=192。

weixin_45735391的博客 7万+

HarmonyOS ArkUI实战开发-NAPI异步编程

笔者在第 5 小结实现了 MD5 的计算,本节笔者把 MD5 的实现放在异步线程中,先在index.d.ts// 声明异步方法// 声明同步方法表示同步实现 MD5 的计算,getMd5()表示异步实现 MD5 的调用。

maniuT的博客 789

YOLOv11 改进 - 特征融合 | 小目标检测救星:DySample动态上采样减少特征丢失

本文介绍了超轻量且高效的动态上采样器DySample与YOLOv11的结合,以解决传统上采样器工作负载大、应用场景受限的问题。DySample从点采样角度构建上采样,绕过动态卷积,使用PyTorch标准内置函数实现,无需定制CUDA包,能大幅减少参数、FLOPs等资源消耗。我们将DySample代码集成进YOLOv11。实验脚本显示,结合DySample的YOLOv11在多个密集预测任务中或表现出色。

魔改工程师的博客 1423

游戏“中台”的故事——架构演进、团队协同与产品创新的深度剖析

什么是中台?在游戏行业里,中台并不是把所有技术都归口管理、统一“圈养”。更不是简单的工具集合。它代表的,是一种“模块化底座”——把业务的通用能力、基础支撑和数据结合,变成可复用、可扩展、可创新的技术体系。让“前台”专注于创新玩法、极致体验;让“后台”稳健保障数据、安全、性能;让“中台”统合各种资源、流程、工具,形成平台型生产力。游戏中台是团队协同、技术创新、业务增长并行的产物。它让开发从重复劳动解脱,带着创新冲锋;让运营靠数据说话,精准制胜;让产品实现高效迭代,生态爆发。

本博客聚焦游戏开发技巧、创业实战心得及大学热门课程干货。这里既有技术深度,也有思维广度,无论你是开发者、创业者还是高校学子,都能在这里找到适合自己的成长之路! 1950

鸿蒙5.0开发进阶:NDK开发-使用Node-API接口处理异步操作

使用Node-API接口处理异步操作。

Androidbye的博客 716

第三方 API 调用 OpenClaw 出现 LLM request timed out 的解决方案

本文主要介绍了第三方 API 调用 OpenClaw 出现 LLM request timed out 的解决方案,希望能对使用OpenClaw的同学们有所帮助。 文章目录 1. 问题描述 2. 解决方案

weixin_43178406的博客 8万+

鸿蒙5.0开发进阶:NDK代码开发-Node-API使用指南(使用Node-API接口处理异步操作)

使用Node-API接口处理异步操作。

Androidbye的博客 735

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

鸿蒙5.0开发进阶:NDK开发-使用Node-API扩展能力接口

本文仅对接口对应C++及ArkTS相关代码进行展示。

Androidbye的博客 965

IMSL CNL 7.0.0 (x86-64)Crack

IMSL CNL 7.0.0 (x86-64)Crack intel的算法库破解文件,这是C++版本的破解文件

鸿蒙5.0开发进阶:NDK代码开发-Node-API使用指南(使用Node-API扩展能力接口)

本文仅对接口对应C++及ArkTS相关代码进行展示。

Androidbye的博客 1319

Outlook Express 6 (OE6) for Win7/Win8/Win10

英文版 Outlook Express6.0, 兼容Win7/Win10/WinXP,解压就可用。

鸿蒙5.0开发进阶:NDK代码开发-Node-API典型使用场景(使用Node-API接口进行异步任务开发)

napi_create_async_work是Node-API接口之一,用于创建一个异步工作对象。

Androidbye的博客 1052

鸿蒙5.0开发进阶:NDK开发-使用Node-API接口进行异步任务开发

napi_create_async_work是Node-API接口之一,用于创建一个异步工作对象。

Androidbye的博客 1126

鸿蒙5.0开发进阶:NDK开发-Node-API支持的数据类型和接口

是一个枚举数据类型,表示Node-API接口返回的状态信息

Androidbye的博客 1035

鸿蒙5.0&next开发【使用Node-API接口进行异步任务开发】NDK开发

napi_create_async_work是Node-API接口之一,用于创建一个异步工作对象。可以在需要执行耗时操作的场景中使用,以避免阻塞主线程,确保应用程序的性能和响应性能。

bbq的博客 1090

鸿蒙5.0&next开发【使用Node-API进行自定义异步操作相关开发】NDK开发

使用Node-API的自定义异步操作功能,可以使ArkTS的使用更加灵活和高效,可以处理那些可能阻塞事件循环的长时间运行任务,同时保持ArkTS应用的响应性和性能。

bbq的博客 872

鸿蒙5.0开发进阶:NDK开发-Node-API开发规范

Node-API开发规范.............

Androidbye的博客 773

鸿蒙5.0开发进阶:NDK代码开发-Node-API典型使用场景(使用扩展的Node-API接口在异步线程中运行和停止事件循环)

开发者在自己创建的ArkTS运行环境中调用异步的ArkTS接口时.....

Androidbye的博客 758

鸿蒙5.0开发进阶:NDK代码开发-使用Node-API实现跨语言交互(Node-API支持的数据类型和接口)

Node-API支持的数据类型和接口.................

Androidbye的博客 1129

鸿蒙5.0开发进阶:NDK代码开发-Node-API典型使用场景(使用Node-API接口从异步线程向ArkTS线程投递指定优先级和入队方式的的任务)

Node-API中的napi_call_threadsafe_function_with_priority接口的功能是从异步线程向ArkTS线程投递任务......

Androidbye的博客 717

鸿蒙5.0开发进阶:NDK代码开发-Node-API使用指南(使用Node-API接口关于其他实用工具)

Node-API接口提供了一些实用接口,可以帮助开发者更好地进行Node-API相关开发。

Androidbye的博客 634
上一篇: 鸿蒙5.0开发进阶:NDK代码开发-Node-API使用指南(使用Node-API接口创建和获取string值)
下一篇: 鸿蒙5.0开发进阶:NDK代码开发-Node-API典型使用场景(使用Node-API接口进行异步任务开发)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值