鸿蒙5.0开发进阶:NDK代码开发-Node-API典型使用场景(Native与ArkTS对象绑定)

鸿蒙HarmonyOS应用开发之Native与ArkTS对象绑定 通过napi_wrap将ArkTS对象与Native的C++对象绑定,后续操作时再通过将ArkTS对象绑定的C++对象取出,并对其进行操作。 阅读详情

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


Native与ArkTS对象绑定

场景介绍

通过napi_wrap将ArkTS对象与Native的C++对象绑定,后续操作时再通过napi_unwrap将ArkTS对象绑定的C++对象取出,并对其进行操作。

使用示例

  1. 接口声明、编译配置以及模块注册

    接口声明

    // index.d.ts
    export class MyObject {
       constructor(arg: number);
       plusOne: () => number;
    
       public get value();
       public set value(newVal: number);
    }

    编译配置

    # the minimum version of CMake.
    cmake_minimum_required(VERSION 3.5.0)
    project(napi_wrap_demo)
    
    set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})
    
    if(DEFINED PACKAGE_FIND_FILE)
        include(${PACKAGE_FIND_FILE})
    endif()
    
    include_directories(${NATIVERENDER_ROOT_PATH}
                        ${NATIVERENDER_ROOT_PATH}/include)
    
    add_definitions("-DLOG_DOMAIN=0x0000")
    add_definitions("-DLOG_TAG=\"testTag\"")
    
    add_library(entry SHARED napi_init.cpp)
    target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so)

    模块注册

    // napi_init.cpp
    #include "napi/native_api.h"
    #include "hilog/log.h"
    
    class MyObject {
     public:
      static napi_value Init(napi_env env, napi_value exports);
      static void Destructor(napi_env env, void* nativeObject, void* finalize_hint);
    
     private:
      explicit MyObject(double value_ = 0);
      ~MyObject();
    
      static napi_value New(napi_env env, napi_callback_info info);
      static napi_value GetValue(napi_env env, napi_callback_info info);
      static napi_value SetValue(napi_env env, napi_callback_info info);
      static napi_value PlusOne(napi_env env, napi_callback_info info);
    
      double value_;
      napi_env env_;
      napi_ref wrapper_;
    };
    
    static thread_local napi_ref g_ref = nullptr;
    
    MyObject::MyObject(double value)
        : value_(value), env_(nullptr), wrapper_(nullptr) {}
    
    MyObject::~MyObject()
    {
      napi_delete_reference(env_, wrapper_);
    }
    
    void MyObject::Destructor(napi_env env,
                              void* nativeObject,
                              [[maybe_unused]] void* finalize_hint)
    {
      OH_LOG_INFO(LOG_APP, "MyObject::Destructor called");
      delete reinterpret_cast<MyObject*>(nativeObject);
    }
    
    napi_value MyObject::Init(napi_env env, napi_value exports)
    {
      napi_property_descriptor properties[] = {
          { "value", 0, 0, GetValue, SetValue, 0, napi_default, 0 },
          { "plusOne", nullptr, PlusOne, nullptr, nullptr, nullptr, napi_default, nullptr }
      };
    
      napi_value cons;
      napi_define_class(env, "MyObject", NAPI_AUTO_LENGTH, New, nullptr, 2,
                               properties, &cons);
    
      napi_create_reference(env, cons, 1, &g_ref);
      napi_set_named_property(env, exports, "MyObject", cons);
      return exports;
    }
    
    EXTERN_C_START
    static napi_value Init(napi_env env, napi_value exports)
    {
        MyObject::Init(env, exports);
        return exports;
    }
    EXTERN_C_END
    
    static napi_module nativeModule = {
        .nm_version = 1,
        .nm_flags = 0,
        .nm_filename = nullptr,
        .nm_register_func = Init,
        .nm_modname = "entry",
        .nm_priv = nullptr,
        .reserved = { 0 },
    };
    
    extern "C" __attribute__((constructor)) void RegisterObjectWrapModule()
    {
        napi_module_register(&nativeModule);
    }
  2. 在构造函数中绑定ArkTS与C++对象

    napi_value MyObject::New(napi_env env, napi_callback_info info)
    {
      OH_LOG_INFO(LOG_APP, "MyObject::New called");
    
      napi_value newTarget;
      napi_get_new_target(env, info, &newTarget);
      if (newTarget != nullptr) {
        // 使用`new MyObject(...)`调用方式
        size_t argc = 1;
        napi_value args[1];
        napi_value jsThis;
        napi_get_cb_info(env, info, &argc, args, &jsThis, nullptr);
    
        double value = 0.0;
        napi_valuetype valuetype;
        napi_typeof(env, args[0], &valuetype);
        if (valuetype != napi_undefined) {
          napi_get_value_double(env, args[0], &value);
        }
    
        MyObject* obj = new MyObject(value);
    
        obj->env_ = env;
        // 通过napi_wrap将ArkTS对象jsThis与C++对象obj绑定
        napi_status status = napi_wrap(env,
                                       jsThis,
                                       reinterpret_cast<void*>(obj),
                                       MyObject::Destructor,
                                       nullptr,  // finalize_hint
                                       &obj->wrapper_);
        // napi_wrap失败时,必须手动释放已分配的内存,以防止内存泄漏
        if (status != napi_ok) {
          OH_LOG_INFO(LOG_APP, "Failed to bind native object to js object"
                      ", return code: %{public}d", status);
          delete obj;
          return jsThis;
        }
        // 从napi_wrap接口的result获取napi_ref的行为,将会为jsThis创建强引用,
        // 若开发者不需要主动管理jsThis的生命周期,可直接在napi_wrap最后一个参数中传入nullptr,
        // 或者使用napi_reference_unref方法将napi_ref转为弱引用。
        uint32_t refCount = 0;
        napi_reference_unref(env, obj->wrapper_, &refCount);
    
        return jsThis;
      } else {
        // 使用`MyObject(...)`调用方式
        size_t argc = 1;
        napi_value args[1];
        napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);
    
        napi_value cons;
        napi_get_reference_value(env, g_ref, &cons);
        napi_value instance;
        napi_new_instance(env, cons, argc, args, &instance);
    
        return instance;
      }
    }
  3. 将ArkTS对象之前绑定的C++对象取出,并对其进行操作

    napi_value MyObject::GetValue(napi_env env, napi_callback_info info)
    {
      OH_LOG_INFO(LOG_APP, "MyObject::GetValue called");
    
      napi_value jsThis;
      napi_get_cb_info(env, info, nullptr, nullptr, &jsThis, nullptr);
    
      MyObject* obj;
      // 通过napi_unwrap将jsThis之前绑定的C++对象取出,并对其进行操作
      napi_unwrap(env, jsThis, reinterpret_cast<void**>(&obj));
      napi_value num;
      napi_create_double(env, obj->value_, &num);
    
      return num;
    }
    
    napi_value MyObject::SetValue(napi_env env, napi_callback_info info)
    {
      OH_LOG_INFO(LOG_APP, "MyObject::SetValue called");
    
      size_t argc = 1;
      napi_value value;
      napi_value jsThis;
    
      napi_get_cb_info(env, info, &argc, &value, &jsThis, nullptr);
    
      MyObject* obj;
      // 通过napi_unwrap将jsThis之前绑定的C++对象取出,并对其进行操作
      napi_unwrap(env, jsThis, reinterpret_cast<void**>(&obj));
      napi_get_value_double(env, value, &obj->value_);
    
      return nullptr;
    }
    
    napi_value MyObject::PlusOne(napi_env env, napi_callback_info info)
    {
      OH_LOG_INFO(LOG_APP, "MyObject::PlusOne called");
    
      napi_value jsThis;
      napi_get_cb_info(env, info, nullptr, nullptr, &jsThis, nullptr);
    
      MyObject* obj;
      // 通过napi_unwrap将jsThis之前绑定的C++对象取出,并对其进行操作
      napi_unwrap(env, jsThis, reinterpret_cast<void**>(&obj));
      obj->value_ += 1;
      napi_value num;
      napi_create_double(env, obj->value_, &num);
    
      return num;
    }
  4. ArkTS侧示例代码

    import hilog from '@ohos.hilog';
    import { MyObject } from 'libentry.so';
    
    let object : MyObject = new MyObject(0);
    object.value = 1023;
    hilog.info(0x0000, 'testTag', 'MyObject value after set: %{public}d', object.value);
    hilog.info(0x0000, 'testTag', 'MyObject plusOne: %{public}d', object.plusOne());

