HarmonyOS Next开发学习手册——Native与ArkTS对象绑定

于 2024-07-29 14:04:34 发布
阅读量263 收藏 5
点赞数 3
分类专栏： 移动开发 鸿蒙开发 HarmonyOS 文章标签： harmonyos 学习 pytorch 组件化开发 ArkTS Native 移动开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/maniuT/article/details/140769782
版权
移动开发 同时被 3 个专栏收录
956 篇文章 9 订阅
订阅专栏
HarmonyOS
871 篇文章 13 订阅
订阅专栏
鸿蒙开发
504 篇文章 1 订阅
订阅专栏

场景介绍

通过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);
}

编译配置

// CMakeLists.txt
# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(object_wrap)

set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})

include_directories(${NATIVERENDER_ROOT_PATH}
                    ${NATIVERENDER_ROOT_PATH}/include)

add_definitions("-DLOG_DOMAIN=0x0000")
add_definitions("-DLOG_TAG=\"testTag\"")

add_library(object_wrap SHARED object_wrap.cpp)
target_link_libraries(object_wrap PUBLIC libace_napi.z.so libhilog_ndk.z.so)

模块注册

// object_wrap.cpp
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");
  reinterpret_cast<MyObject*>(nativeObject)->~MyObject();
}

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;
  assert(napi_define_class(env, "MyObject", NAPI_AUTO_LENGTH, New, nullptr, 2,
                           properties, &cons) == napi_ok);

  assert(napi_create_reference(env, cons, 1, &g_ref) == napi_ok);
  assert(napi_set_named_property(env, exports, "MyObject", cons) == napi_ok);
  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 = "object_wrap",
    .nm_priv = nullptr,
    .reserved = { 0 },
};

extern "C" __attribute__((constructor)) void RegisterObjectWrapModule()
{
    napi_module_register(&nativeModule);
}

2.在构造函数中绑定ArkJS与C++对象

