鸿蒙5.0开发进阶:NDK开发-使用Node-API接口进行线程安全开发

鸿蒙HarmonyOS应用开发之使用Node-API接口进行线程安全开发 napi_create_threadsafe_function是Node-API接口之一,用于创建一个线程安全的JavaScript函数。主要用于在多个线程之间共享和调用,而不会出现竞争条件或死锁。例如以下场景:异步计算:如果需要进行耗时的计算或IO操作,可以创建一个线程安全的函数,将计算或IO操作放在另一个线程中执行,避免阻塞主线程,提高程序的响应速度。数据共享:如果多个线程需要访问同一份数据,可以创建一个线程安全的函数,确保数据的读写操作不会发生竞争条件或死锁等问题。 阅读详情

往期鸿蒙全套实战文章必看:


场景介绍

napi_create_threadsafe_function是Node-API接口之一,用于创建一个线程安全的JavaScript函数。主要用于在多个线程之间共享和调用,而不会出现竞争条件或死锁。例如以下场景:

  • 异步计算:如果需要进行耗时的计算或IO操作,可以创建一个线程安全的函数,将计算或IO操作放在另一个线程中执行,避免阻塞主线程,提高程序的响应速度。

  • 数据共享:如果多个线程需要访问同一份数据,可以创建一个线程安全的函数,确保数据的读写操作不会发生竞争条件或死锁等问题。

  • 多线程编程:如果需要进行多线程编程,可以创建一个线程安全的函数,确保多个线程之间的通信和同步操作正确无误。

使用示例

  1. 在Native入口定义线程安全函数。

    struct CallbackData {
        napi_threadsafe_function tsfn;
        napi_async_work work;
    };
    
    static napi_value StartThread(napi_env env, napi_callback_info info)
    {
        size_t argc = 1;
        napi_value jsCb = nullptr;
        CallbackData *callbackData = nullptr;
        napi_get_cb_info(env, info, &argc, &jsCb, nullptr, reinterpret_cast<void **>(&callbackData));
    
        // 创建一个线程安全函数
        napi_value resourceName = nullptr;
        napi_create_string_utf8(env, "Thread-safe Function Demo", NAPI_AUTO_LENGTH, &resourceName);
        napi_create_threadsafe_function(env, jsCb, nullptr, resourceName, 0, 1, callbackData, nullptr, 
            callbackData, CallJs, &callbackData->tsfn);
    
        // 创建一个异步任务
        napi_create_async_work(env, nullptr, resourceName, ExecuteWork, WorkComplete, callbackData,
            &callbackData->work);
    
        // 将异步任务加入到异步队列中
        napi_queue_async_work(env, callbackData->work);
        return nullptr;
    }
  2. 在工作线程中调用ExecuteWork,并执行线程安全函数。

    static void ExecuteWork(napi_env env, void *data)
    {
        CallbackData *callbackData = reinterpret_cast<CallbackData *>(data);
        std::promise<std::string> promise;
        auto future = promise.get_future();
        napi_call_threadsafe_function(callbackData->tsfn, &promise, napi_tsfn_nonblocking);
        try {
            auto result = future.get();
            // OH_LOG_INFO(LOG_APP, "XXX, Result from JS %{public}s", result.c_str());
        } catch (const std::exception &e) {
            // OH_LOG_INFO(LOG_APP, "XXX, Result from JS %{public}s", e.what());
        }
    }
  3. 在JS线程执行异步回调函数。

    static napi_value ResolvedCallback(napi_env env, napi_callback_info info)
    {
        void *data = nullptr;
        size_t argc = 1;
        napi_value argv[1];
        if (napi_get_cb_info(env, info, &argc, argv, nullptr, &data) != napi_ok) {
            return nullptr;
        }
        size_t result = 0;
        char buf[32] = {0};
        napi_get_value_string_utf8(env, argv[0], buf, 32, &result);
        reinterpret_cast<std::promise<std::string> *>(data)->set_value(std::string(buf));
        return nullptr;
    }
    
    static napi_value RejectedCallback(napi_env env, napi_callback_info info)
    {
        void *data = nullptr;
        if (napi_get_cb_info(env, info, nullptr, nullptr, nullptr, &data) != napi_ok) {
            return nullptr;
        }
        reinterpret_cast<std::promise<std::string> *>(data)->set_exception(
            std::make_exception_ptr(std::runtime_error("Error in jsCallback")));
        return nullptr;
    }
    
    static void CallJs(napi_env env, napi_value jsCb, void *context, void *data)
    {
        if (env == nullptr) {
            return;    
        }
        napi_value undefined = nullptr;
        napi_value promise = nullptr;
        napi_get_undefined(env, &undefined);
        napi_call_function(env, undefined, jsCb, 0, nullptr, &promise);
        napi_value thenFunc = nullptr;
        if (napi_get_named_property(env, promise, "then", &thenFunc) != napi_ok) {
            return;
        }
        napi_value resolvedCallback;
        napi_value rejectedCallback;
        napi_create_function(env, "resolvedCallback", NAPI_AUTO_LENGTH, ResolvedCallback, data,
                             &resolvedCallback);
        napi_create_function(env, "rejectedCallback", NAPI_AUTO_LENGTH, RejectedCallback, data,
                             &rejectedCallback);
        napi_value argv[2] = {resolvedCallback, rejectedCallback};
        napi_call_function(env, promise, thenFunc, 2, argv, nullptr);
    }
  4. 任务执行完成后,进行资源清理回收。

    static void WorkComplete(napi_env env, napi_status status, void *data)
    {
        CallbackData *callbackData = reinterpret_cast<CallbackData *>(data);
        napi_release_threadsafe_function(callbackData->tsfn, napi_tsfn_release);
        napi_delete_async_work(env, callbackData->work);
        callbackData->tsfn = nullptr;
        callbackData->work = nullptr;
    }
  5. 模块初始化以及ArkTS侧调用接口。

    // 模块初始化
    static napi_value Init(napi_env env, napi_value exports) {
        CallbackData *callbackData = new CallbackData(); // 可在线程退出时释放
        napi_property_descriptor desc[] = {
            {"startThread", nullptr, StartThread, nullptr, nullptr, nullptr, napi_default, callbackData},
        };
        napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
        return exports;
    }
    
    // ArkTS侧调用接口
    import nativeModule from 'libentry.so'; // 通过import的方式,引入Native能力
    
    let callback = (): Promise<string> => {
      return new Promise((resolve) => {
        setTimeout(() => {
            resolve("string from promise");
          }, 5000);
        });
     }
     nativeModule.startThread(callback);

