【鸿蒙开发】OpenHarmony与HarmonyOS调用C/C++教程

一.概述

ArkTs应用开发时,涉及到性能敏感场景、需要复用已有的C/C++库的场景以及需要针对CPU特性进行专项定制库的开发时,通常都需要调用C/C++,鸿蒙给出的解决方案有两个:通过第三方模块NAPI或者AKI来实现ArkTs调用C/C++编译出来的库,根据OpenHarmony与HarmonyOS的不同调用使用的方法也有差异,总体架构如下:

下面将分别介绍NAPI和AKI调用C/C++库的方法。

二.(NAPI方法)HarmonyOS实现ArkTS跨语言调用C/C++

ArkTS和C++之间的交互流程,主要分为以下两步:

|-----------------------------------------------------------------------------------------------------------------------------|
| 初始化阶段:当ArkTS侧在import一个Native模块时,ArkTS引擎会调用ModuleManager加载模块对应的so及其依赖。首次加载时会触发模块的register,将模块定义的方法属性挂载到exports对象上并返回该对象。 |
| 调用阶段:当ArkTS侧通过上述import返回的对象调用方法时,ArkTS引擎会找到并调用对应的C/C++方法。 |

交互流程如下:

首先是创建Native C++工程,在DevEco Studio中New > Create Project,选择Native C++模板,点击Next,选择API版本,设置好工程名称,点击Finish,新建项目选择"Native C++":

进行一些简单的配置,不知道怎么选就全部按照默认配置:

基本的工程结构如下:

在项目路径:\entry\src\main\cpp\napi_init.cpp下用C++写的demo函数add:

接着是NAPI初始化函数:

再来是构造器和注册器:

在路径:/ entry/src/main/cpp/types/libentry/oh-package.json5中将index.d.ts与cpp文件关联起来:

在路径:/ entry/src/main/cpp/types/libentry/ Index.d.ts中记录导出的接口函数(作用类似头文件):

在路径:/ entry/src/main/cpp/types/CamkeList.txt中配置Cmake打包参数:

介绍完NAPI侧,我们在介绍ArkTs侧调用C++接口的方法,在路径:/ entry/src/main/ets/pages/Index.ets下通过import引入Native侧包含处理逻辑的so来使用C/C++的方法:

三.(AKI方法)HarmonyOS实现ArkTS跨语言调用C/C++

AKI针对HarmonyOS上提供ArkTS与C/C++跨语言互调的场景提供解决方案,提供了极简语法糖使用方式,一行代码完成ArkTS与C/C++的无障碍跨语言互调,所见即所得。同时开发者无需关心Node-API的线程安全问题、Native对象GC问题,为开发者屏蔽Node-API内部复杂逻辑。

首先需要安装OHPM HAR包依赖,在指定路径下(例如:项目根路径/entry),输入以下命令安装ohpm har包依赖。

在CMakeLists.txt中添加依赖,假设编译的动态库名为libentry.so

在napi_init.cpp文件中定义业务,并将业务接口导出给 ArkTS:

注:注册的AKI插件名需与模块级 oh-package.json5 文件中 dependencies 标签下的 "lib<AKI插件名>" 字段名称一致。例如,libentry.so

在"src/main/cpp/types/libentry/index.d.ts"中导出 .so 文件的接口:

在ArkTS文件中调用.so文件中的接口:

四.HarmonyOS转换OpenHarmony的教程

由于鸿蒙编译器新建项目默认是HarmonyOS工程,如果想要从HarmonyOS转换成OpenHarmony,请执行以下操作:

|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 第一步:请在工程级 build-profile.json5 文件添加compileSdkVersion字段。 |
| 第二步:将compatibleSdkVersion、compileSdkVersion、targetSdkVersion(若有)字段赋值为对应的SDK版本号数值类型。 |
| 第三步:将runtimeOS从"HarmonyOS"修改为**"OpenHarmony"** |
| 第四步:单击Sync Now进行同步。在Sync Check弹窗中点击Yes,同意将module.json5/config.json文件中的phone切换为OpenHarmony支持的default类型,并删除在OpenHarmony不适用的其他设备类型,同步成功无其他报错则工程创建完成。 |
| 第五步:在Native模块的build-profile.json5文件buildOption/externalNativeOptions字段下,新增abiFilters字段并赋值为"armeabi-v7a"。(注: HarmonyOS 不支持该架构,仅OpenHarmony 支持 |
| 最后:重新同步既可。 |

相关推荐
TrisighT1 天前
AI写埋点代码,35%覆盖率坑惨运营
harmonyos·arkts·arkui
Junerver4 天前
把 DevEco Code 的 HarmonyOS 开发能力装进口袋——harmonyos-dev-skill
harmonyos
程序猿追5 天前
那个右下角的小数字怎么“卡”住我打字——我用 HarmonyOS 自己写了一个字数限制输入框
pytorch·华为·harmonyos
古德new5 天前
鸿蒙PC使用electron迁移:Joplin Electron 桌面适配全记录
华为·electron·harmonyos
世人万千丶5 天前
桌面便签小应用 - HarmonyOS ArkUI 开发实战-TextArea与Flex布局-PC版本
华为·harmonyos·鸿蒙·鸿蒙系统
慧海灵舟5 天前
AGenUI 鸿蒙端实战踩坑录:从 Column 布局消失到异步组件宽度为 0
华为·harmonyos
yuegu7775 天前
HarmonyOS应用<节气通>开发第33篇:状态管理实战
华为·harmonyos
YM52e5 天前
买菜计算器小应用 - HarmonyOS ArkUI 开发实战-PC版本
学习·华为·harmonyos·鸿蒙·鸿蒙系统
阿捏利5 天前
系列总览-鸿蒙科普系列完全指南
华为·harmonyos
小雨下雨的雨5 天前
HarmonyOS ArkUI训练营入门-组件掌握系列-Animation 动画效果实现-PC版本
学习·华为·harmonyos·鸿蒙