HarmonyOS Next开发学习手册——Node-API扩展能力接口 扩展能力接口 进一步扩展了Node-API的功能,提供了一些额外的接口,用于在Node-API模块中与ArkTS进行更灵活的交互和定制,这些接口可以用于创建自定义ArkTS对象等场景。Node-API接口开发流程参考使用Node-API实现跨语言交互开发流程,本文仅对接口对应C++及ArkTS相关代码进行展示。 阅读详情

相关推荐

HarmonyOS核心知识点:使用NDK接口构建UI(接入ArkTS页面)

ArkUI开发框架提供了一系列NDK接口,能够在应用中使用C和C++代码构建UI界面,这些接口包括UI组件创建、UI树操作、属性设置和事件监听等。面向通用UI界面开发场景,建议使用ArkTS代码和ArkUI声明式开发框架。需要使用UI组件树控制接口来动态创建和挂载UI组件,方便实现自身UI开发框架的系统桥接。进一步提升UI界面性能,细粒度控制组件的创建和属性设置,以降低延迟、处理极高UI负载。重复使用自己或其他开发者的C或C++UI库。布局布局是UI的必要元素,定义了组件在界面中的大小位置。

wuliusan5的博客 900

对象包装object-wrap

..// 调用napi_create_double方法把 C++类型转换成 napi_value 类型// 返回 napi_value 类型return sum;但是对于一些复杂的数据类型(如我们常用C++的类对象),是不能直接返回一个napi_value数据的。这时我们需要对这些数据进行一系列操作后将其导出,这样JS才能使用导出后的对象。// JS侧对C++侧的类进行实例化// 调用类的实例对象上的操作方法。