napi_threadsafe_function 和 napi_async_work对比分析 从用法和官方介绍角度来看,napi_threadsafe_function 和 napi_async_work 似乎是两个完全不相同的两个东西,但从源码分析他们实现的原理,是有很大重合度。以至于使用场景亦有重合的地方。读前须知uv_async_send、uv_async_init、uv_queue_work 具体用法和作用。napi_async_work 系列 API 具体用法和作用。线程安全函数 API 具体用法和作用。 阅读详情

相关推荐

线程安全函数(thread safe function)

跨线程数据 data 引用指向的实际地址,不能随着 other 线程结束而被销毁。

Hens_Hello_Mr的博客 2180

利用native的方式实现跨线程调用

在OpenHarmony应用开发实践中,经常会遇到一些耗时的任务,如I/O操作、域名解析以及复杂计算等。这些任务如果直接在主线程中执行,将会严重阻塞主线程,影响后续任务的正常流程,进而导致用户界面响应延迟甚至卡顿。因此,为了提升代码性能,通常会将这类耗时任务放在子线程中执行。本文将聚焦于如何利用native的方式实现跨线程调用,即采用线程安全函数和libuv异步I/O工具库这两种策略,来优化程序性能并保持流畅的用户体验。

1 1451

【HarmonyOS NEXT】如何通过NAPI napi_call_threadsafe_function接口实现跨线程获取数据

1、调用napi_create_threadsafe_function方法,注入线程安全的方法callProxyFunction。3、在B线程中调用napi_call_threadsafe_function(callProxySafeThreadHandle, params, napi_tsfn_nonblocking),其中params参数就是植入自定义数据的地方。项目中需要对接一个C++库,这个库的所有处理逻辑都在它的子线程里,并不在NAPI的主线程,因此涉及到跨线程的问题。

Mayism123的博客 2267

鸿蒙5.0开发进阶:NDK代码开发-Node-API典型使用场景(使用Node-API接口进行线程安全开发)

napi_create_threadsafe_function是Node-API接口之一,用于创建一个线程安全的JavaScript函数。

Androidbye的博客 499

鸿蒙HarmonyOS 6 NDK渲染节点开发实战与优化

