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

鸿蒙开发进阶(HarmonyOS)程序访问控制管理 Access Token Manager (程序访问控制管理工具,简称atm工具),是用于查询或设置应用进程的权限、使用类型等信息的工具,为开发者提供了根据tokenid、包名、进程名等信息进行访问控制管理的能力。 阅读详情

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


简介

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

基本概念

在使用Node-API接口进行class相关开发时,需要理解以下基本概念:

  • 类:类是用于创建对象的模板。它提供了一种封装数据和行为的方式,以便于对数据进行处理和操作。类在ArkTS中是建立在原型(prototype)的基础上的,并且还引入了一些类独有的语法和语义。
  • 实例:实例是通过类创建具体的对象。类定义了对象的结构和行为,而实例则是类的具体表现。通过实例化类,我们可以访问类中定义的属性和方法,并且每个实例都具有自己的属性值。

场景和功能介绍

以下Node-API接口主要用于处理class。他们的使用场景如下:

接口描述
napi_new_instance需要通过给定的构造函数构建一个实例时,可以使用这个函数。
napi_get_new_target使用此函数获取构造函数调用的new.target。
napi_define_class在Node-API模块定义与ArkTS类相对应的类。这个函数允许将Node-API模块类绑定到ArkTS类。
napi_wrap在ArkTS对象上绑定一个Node-API模块对象实例。这个函数通常在将Node-API模块对象与ArkTS对象进行绑定时使用,以便在ArkTS中使用本地对象的方法和属性。
napi_unwrap从ArkTS对象上获取之前绑定的Node-API模块对象实例。
napi_remove_wrap从ArkTS对象上获取之前绑定的Node-API模块对象实例,并解除绑定。

使用示例

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

napi_new_instance

通过给定的构造函数实例化一个对象,将这个对象返回ArkTS侧使用。

说明

参数constructor不是function类型则返回napi_function_expected。

cpp部分代码

static napi_value NewInstance(napi_env env, napi_callback_info info)
{
    // 传入并解析参数,第一个参数为传入的构造函数,第二个参数为需要传入构造函数的参数
    size_t argc = 2;
    napi_value args[2] = {nullptr};
    napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);
    // 调用napi_new_instance接口,实例化一个对象,将这个对象返回
    napi_value result = nullptr;
    napi_new_instance(env, args[0], 1, &args[1], &result);
    return result;
}

接口声明

// index.d.ts
export const newInstance: (obj: Object, param: string) => Object

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'
class Fruit {
  name: string;
  constructor(name: string) {
    this.name = name;
  }
}
// 调用函数,用变量obj接收函数返回的实例化对象
let obj = testNapi.newInstance(Fruit, 'test');
// 打印实例化对象obj的信息
hilog.info(0x0000, 'Node-API', 'napi_new_instance %{public}s', JSON.stringify(obj));

napi_get_new_target

用于获取构造函数的new.target值。在ArkTS中,new.target是一个特殊的元属性,用于在构造函数中判断是否通过new关键字调用了该构造函数。

napi_define_class

用于定义一个ArkTS类。该函数允许在Node-API模块中创建一个ArkTS类,并将类的方法和属性与相应的Node-API模块关联起来。

napi_wrap

在ArkTS object上绑定一个native对象实例。

说明

参数js_object不为object类型或function类型时返回napi_object_expected。

napi_unwrap

从一个被包装的对象中解除包装并获取与之关联的数据指针。

说明

参数js_object不为object类型或function类型时返回napi_object_expected。

napi_remove_wrap

从ArkTS object上获取先前绑定的native对象实例,并解除绑定。

说明

参数js_object不为object类型或function类型时返回napi_object_expected。

cpp部分代码

#include <hilog/log.h>
#include <string>
#include "napi/native_api.h"

struct Object {
    std::string name;
    int32_t age;
};

static void DerefItem(napi_env env, void *data, void *hint) {
    // 可选的原生回调,用于在ArkTS对象被垃圾回收时释放原生实例
    OH_LOG_INFO(LOG_APP, "Node-API DerefItem");
    (void)hint;
}