napi_value MyObject::New(napi_env env, napi_callback_info info)
{
  OH_LOG_INFO(LOG_APP, "MyObject::New called");

  napi_value newTarget;
  assert(napi_get_new_target(env, info, &newTarget) == napi_ok);
  if (newTarget != nullptr) {
    // 使用`new MyObject(...)`调用方式
    size_t argc = 1;
    napi_value args[1];
    napi_value jsThis;
    assert(napi_get_cb_info(env, info, &argc, args, &jsThis, nullptr) == napi_ok);

    double value = 0.0;
    napi_valuetype valuetype;
    assert(napi_typeof(env, args[0], &valuetype) == napi_ok);
    if (valuetype != napi_undefined) {
      assert(napi_get_value_double(env, args[0], &value) == napi_ok);
    }

    MyObject* obj = new MyObject(value);

    obj->env_ = env;
    // 通过napi_wrap将ArkTS对象jsThis与C++对象obj绑定
    assert(napi_wrap(env,
                     jsThis,
                     reinterpret_cast<void*>(obj),
                     MyObject::Destructor,
                     nullptr,  // finalize_hint
                     &obj->wrapper_) == napi_ok);

    return jsThis;
  } else {
    // 使用`MyObject(...)`调用方式
    size_t argc = 1;
    napi_value args[1];
    assert(napi_get_cb_info(env, info, &argc, args, nullptr, nullptr) == napi_ok && argc == 1);

    napi_value cons;
    assert(napi_get_reference_value(env, g_ref, &cons) == napi_ok);
    napi_value instance;
    assert(napi_new_instance(env, cons, argc, args, &instance) == napi_ok);

    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;
  assert(napi_get_cb_info(env, info, nullptr, nullptr, &jsThis, nullptr) == napi_ok);

  MyObject* obj;
  // 通过napi_unwrap将jsThis之前绑定的C++对象取出，并对其进行操作
  assert(napi_unwrap(env, jsThis, reinterpret_cast<void**>(&obj)) == napi_ok);
  napi_value num;
  assert(napi_create_double(env, obj->value_, &num) == napi_ok);

  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;

  assert(napi_get_cb_info(env, info, &argc, &value, &jsThis, nullptr) == napi_ok);

  MyObject* obj;
  // 通过napi_unwrap将jsThis之前绑定的C++对象取出，并对其进行操作
  assert(napi_unwrap(env, jsThis, reinterpret_cast<void**>(&obj)) == napi_ok);
  assert(napi_get_value_double(env, value, &obj->value_) == napi_ok);

  return nullptr;
}

napi_value MyObject::PlusOne(napi_env env, napi_callback_info info)
{
  OH_LOG_INFO(LOG_APP, "MyObject::PlusOne called");

  napi_value jsThis;
  assert(napi_get_cb_info(env, info, nullptr, nullptr, &jsThis, nullptr) == napi_ok);

  MyObject* obj;
  // 通过napi_unwrap将jsThis之前绑定的C++对象取出，并对其进行操作
  assert(napi_unwrap(env, jsThis, reinterpret_cast<void**>(&obj)) == napi_ok);
  obj->value_ += 1;
  napi_value num;
  assert(napi_create_double(env, obj->value_, &num) == napi_ok);

  return num;
}

4.ArkTS侧示例代码

import hilog from '@ohos.hilog';
import { MyObject } from 'libobject_wrap.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）学习路线与学习文档用来跟着学习是非常有必要的。

针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。

本路线共分为四个阶段：

第一阶段：鸿蒙初中级开发必备技能

在这里插入图片描述

第二阶段：鸿蒙南北双向高工技能基础：gitee.com/MNxiaona/733GH

第三阶段：应用开发中高级就业技术

第四阶段：全网首发-工业级南向设备开发就业技术：gitee.com/MNxiaona/733GH

《鸿蒙 (Harmony OS)开发学习手册》（共计892页）

如何快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

开发基础知识:gitee.com/MNxiaona/733GH

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

基于ArkTS 开发

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

鸿蒙开发面试真题（含参考答案）:gitee.com/MNxiaona/733GH

鸿蒙入门教学视频：

美团APP实战开发教学：gitee.com/MNxiaona/733GH

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
  • 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
  • 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新学习资源，请移步前往小编：gitee.com/MNxiaona/733GH

OpenHarmony_小贾
关注
  • 3
    点赞
  • 踩
  • 5
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
从零开始的HarmonyOS Next开发指南：打造HarmonyOS NEXT元服务
一键难忘的博客
05-26 5022
DevEco Studio 4.0是一个集成开发环境（IDE），专门为开发者提供一站式的HarmonyOS应用和服务开发支持。以下是DevEco Studio 4.0的一些主要特点：高效智能代码编辑：支持多种语言，如ArkTS、JavaScript、C/C++等，提供代码高亮、智能补齐、错误检查、自动跳转、格式化、查找等功能，以提升代码编写的效率。低代码可视化开发：拥有丰富的UI界面编辑能力，支持自由拖拽组件和可视化数据绑定，能够快速预览效果，所见即所得。
鸿蒙HarmonyOS应用开发之Native与ArkTS对象绑定
maniuT的博客
03-27 835
通过napi_wrap将ArkTS对象与Native的C++对象绑定，后续操作时再通过将ArkTS对象绑定的C++对象取出，并对其进行操作。
vue slider组件
07-12
vue slider组件，适合初学者。npm install安装，再根据属性进行配置
HarmonyOS Next开发学习手册——旋转屏动画增强
最新发布
maniuT的博客
07-03 579
在原旋转屏动画基础上，可配置渐隐和渐现的转场效果。完整的代码示例和效果如下。需要在EntryAbility.ets文件的onWindowStageCreate方法中添加处理逻辑以获取屏幕的显示方向需要在项目的 module.json5 文件中的 abilities 列表里添加 “orientation”，指定为 “auto_rotation”
基于动态配置签名的多人协同开发应用签名解决方案
hongxiaomeng的博客
06-04 436
如何获取对方的IP地址
热门推荐
wuli1024的博客
01-15 1万+
在互联网中，我们经常需要与其他人进行远程通信，如聊天、视频等。而要实现这些功能，我们需要知道对方的IP地址才能建立起连接。
5.21 marquee组件
qq_63202674的博客
05-21 334
跑马灯组件，用于展示一段单行滚动的文字。 支持设备 手机 平板 智慧屏 智能穿戴 支持 支持 支持 支持 子组件 不支持。 属性 除支持通用属性外，还支持如下属性： 名称 类型 默认值 必填 描述 .
鸿蒙HarmonyOS应用开发之Native与ArkTS对象绑定_鸿蒙@ohos
2401_84182073的博客
04-14 698
/ 通过napi_unwrap将jsThis之前绑定的C++对象取出，并对其进行操作。// 通过napi_unwrap将jsThis之前绑定的C++对象取出，并对其进行操作。// 通过napi_unwrap将jsThis之前绑定的C++对象取出，并对其进行操作。
全网首发黑马程序员鸿蒙 HarmonyOS NEXT星河版零基础入门到实战，零基础也能快速入门鸿蒙开发教程2
05-16
《全网首发黑马程序员鸿蒙 HarmonyOS NEXT星河版零基础入门到实战》是一套针对初学者精心设计的鸿蒙操作系统开发教程。本教程旨在帮助没有编程基础的学员快速掌握HarmonyOS的开发技能，通过丰富的实例和清晰的讲解，...
HarmonyOS移动应用学习笔记——2.HarmonyOS开发工具DevEco Studio安装
WMX_0121的博客
03-02 1万+
HarmonyOS开发工具DevEco Studio安装及运行环境配置
vue-stepper:Vue步进器组件将与Vuex和Vue Router一起使用
03-06
步进式 Vue步进器组件将与Vuex和Vue Router一起使用 安装： npm install @ricadesign/vue-stepper 用法 import Stepper from '@ricadesign/vue-stepper' Vue . use ( Stepper , { store , routes } ) < rica> </ rica> 样式： @import ' ~@ricadesign/vue-stepper/dist/stepper ' ; 您可以传递以下颜色道具来设置步进器样式。 当同时使用原色和辅助色时，将显示背景渐变。 Struts 类型 原色 细绳 二次色 细绳 待定文本颜色 细绳 完成文字颜色 细绳 图像路线也可以通过。 步骤完成后，它将显示而不是数字： Struts 类型 图像 细绳
黑马程序员HarmonyOS4+NEXT星河版入门到企业级实战教程，一套精通鸿蒙应用开发41-50
06-29
黑马程序员HarmonyOS4+NEXT星河版入门到企业级实战教程，一套精通鸿蒙应用开发41-50
slider组件
weixin_30877181的博客
05-27 657
　　slider组件，是一个强大的滑动选择器组件； 　　　　属性： 　　　　　　min：类型　　数字　　滑动选择器的（范围）最小值 　　　　　　max：类型　　数字　　滑动选择器的（范围）最大值 　　　　　　step：类型　　数字　　步长（滑一次走的距离） 取值必须大于0且必须（max-min）整除 　　　　　　disabled：类型　　布尔　　是否禁用 　　　　　　value：类型...
鸿蒙Harmony应用开发—ArkTS声明式开发（基础手势：Slider）
m0_64420071的博客
03-12 1241
ArkTS声明式开发（基础手势：Slider）
【鸿蒙软件开发】文本显示（Text/Span）
m0_62599305的博客
10-23 2978
Text是文本组件，通常用于展示用户的视图，如显示文章的文字。具体用法可参考Text。通过textAlign属性设置文本对齐样式。Text('左对齐')Text('中间对齐')Text('右对齐')textAlign属性设置即可文本显示Text/Span。
鸿蒙Harmony应用开发—ArkTS声明式开发（容器组件：ListItem）
m0_64420071的博客
03-15 1517
ArkTS声明式开发（容器组件：ListItem）
[HarmonyOS]——滑块组件(Slider)
weixin_42067873的博客
08-27 1030
一、滑块基础 滑块组件（Slider），其父类是AbsSlider，AbsSlider的父类是ProgressBar，所以归根到底滑块组件其实也就是一个进度条 音量调节、读书进度、视频进度等都是滑块组件的应用。 1、基础属性 enabled：滑块能否被滑动 background_instruct_element：总进度的背景颜色 progress_color：已完成部分的颜色 thumb_element：设置滑块的颜色 vice_progress：次一级的进度，比如电影的缓冲...
canvas笔记--Path2D篇
qq_44758643的博客
09-23 3034
Path2D对象 Path2() Path2()可使用最新版本的浏览器中的对象来缓存或记录这些绘图命令。您可以快速播放路径。 Path2D()构建函数返回一个新实例化的Path2D对象任意的与另一条路径作为参数（创建一个副本）或任选的用有一串svg路径数据 new Path2D(); //空路径对象 new Path2D(path); // 从另一个Path2D对象复制 new Path2D(d); // SVG路径数据中的路径 实例演示： 创建一个矩形和一个圆两者存储为path2D对象，以
HarmonyOS NEXT
06-25
HarmonyOS NEXT，也称为鸿蒙操作系统，是华为自主研发的面向全场景的分布式操作系统。它最初是为了应对智能手机市场变化，特别是面对谷歌服务受限的情况而开发的。HarmonyOS NEXT强调了三个核心特点： 1. **统一性**：HarmonyOS旨在提供一个跨设备、跨平台的统一体验，包括手机、智能穿戴、智能家居等各类终端设备，用户界面和操作逻辑更加一致。 2. **模块化**：系统架构采用微内核设计，允许各组件独立升级，提高系统的灵活性和安全性。 3. **分布式能力**：利用分布式技术，HarmonyOS可以实现不同设备之间的无缝协同，数据共享和实时通信。 此外，HarmonyOS NEXT还支持自定义引擎（HMS Core）和开源生态，鼓励开发者构建创新应用和服务。它正逐渐成为一个开放、安全、智能的物联网操作系统平台。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值