【鸿蒙实战开发】基于HAR的跨模块C++头文件引用

CTrup

已于 2024-09-11 17:39:11 修改

阅读量758

点赞数 8

分类专栏：移动开发鸿蒙开发 HarmonyOS 文章标签： harmonyos c++ 移动开发组件化鸿蒙开发 ArkUI HAR

于 2024-09-11 17:02:25 首次发布

本文链接：https://blog.csdn.net/CTrup/article/details/142144829

版权

鸿蒙开发同时被 3 个专栏收录

512 篇文章 5 订阅

订阅专栏

移动开发

501 篇文章 4 订阅

订阅专栏

HarmonyOS

441 篇文章 0 订阅

订阅专栏

往期知识点整理

场景描述

多个模块使用同一份C++代码是App开发中很常见的问题，比如多个模块使用同一个自研的加解密库、集成三方开源SO库暴露其中的C++代码等。以下列举跨调用C++方法的典型场景：

场景：模块A引用模块B的C++接口

方案描述：

如图所示，通过5个步骤实现，desHar引用srcHar的C++接口：

源码及详细说明：

1、将需要导出的C++头文件放至srcHar模块下的固定目录

首先需要在srcHar/src/main/cpp目录下新建include目录

// srcHar/src/main/cpp/include/test.h

// 此处将头文件放置include目录下

int add(int a,int b)

2、在srcHar模块的build-profile.json5中配置C++头文件的目录

// srcHar/build-profile.json5

{

"apiType": "stageMode",

"buildOption": {

"nativeLib": {

"headerPath": "src/main/cpp/include"

},

"externalNativeOptions": {...},

},

"buildOptionSet": [...],

"targets": [...]

}

使用add_library将test.cpp内的C++代码打到名称为srcHar的so库中。

// srcHar/src/main/cpp/CMakeLists.txt

add_library(srcHar SHARED test.cpp)

注意事项：SHARED前面是srcHar中对外导出的的so库名称。

3、在desHar的oh-package.json5中声明依赖

// desHar/oh-package.json5

{

"name": "deshar",

"version": "1.0.0",

"description": "Please describe the basic information.",

"main": "Index.ets",

"author": "",

"license": "Apache-2.0",

"dependencies": {

"libdesHar.so": "file:./src/main/cpp/types/libdesHar",

"srcHar": "file:../srcHar"

}

}

4、在desHar的CMakeLists.txt声明so库的依赖


// desHar/src/main/cpp/CMakeLists.txt

target_link_libraries(deshar PUBLIC libace_napi.z.so srchar::srcHar)

注意事项：双冒号前面指的是srcHar/oh-package.json5配置中的name，双冒号后面跟着的是步骤2中srcHar中对外导出的的so库名称，名称必须要一致

5、在desHar的cpp源码中使用 srcHar提供的C++方法


// desHar/src/main/cpp/xxx.cpp

# include 'test.h'

// 此处是在Native模块的默认Add方法中验证

static napi_value Add(){

...

napi_create_double(env, add(value0,value1), &sum);

...

}

总是有很多小伙伴反馈说：鸿蒙开发不知道学习哪些技术？不知道需要重点掌握哪些鸿蒙开发知识点？ 为了解决大家这些学习烦恼。在这准备了一份很实用的鸿蒙全栈开发学习路线与学习文档给大家用来跟着学习。

针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植……等）技术知识点。