static napi_value Wrap(napi_env env, napi_callback_info info)
{
    OH_LOG_INFO(LOG_APP, "Node-API wrap");
    // 初始化Node-API模块的object
    struct Object *obj = new struct Object();
    obj->name = "lilei";
    obj->age = 18;
    size_t argc = 1;
    napi_value toWrap;
    // 调用napi_wrap将Node-API模块的object绑定到ArkTS object上
    napi_get_cb_info(env, info, &argc, &toWrap, NULL, NULL);
    napi_wrap(env, toWrap, reinterpret_cast<void *>(obj), DerefItem, NULL, NULL);

    return toWrap;
}

static napi_value RemoveWrap(napi_env env, napi_callback_info info)
{
    OH_LOG_INFO(LOG_APP, "Node-API removeWrap");
    size_t argc = 1;
    napi_value wrapped = nullptr;
    void *data = nullptr;
    // 调用napi_remove_wrap从一个被包装的对象中解除包装
    napi_get_cb_info(env, info, &argc, &wrapped, nullptr, nullptr);
    napi_remove_wrap(env, wrapped, &data);

    return nullptr;
}

static napi_value UnWrap(napi_env env, napi_callback_info info)
{
    OH_LOG_INFO(LOG_APP, "Node-API unWrap");
    size_t argc = 1;
    napi_value wrapped = nullptr;
    napi_get_cb_info(env, info, &argc, &wrapped, nullptr, nullptr);
    // 调用napi_unwrap取出绑定在ArkTS object中的数据并打印
    struct Object *data;
    napi_unwrap(env, wrapped, reinterpret_cast<void **>(&data));
    OH_LOG_INFO(LOG_APP, "Node-API name: %{public}s", data->name.c_str());
    OH_LOG_INFO(LOG_APP, "Node-API age: %{public}d", data->age);
    return nullptr;
}

接口声明

// index.d.ts
export const wrap: (obj: Object) => Object;
export const unWrap: (obj: Object) => void;
export const removeWrap: (obj: Object) => void;

ArkTS侧示例代码