现代移动端UI渲染技术正从高级框架抽象向底层管线控制演进,这种转变使开发者能更精确地控制渲染流程。鸿蒙HarmonyOS 6的NDK层渲染节点架构通过C API暴露了类似游戏引擎的场景图管理能力,支持变换矩阵、裁剪区域等底层操作。这种技术突破特别适用于需要60fps高性能渲染的场景,如金融图表、实时可视化等。通过节点复用、异步绘制等优化手段,开发者可以显著提升复杂UI的性能。在实际工程中,合理使用材质引用管理、线程安全访问等特性,能够避免常见的内存泄漏和性能陷阱。

weixin_34067102的博客 415

oscp备考,oscp系列——Djinn3靶场:ssti漏洞,pkexec提权

oscp备考,oscp系列——Djinn3靶场:ssti漏洞,pkexec提权难度简单偏上对于低权限shell获取涉及:ssti漏洞对于提权:pkexec提权。

2202_75361164的博客 636

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

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

Androidbye的博客 1035

PMF5.0计算

EPA PMF5.0 计算步骤

nuistsy的博客 4546

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

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

Androidbye的博客 1129

Windows防火墙服务异常修复指南:0x80070422与0x6D9报错实战处理

本文针对Windows防火墙服务异常导致的0x80070422与0x6D9报错,提供了从基础到进阶的实战修复指南。核心是通过services.msc服务管理器检查并修复Windows Firewall服务,包括设置启动类型、检查依赖服务等关键步骤。同时介绍了当基础方法失效时,如何使用命令行工具、系统文件检查器(SFC/DISM)以及排查组策略与第三方软件冲突等深度解决方案,帮助用户彻底解决防火墙服务无法启动或访问的问题。

m9n0o的博客 543

集群路径规划实战(一)之EGO-swarm环境搭建与调试

本文详细介绍了EGO-swarm分布式无人机集群运动规划系统的仿真环境搭建与调试全流程。内容涵盖ROS Melodic安装、代码获取、依赖库配置、编译问题解决(如multi_map_server头文件缺失)以及最终通过roslaunch启动集群仿真与Rviz可视化,为学习和研究集群路径规划算法提供了可运行的实战平台。

weixin_29243279的博客 251

鸿蒙(API 12 Beta2版)NDK开发【使用Node-API接口进行线程安全开发】

napi_create_threadsafe_function是Node-API接口之一,用于创建一个线程安全的JavaScript函数。主要用于在多个线程之间共享和调用,而不会出现竞争条件或死锁。

鸿蒙的技术博客 928

VGA系列之一:VGA显示网络图片

VGA系列之一:VGA显示网络图片VGA系列之一VGA显示网络图片 1 如何用FPGA实现VGA显示 2 网络图片和VGA显示有何区别 3VGA如何显示图片

善良の一休君的博客 1万+

鸿蒙5.0开发进阶:NDK代码开发-Node-API典型使用场景(使用Node-API调用返回值为promise的ArkTS方法)

当ArkTS的返回值为promise...........

Androidbye的博客 725

Zynq远程更新程序实战:从emmc到flash的完整方案解析

本文详细解析了Zynq远程更新程序的完整方案,重点探讨了从emmc到flash的实战操作。通过硬件连接限制破解、emmc配置技巧、flash擦写策略优化等关键技术点,提供了可靠的远程更新解决方案,特别适合需要频繁更新boot.bin的应用场景。

weixin_29163797的博客 180

SAP S/4HANA Public Cloud 配置全景实践

本文提供SAP S/4HANA Public Cloud配置的实用指南,重点介绍三大核心工具:CBC(范围界定与配置)、SAP Activate(方法论与路线图)和Cloud ALM(项目执行与运维)。文章详解了不同系统架构(2SL/3SL)的配置路径,并以制造企业案例说明端到端实施流程。同时提供了工具协同操作方法、初始访问安全建议和常见问题的专家意见,帮助项目团队高效完成实施工作。

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 565

鸿蒙5.0&next开发【使用Node-API接口进行线程安全开发】NDK开发

napi_create_threadsafe_function是Node-API接口之一,用于创建一个线程安全的JavaScript函数。主要用于在多个线程之间共享和调用,而不会出现竞争条件或死锁。

bbq的博客 826

国家自然基金研究方向选定后,关键词只能下拉吗?——不是的,国家自然科学基金(NSFC)的关键词并不是只能下拉选择,而是:[特殊字符] “可选 + 可填”的混合模式(但以规范词为主)

