基于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);
  ...
}