import hilog from '@ohos.hilog'
import testNapi from 'libentry.so'
try {
    class Obj {}
    let obj: Obj = {};
    testNapi.wrap(obj)
    testNapi.unWrap(obj)
    testNapi.removeWrap(obj)
} catch (error) {
    hilog.error(0x0000, 'testTag', 'Test Node-API 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)

Godot引擎与HarmonyOS 5融合开发实战:从环境搭建到跨设备协同 跨平台游戏开发是当前互动应用领域的重要技术方向,其核心在于通过统一的代码库适配多种操作系统和设备,以降低开发成本并扩大用户覆盖。其原理通常基于渲染引擎抽象层和平台特定的后端实现,将游戏逻辑与底层系统API解耦。这一模式的技术价值在于,它允许开发者专注于创意和玩法,而将复杂的设备兼容性问题交由引擎和中间件处理,极大地提升了开发效率。在应用场景上,除了传统的PC、移动和主机平台,新兴的物联网和分布式操作系统为游戏和互动体验带来了设备协同与场景无缝流转的新可能。本文聚焦于将轻量、开源的Godot游戏引擎与Harm 阅读详情

相关推荐

鸿蒙与Flutter混合开发实践指南

跨平台开发框架Flutter以其高效的开发体验和良好的性能表现,成为移动应用开发的热门选择。而HarmonyOS作为新兴的分布式操作系统,正在快速构建其生态系统。混合开发技术结合了两者的优势,通过平台通道实现Flutter与原生系统的通信,既能复用Flutter的跨平台代码,又能调用HarmonyOS的原生能力。这种架构特别适合需要同时覆盖多平台并利用鸿蒙分布式特性的应用场景,如电商、社交等中大型项目。在实际工程实践中,合理配置开发环境、优化通信方案以及解决构建问题,是确保项目成功的关键因素。

weixin_30629653的博客 432

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

在使用Node-API接口时.........

Androidbye的博客 1241

Unity游戏移植鸿蒙实战:从环境搭建到性能优化的完整指南

跨平台游戏开发是现代游戏工程实践中的核心需求,它允许开发者使用同一套代码库构建面向多个操作系统和设备的应用程序。其技术原理主要依赖于游戏引擎提供的抽象层和平台特定的适配接口,通过中间件和工具链将核心逻辑与底层系统API解耦。这一技术方案的价值在于显著降低多平台维护成本,加速产品上市周期,并最大化潜在用户覆盖范围。在移动游戏领域,随着新兴操作系统生态的崛起,掌握成熟的跨平台移植流程成为开发者的关键竞争力。本文聚焦于将基于Unity引擎开发的游戏项目部署到华为鸿蒙操作系统的具体实践,详细拆解了环境配置、SDK集

weixin_33937913的博客 447

鸿蒙开发进阶(HarmonyOS)架构搭建-模块设计

模块化设计理是一种在多个领域广泛应用的设计思想,特别是在工程、软件开发、产品设计和建筑设计中。这一理念的核心是将复杂系统分解为多个相互独立、功能明确的模块,每个模块都可以单独设计、开发、测试和维护,最后再将这些模块组合起来形成一个完整系统题更容易被理解和解决。

adaedwa187545的博客 905

Godot引擎HarmonyOS支付与账号SDK开发实战:架构设计与安全实现

在移动应用开发中,应用内支付(IAP)和统一账号系统是支撑产品商业化的核心技术组件。其原理在于通过安全的授权与交易流程,连接用户、应用与支付渠道,实现数字商品与服务的变现。这项技术的核心价值在于为开发者提供了标准化的商业闭环解决方案,能有效提升用户支付体验、保障交易安全,并便于跨平台生态整合。典型的应用场景广泛覆盖游戏、工具软件及订阅服务等领域。本文聚焦于为跨平台游戏引擎Godot适配HarmonyOS生态,深入探讨如何通过三层桥接架构(Godot C++模块、JNI层、HarmonyOS服务层)解决引擎与

weixin_30634661的博客 399

Godot游戏集成HarmonyOS支付与账号SDK:GDExtension桥接实战

在跨平台游戏开发中,原生系统服务调用是连接游戏逻辑与平台生态的核心技术。其原理在于通过桥接层,将游戏引擎的脚本环境与操作系统的原生API进行通信,通常涉及JNI或Native API交互。这项技术的价值在于,它使开发者能够在不重写核心游戏逻辑的前提下,无缝接入平台的商业化、用户认证等关键能力,从而提升应用的变现效率和用户体验。在应用场景上,尤其适用于需要在特定操作系统(如HarmonyOS)上实现应用内购买、订阅服务或统一账号登录的游戏项目。本文以Godot引擎为例,详细阐述了如何通过GDExtension

weixin_30258901的博客 359

鸿蒙开发进阶(HarmonyOS)原生精致特性

在HarmonyOS的广阔生态中,六大原生特性——原生安全、原生精致、原生易用、原生智能、原生流畅与原生互联,共同构筑了系统独特的魅力。其中,“原生精致”作为提升用户体验的核心要素之一,对于开发一个优秀的HarmonyOS原生应用而言,其实现路径的精准把握尤为重要。本文旨在深入探讨如何巧妙实现HarmonyOS的“原生精致”,为用户带来前所未有的视觉与交互享受。

adaedwa187545的博客 1395

Cocos2d-x游戏引擎在HarmonyOS上的移植与开发实践

游戏引擎作为游戏开发的核心框架,其跨平台能力直接影响产品的多端部署效率。Cocos2d-x作为一款成熟的开源引擎,凭借其C++/Lua技术栈和模块化架构,在移动游戏开发领域广泛应用。其核心原理在于通过抽象层封装底层图形API和系统接口,实现一套代码多平台运行。在万物互联时代,HarmonyOS以其分布式架构和“一次开发、多端部署”理念,为游戏开发带来了新的技术价值——开发者可以更便捷地实现跨设备协同与资源共享。将Cocos2d-x与HarmonyOS结合,既能复用现有引擎生态和开发经验,又能利用Harmon

dieqiao8331的博客 320

鸿蒙开发实例|对象关系映射数据库

HarmonyOS应用数据管理不仅支持单设备的各种结构化数据的持久化,还支持跨设备之间数据的同步、共享及搜索功能,因此,开发者基于Harmony OS应用数据管理功能,能实现应用程序数据在不同终端设备之间的无缝衔接,从而保证用户在跨设备使用数据时所用数据的一致性。

不断学习,不断进步,提高自己 2226

QT-使用ECharts显示地图,还有更多惊艳的图表等待你的使用

QT-使用ECharts显示地图前言一、使用步骤1.下载示例2. QT使用HTML文件配置3.使用HTML文件4. 数据交互及自适应总结注意:这个地图是百度的在线地图,需要百度API密钥和在联网的状态下使用。离线使用图表 前言 我上文QT图表chart-饼状图,使用qt自带的图表库charts来显示图表,实现数据可视化,但是QT自带的图表库显示效果并不佳,通俗说,就是不好看。 然而,有这么一个开源图表库,图表种类极多,并且效果良好,能够实现具有很好的视觉冲击的数据可视化。 它就是Apache ECharts

博咯的博客 4901

保姆级教程:在STM32CubeIDE上快速部署micro_ros到STM32F407(附常见问题解决)

本文提供了一份详细的保姆级教程,指导开发者如何在STM32CubeIDE上快速部署micro_ros到STM32F407微控制器。内容涵盖从Windows与Ubuntu双环境搭建、micro-ROS静态库编译、STM32CubeIDE工程深度集成,到串口通信联调与常见问题解决的完整流程,旨在帮助读者构建稳定可靠的ROS2与嵌入式设备通信系统。

o4p5q6r7s的博客 324

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

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

Androidbye的博客 889

AI for Science:GNN预测分子性质全流程详解与工业实践

从分子表示到工业落地,一文掌握图神经网络在药物研发与材料设计中的核心实战近年来,的浪潮正深刻变革着传统科研范式。在药物研发与材料设计领域,作为核心环节,已从传统的实验试错转向基于图神经网络(GNN)的智能计算。本文将深入解析GNN预测分子性质的,涵盖数据准备、模型设计、训练优化到工业部署,并揭秘前沿技术与实战案例。

datacanvas2426的博客 1676

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

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

bbq的博客 401

从零开始构建量化价值投资多因子模型

量化价值投资多因子模型的构建目的在于通过系统性的方法,综合考虑多个影响股票价值的因素,以更准确地评估股票的投资价值,为投资者提供科学的投资决策依据。本模型的构建范围涵盖了从因子的选取、数据的处理、模型的建立到模型的评估和优化等一系列过程。通过对历史数据的分析和回测,验证模型的有效性和稳定性,进而应用于实际的投资组合管理中。本文将按照以下结构进行组织:首先介绍量化价值投资和多因子模型的相关背景知识,包括核心概念和联系;接着详细阐述核心算法原理和具体操作步骤,并给出Python代码示例;

AI天才研究院 1249

AI风控系统中的实时决策架构:架构师的关键设计

当用户点击「确认支付」时,一场毫秒级的“欺诈攻防战”正在后台悄然打响:系统需要在100ms内完成用户行为特征提取→欺诈模型推理→规则引擎校验→最终决策返回。这就是AI风控实时决策架构的核心——用技术对抗“实时化的欺诈手段”。本文将以「餐厅智能点餐系统」为类比,拆解实时风控架构的每一层逻辑:从“如何快速拿到用户的实时行为特征”(像服务员实时收集顾客的忌口),到“如何让模型和规则协同决策”(像厨师长结合菜谱和经验判断菜能不能做),再到“如何保证系统扛住大促的高并发”(像餐厅加桌子应对客流高峰)。我们会用。

2502_91592937的博客 1476

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

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

Davina_yu的博客 468

Linux内核vmlinuz文件:了解和编程

vmlinuz文件是Linux操作系统中的内核镜像文件。它包含了Linux内核的压缩版本,用于引导和启动操作系统。vmlinuz文件通常是一个zImage格式的压缩内核镜像,其中包含了操作系统所需的核心功能和驱动程序。vmlinuz文件的名称可能会因Linux发行版和版本而有所不同,但它们的作用是相同的。在某些发行版中,vmlinuz文件可能被重命名为vmlinux或bzImage。

PixelDyno的博客 1352

鸿蒙5.0&next开发【跨语言调用复杂参数传递开发】NDK开发

开发者为了提高程序运行效率,通常需要将一些运算量较大的内容放在C++环境中运行,因此经常需要进行ArkTS与C++之间的数据传递。本文以常见的五种数据类型:Array(uint8Array)、Object、HashMap、PixelMap、Class为例,向开发者介绍如何进行复杂参数的跨语言传递。

zhenggaoxiao232的博客 986

IgH EtherCAT 从入门到精通:第 4 章 网络设备驱动选型与配置

摘要:本章详细介绍了EtherCAT主站网络设备驱动的选型与配置。IgH EtherCAT Master提供Generic通用驱动和Native原生驱动两种方案:Generic驱动通过Linux Socket接口实现,兼容性强但实时性较差;Native驱动通过修改网卡驱动绕过内核协议栈,具有更低延迟和更小抖动。文章具体分析了e1000/e1000e/igb/igc等Intel网卡驱动以及r8169/8139too等Realtek驱动的配置方法,并提供了驱动选型建议。对于实时性要求高的场景,推荐使用Nativ

从事嵌入式linux android驱动开发,拥有全栈能力 305

深度强化学习在机器人控制中的应用

非常感谢您提供如此详细的任务要求和约束条件。作为一位世界级的人工智能专家和计算机领域大师,我将全身心投入到这篇技术博客的撰写中。 深度强化学习在机器人控制中的应用 1. 背景介绍 近年来,随着人工智能技术的飞速发展,深度学习和强化学习在各个领域都得到了广泛应用,尤其是在机器人

AI天才研究院 1326

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

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

weixin_30314793的博客 273

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

HarmonyOS 鸿蒙原生应用调用 C/C++ 三方库 —— NAPI 开发完整指南

本文系统介绍NAPI(Node-API)在HarmonyOS中的使用方法,帮助开发者实现ArkTS与C/C++代码的互操作。主要内容包括: NAPI核心概念:介绍napi_env、napi_value等关键概念及模块注册机制 开发环境配置:详细说明工程配置、CMake设置和类型声明 开发全流程:从函数编写、参数获取到类型转换和模块注册的完整步骤 数据类型转换:覆盖数值、字符串、布尔值、数组等类型的双向转换方法 实战指导:提供完整示例、API速查表、调试技巧和常见问题解决方案 文章强调NAPI在性能计算、复用

猫哥 的沉淀、积累、总结。天天学习,好好向上...c/c++,嵌入式 linux,Android,HarmonyOS,AIOT) 1217

RU DOS版、EFI版32bit/64bit BIOS常用工具

DOS版、EFI版的RU工具,可用来查看IO、MEM、PCI、SMBIOS等资源。亲测在EFI SHELL下可用。

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

面试题kkk

这篇文章摘要主要涵盖了Android开发中的核心知识点和技术难点,包括数据结构、Java与Kotlin语言特性、多线程与并发、内存管理、安卓组件与UI、IPC通信、数据库、多媒体处理、设计模式、性能优化、跨端开发等多个方面。文章详细解析了常见数据结构的使用与实现、JVM机制、内存泄漏分析与解决方案、Activity生命周期、事件分发机制、Handler原理、音视频处理、设计模式应用等核心内容,并提供了实际项目中的技术卡点与解决方案。此外,还涉及了性能优化策略、跨端开发差异、技术方案设计思路以及Git常用命令

mix39的博客 933

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

鸿蒙开发进阶(HarmonyOS )应用适配流程

适配流程包括:适配准备、应用适配、开发者自验证、应用上架和端到端验证。

m0_67143533的博客 1859

鸿蒙5.0开发进阶:编译构建-Hvigor守护进程

守护进程是作为后台进程运行而不是在交互式用户的直接控制下运行的计算机程序。

Androidbye的博客 996
上一篇: 鸿蒙5.0开发进阶:NDK开发-使用Node-API接口创建基本数据类型
下一篇: 鸿蒙5.0开发进阶:NDK开发-使用Node-API接口注册和使用环境清理钩子
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值