Hens_Hello_Mr的博客 1330

鸿蒙5.0进阶开发:UI开发-自定义渲染 (XComponent)

XComponent组件作为一种渲染组件,可用于EGL/OpenGLES和媒体数据写入..........

AyomQAQ的博客 1272

鸿蒙5.0&next开发【Native与ArkTS对象绑定】NDK开发

通过`napi_wrap`将ArkTS对象与Native的C++对象绑定,后续操作时再通过`napi_unwrap`将ArkTS对象绑定的C++对象取出,并对其进行操作。

bbq的博客 351

VS2022离线安装包 - 下载安装教程

VS2022离线安装包 - 下载安装教程

鲤籽鲲的博客 3万+

国产平替NeuroSky?实测金牛座TGAM脑电模块,从Arduino到Python的完整数据采集指南

本文详细介绍了国产金牛座TGAM脑电模块的完整使用流程,包括硬件连接、数据采集和Python分析。通过Arduino和Python的实战案例,展示了如何从脑电波传感器获取并解析专注度、放松度等数据,适用于专注力训练和脑机接口开发。

weixin_30735745的博客 579

三方库移植之NAPI开发[4]异步调用:Callback&Promise

以下图片为个人总结,可以在文末下载清晰的图片

maniuT的博客 1700

《寻秦OL》.ani动画逆向解析:二进制结构与Unity重实现

动画文件格式是游戏资源逆向的核心入口,其本质是一组按特定规则组织的二进制数据流。理解魔数识别、字节序、字段对齐与差分编码等底层原理,是解析非标准格式的关键前提。技术价值在于绕过黑盒协议,直接从静态客户端提取可验证的原始语义;典型应用场景包括老游戏复刻、美术资产抢救、引擎跨平台迁移及教学级逆向训练。本文以《寻秦OL》的`.ani`文件为实例,深入剖析其C风格结构布局、GB2312中文命名、16位定点数旋转表示及帧主序差分存储机制,并基于C#在Unity中完成从字节流到AnimationClip的端到端重建,覆

weixin_30368981的博客 644

鸿蒙5.0开发进阶:NDK代码开发-Node-API典型使用场景(Native与Sendable ArkTS对象绑定)

通过napi_wrap_sendable将Sendable ArkTS对象与Native的C++对象绑定........

