【HarmonyOS NEXT应用开发】案例56：基于HAR的跨模块C++头文件引用

场景描述

多个模块使用同一份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);

...

}