你可以手动输入关键词用于表达新兴方向或细分领域✔ 适用情况:新概念(如“电场调控纳米流体”)交叉领域(如“电流体力学传热耦合”)电场调控电流体力学可以自己填,但必须以系统标准关键词为主,自定义为辅如果你愿意,我可以帮你做一件更关键的事:👉根据你题目,反向设计“最容易中标”的关键词组合 + 学科代码搭配这个比写内容本身还更影响送审质量。你可以手动输入关键词用于表达新兴方向或细分领域✔ 适用情况:新概念(如“电场调控纳米流体”)交叉领域(如“电流体力学传热耦合”)电场调控电流体力学。

qq_15963745的博客 82

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

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

Androidbye的博客 851

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

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

ssm框架搭建

这个是一个在idea上成功跑起来的ssm框架项目,保存在这里方便以后使用直接下载

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

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

Androidbye的博客 717

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

鸿蒙5.0&next开发【Node-API支持的数据类型和接口】NDK开发

是一个枚举数据类型,表示Node-API接口返回的状态信息。 每当调用一个Node-API函数,都会返回该值,表示操作成功与否的相关信息。

bbq的博客 1083

lwip-2.0.3

lwip是瑞典计算机科学院(SICS)的Adam Dunkels 开发的一个小型开源的TCP/IP协议栈。实现的重点是在保持TCP协议主要功能的基础上减少对RAM 的占用。

5【鸿蒙/OpenHarmony/NDK】应用太卡?用 Node-API 异步任务解决:从卡顿根源到流畅方案

鸿蒙NDK异步处理开发指南 本文聚焦鸿蒙NDK开发中的异步处理技术,解析核心概念、应用场景与避坑要点。异步处理通过避免主线程阻塞,保障应用流畅性,适用于文件操作、网络请求等耗时场景。文章结合Node-API开发规范,强调四个关键避坑点: execute回调禁止使用JS环境变量; complete回调仅做结果转换,避免耗时操作; 动态内存需严格遵循申请-传递-释放流程; 异步任务删除须在complete回调后执行。 附官方文档与系列教程链接,帮助开发者系统掌握NDK异步编程。

最简示例破局!基础用法秒会,深层原理不绕弯。 1183

HarmonyOS NDK 开发:冲破 ArkUI 性能桎梏的“降维打击”

好不容易把 UI 抠得像仙女下凡,结果业务逻辑里掺进了一个复杂的图像处理算法,或者一个深不见底的递归计算。如果你在 UI 线程里调用了一个耗时 5 秒的 C++ 加密算法,恭喜你,你的应用界面会纹丝不动地卡死 5 秒。今天,老司机带你掀开 ArkUI 的引擎盖,看看如何把原生的 C/C++ 代码塞进鸿蒙应用里。其实剥开外壳,它的本质非常朴素。机制,将你的调用请求序列化,然后经由 N-API 桥接层传递给底层的 C++ 运行时。,关于 NDK 开发,有几个极其重要的底层变动,提前了解能帮你省下大把踩坑时间。

Jack20的博客 1万+

鸿蒙5.0&next开发【使用Node-API调用返回值为promise的ArkTS方法】NDK开发

当ArkTS的返回值为promise,开发者可以按照以下方式在自己创建的ArkTS运行环境中调用异步的ArkTS接口。

bbq的博客 902

鸿蒙 ndk开发之页面渲染 C/C++ 库组件

本文介绍了在鸿蒙系统中通过Native Development Kit(NDK)实现ArkTS与C/C++原生UI组件混合开发的技术方案。主要内容包括:1)在ArkTS中创建ContentSlot占位容器和NodeContent桥梁对象;2)通过Node-API建立ArkTS与C++的通信机制;3)在Native侧获取NDK UI能力并创建组件树;4)提供进阶封装方案,包括组件基类管理、具体组件封装和UI树构建。该方案支持高性能渲染和现有原生库复用,需注意线程安全、生命周期管理和CMake配置等关键点。

梦想不只是梦与想的博客 691

鸿蒙5.0&next开发【libuv】 公共基础能力

[libuv]是一个跨平台库,基于事件驱动来实现异步I/O,适用于网络编程和文件系统操作。它是Node.js的核心库之一,也被其他语言的开发者广泛使用。

鸿蒙的技术博客 806
上一篇: 鸿蒙5.0开发进阶:NDK开发-使用Node-API接口进行异步任务开发
下一篇: 鸿蒙5.0开发进阶:NDK开发-Native与ArkTS对象绑定
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值