Androidbye的博客 763

光谱分布、光谱辐射通量密度与不同时间段分布光谱(图示)

1、光谱分布图 2 太阳辐射能量图 3、不同时间段的太阳分布光谱图 4、不同波长的光的能量分布主要区域 5、不同波段的使用场景

maopig的专栏 2万+

Understanding Lockup Cells

工具会分析扫描链和EDT逻辑之间的控制时序元素的时钟的时序关系,当必须要同步时钟并保持数据完整性时插入边沿触发寄存器(lockup cells)。可以使用report_edt_lockup_cells命令来展示工具已经插入的lockup cells的详细报告。

weixin_44954910的博客 1083

鸿蒙5.0开发进阶:NDK开发-使用Node-API进行class相关开发

使用Node-API接口进行class相关开发,处理ArkTS中的类,例如定义类、构造实例等。

Androidbye的博客 1044

精益六西格玛Python数字化应用开发-Day18 应用场景:家电企业生产效率优化

本文将重点介绍专门针对精益六西格玛黑带使用场景的 Python 库,这些库功能侧重于数据分析和流程优化,特别适用于 DMAIC 方法论和看板管理。考虑到读者具备中高级Python 使用经验,我们将深入探讨各库的高级功能和实际应用应用场景。 某家电企业生产线自动化程度高,数据量巨大,希望通过精益管理提升生产效率。企业借助 Python 脚本,打通各类数据源(MES、ERP、设备日志),自动归集生产数据,分析各工序的生产节拍、设备停机、效率损失,快速定位瓶颈环节

m0_56592100的博客 906

鸿蒙5.0开发实战案例:使用NDK接口构建UI(接入ArkTS页面)

ArkUI开发框架提供了一系列NDK接口,能够在应用中使用C和C++代码构建UI界面,这些接口包括UI组件创建、UI树操作、属性设置和事件监听等。面向通用UI界面开发场景,建议使用ArkTS代码和ArkUI声明式开发框架。需要使用UI组件树控制接口来动态创建和挂载UI组件,方便实现自身UI开发框架的系统桥接。进一步提升UI界面性能,细粒度控制组件的创建和属性设置,以降低延迟、处理极高UI负载。重复使用自己或其他开发者的C或C++UI库。布局布局是UI的必要元素,定义了组件在界面中的大小位置。

liudiaosi6的博客 1360

10、高阶ΣΔ调制器设计与优化

本文深入探讨了高阶ΣΔ调制器的设计与优化技术,重点介绍了NTF零点优化方法,通过分散单位圆上的零点分布提升信噪失真比(SQNR)。文章分析了量化噪声耦合技术如何有效提高噪声整形阶数,并对比了CIFB、CIFF、CRFB和CRFF等不同架构的性能特点。同时,详细阐述了基于稳定性与性能权衡的设计流程,结合Schreier的Delta-Sigma Toolbox实现NTF综合与仿真验证。内容涵盖从理论推导到实际设计步骤,为高阶ΣΔ调制器的稳定性提升与性能优化提供了系统性指导。

tgb345678的博客 135

SAP_SD模块_SAP 消息号VF501(科目确定期间出错)

摘要: SAP SD模块中执行VF02销售开票时出现“科目确定期间出错”(VF501)问题,主要原因是系统无法找到匹配的总账科目。解决方案包括:检查物料主数据和客户主数据中的科目分配组是否维护,核对发票中的对应字段,并通过VKOA事务代码分析科目确定逻辑。若定价过程中配置的科目代码(如Z01)未在VKOA中完整映射(如缺少H1+S5+Z01组合),则会导致内部价格无法关联总账科目。需在SPRO路径下完善科目代码分配配置,确保定价类型与科目代码匹配。本文提供了详细的排查步骤和配置方法,帮助解决开票过账错误。

我小时候很黑的博客 360

鸿蒙5.0开发进阶:NDK代码开发-Node-API使用指南(使用Node-API进行class相关开发)

使用Node-API接口进行class相关开发,处理ArkTS中的类,例如定义类、构造实例等。

Androidbye的博客 889

efm32 入门.pdf

本PDF共计22页,介绍的是操作驱动API,下载与否自己斟酌。

NDK开发:在鸿蒙中使用Native API(51)

在鸿蒙(HarmonyOS)生态中,NDK(Native Development Kit)是官方提供的一套 Native API、编译脚本及工具链集合,旨在帮助开发者使用 C/C++ 语言实现应用的关键功能。

Davina_yu的博客 468

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

OV9734 DATASHEET,完整规格书

OV9734完整规格书,包括电气参数,尺寸规格,寄存器配置表等

鸿蒙5.0&next开发【Native侧实现文件访问开发】NDK开发

在对文件处理性能要求高的场景中,Native侧访问文件处理数据比在[ArkTS侧操作文件]有更高的效率和更快的响应,例如处理大文件、复杂的文件操作以及实时通信等低时延场景。根据文件位置的不同,应用在Native侧访问文件可以分为以下三种类型:

zhenggaoxiao232的博客 1286

最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版

Part-E1-SDIO-Specification-Ver4.00-Final-120220.pdf:最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版,包括SDIO 接口的外设,SDIO 接口官方协议等。

鸿蒙5.0开发进阶:NDK代码开发-Node-API使用指南(使用Node-API接口关联数据,使其生命周期与当前环境的生命周期相关联)

在Node-API模块中,我们可以使用Node-API接口将特定数据与当前的环境相关联,并在需要时检索该数据。

Androidbye的博客 334

在鸿蒙 PC 上用 Rust 写一个 2048:ArkTS 负责界面,Rust 负责灵魂

鸿蒙应用的主力语言是 ArkTS(声明式 UI,类 TypeScript)。但很多场景下,我们希望把核心逻辑游戏规则、状态机这类纯逻辑,用 Rust 写既安全又好测,还能脱离 UI 单独跑单元测试;同一份 Rust 逻辑未来可复用到其它平台;鸿蒙提供 N-API(Node-API)桥接,ohos.rs把 napi-rs 适配到了鸿蒙,让 Rust 函数可以像 C++ native 模块一样被 ArkTSimport。逻辑层:纯 Rust,编译为cdylib,导出一个Game类。桥接。

DecorateCC的博客 5585

鸿蒙5.0&next开发【使用Node-API进行class相关开发】NDK开发

使用Node-API接口进行class相关开发,处理ArkTS中的类,例如定义类、构造实例等。

bbq的博客 401

鸿蒙开发语言选择指南:ArkTS、Java与C++的应用场景解析

在移动应用开发领域,编程语言的选择直接影响开发效率、应用性能和生态适配。从技术原理看,不同语言在类型系统、运行时机制和内存管理上各有特点,这决定了它们在不同场景下的技术价值。TypeScript以其静态类型检查提升了代码可靠性,而Java凭借成熟的虚拟机生态在系统服务层保持优势,C/C++则在驱动开发和性能敏感场景中不可替代。在鸿蒙应用开发中,ArkTS作为TypeScript的超集,深度融合了声明式UI范式,为现代化应用开发提供了高效解决方案;Java主要服务于存量Android应用迁移和系统级开发;C/

weixin_30700977的博客 380

鸿蒙5.0开发进阶:UI框架-自定义渲染 (XComponent)

目前XComponent组件在type设置为“surface”时主要有两个应用场景。

Androidbye的博客 1836

鸿蒙5.0版开发:ArkUI框架开发-自定义渲染 (XComponent)

XComponent组件作为一种渲染组件,可用于EGL/OpenGLES和媒体数据写入..........

m0_73088370的博客 1662

鸿蒙NDK实战:JSVM-API桥接WebAssembly实现高性能计算

WebAssembly(Wasm)是一种为高性能计算设计的二进制指令格式,它允许C/C++、Rust等语言编译成可在多种环境中安全、高效运行的字节码。其核心原理是提供接近原生速度的沙箱化执行环境,通过线性内存模型和精简指令集实现跨平台性能优化。在移动应用开发中,尤其在处理图像渲染、音视频编解码、物理模拟等计算密集型任务时,Wasm能有效突破JavaScript引擎的性能瓶颈。鸿蒙(HarmonyOS)的JSVM-API为原生层与JavaScript引擎提供了交互通道,结合NDK(Native Develop

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值