在大型应用开发中,应用通常会分为多个业务模块,业务模块常会以HSP或HAR包的形式提供SDK能力,这些SDK往往会提供Native接口给HAP模块的Native层直接调用,从而实现应用的复杂功能。而如何在Native侧跨HAR/HSP模块进行接口调用,是开发者经常遇到的问题。本文将介绍Native侧跨HAR/HSP模块调用两种典型场景,包括调用Native方法和调用ArkTS方法,以方便开发者更好的掌握Native侧跨模块调用的能力。
如图1所示,Native侧跨HAR/HSP模块调用原理主要包括以下步骤。
在Module1(HAP)模块中,ArkTS侧通过Node-API调用Native接口。
Module1(HAP)模块Native侧调用Module2(HSP/HAR)模块Native方法。
在Module2(HSP/HAR)模块中,Native侧通过Node-API接口进行模块加载,从而调用ArkTS方法。
图 1 Native侧跨HAR/HSP模块调用原理图

如下图所示,Native侧跨HAR/HSP模块调用Native方法的调用链路为Module1 ArkTS -> Module1 Native -> Module2 Native。在HarmonyOS项目中,Native侧跨模块调用Native方法实际就是C++侧调用,需要配置编译链接依赖。Native侧跨HAR/HSP模块调用Native方法实现的关键是在Module2(HSP/HAR)模块的build-profile.json5中,配置头文件导出,并在CMakeLists.txt中进行配置,将源文件配置到so中。
图 2 Native侧跨HAR/HSP模块调用Native方法

Native侧跨HAR/HSP模块调用Native方法时,需要实现Module1(HAP)的ArkTS侧调用Module1(HSP/HAR)的Native侧、Module1(HAP)的Native侧调用Module2(HSP/HAR)的Native侧。在当前场景下,跨模块调用HAR模块和HSP模块的方式相同,当前以跨模块调用HAR模块为例,详细流程如下所示。
开发者需要创建Module2(HAR)模块staticModule,详细创建流程可以参考创建HAR模块。
在Module2中新建C++文件napi_har.cpp,再新建其头文件napi_har.h,并定义Native方法。
napi_har.cpp代码如下所示。
#include "napi/native_api.h"
#include "napi_har.h"
double harNativeAdd(double a, double b) {
return a + b;
} napi_har.h代码如下所示。
#ifndef CROSSMODULEREFERENCE_NAPI_HAR_H #define CROSSMODULEREFERENCE_NAPI_HAR_H #include <js_native_api_types.h> // ... double harNativeAdd(double a, double b); napi_value harArkTSAdd(double a, double b); #endif
在Module2中的build-profile.json5中配置头文件导出。如果不做当前headerPath的配置,会导致Module1引用不到Module2的头文件。
{
"apiType": "stageMode",
"buildOption": {
"externalNativeOptions": {
"path": "./src/main/cpp/CMakeLists.txt",
"arguments": "",
"cppFlags": "",
"abiFilters": ["x86_64", "arm64-v8a"]
},
"nativeLib": {
"headerPath": "./src/main/cpp"
},
// ...
} 在Module2的CMakeLists.txt中配置将源文件打包到so。
# staticModule\src\main\cpp\CMakeLists.txt add_library(add SHARED napi_init.cpp napi_har.cpp)
在Module2模块创建后,需要在Module1的oh-package.json5文件中配置对应的依赖。如下所示,staticModule为新创建的HAR模块的文件名,static_module为HAR模块的名称。
{
"name": "entry",
"version": "1.0.0",
"description": "Please describe the basic information.",
"main": "",
"author": "",
"license": "",
"dependencies": {
"libentry.so": "file:./src/main/cpp/types/libentry",
"static_module": "file:../staticModule",
// ...
}
} 在Module1中的CMakeLists.txt中配置so依赖。
static_module::add中第一个参数static_module是module2的模块名称,第二个参数add是module2编译出来的so名称(不需要带上lib)。默认情况下,module2的模块名称与so名称相同,为了方便说明,在本案例中将so名称修改成了add。
# entry\src\main\cpp\CMakeLists.txt target_link_libraries(entry PUBLIC libace_napi.z.so static_module::add shared_module::calc)
在Module1的napi_init.cpp中导入Module2的头文件napi_har.h,并调用harNativeAdd()方法。
在Module1的Native侧调用Module2的invokeHarNative()方法。
static napi_value invokeHarNative(napi_env env, napi_callback_info info)
{
size_t argc = 2;
napi_value args[2] = {nullptr};
napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
napi_valuetype valuetype0;
napi_typeof(env, args[0], &valuetype0);
napi_valuetype valuetype1;
napi_typeof(env, args[1], &valuetype1);
double value0;
napi_get_value_double(env, args[0], &value0);
double value1;
napi_get_value_double(env, args[1], &value1);
napi_value sum;
napi_create_double(env, harNativeAdd(value0, value1), &sum);
return sum;
} 在Module1的ArkTS侧调用Native侧的invokeHarNative()方法。
Button($r('app.string.call_har_native_method'))
.fontSize(16)
.width('100%')
.margin({ top: 12 })
.onClick(() => {
this.getUIContext().getPromptAction().showToast({
message: 'HarNative method call succeed, result is ' + napi.invokeHarNative(2, 3).toString()
});
}) 如下图所示,Native侧跨HAR/HSP模块调用ArkTS方法是Native侧跨HAR/HSP模块调用Native方法的基础上调用ArkTS方法。其关键是在Module2中获取Module1中的上下文napi_env,并根据上下文napi_env加载模块、调用对应的ArkTS方法。
图 4 Native侧跨HAR/HSP模块调用ArkTS方法

Native侧跨HAR/HSP模块调用ArkTS方法具体实现方法如下所示。
在完成Native侧跨HAR/HSP模块调用Native方法后,在Module1中新增invokeHarArkTS()方法以准备调用HAR模块的ArkTS方法。
在Module2的Native侧,新增setHarEnv()方法,用以传递napi_env,并在头文件中进行配置,代码如下所示。
napi_har.h代码如下所示。
#ifndef CROSSMODULEREFERENCE_NAPI_HAR_H #define CROSSMODULEREFERENCE_NAPI_HAR_H #include <js_native_api_types.h> napi_env g_main_env; void setHarEnv(napi_env env); double harNativeAdd(double a, double b); napi_value harArkTSAdd(double a, double b); #endif
napi_har.cpp代码如下所示。
void setHarEnv(napi_env env) {
g_main_env = env;
} 在Module1中的napi_init.cpp中的Init()方法中调用setHarEnv()方法将Module1中的napi_env传递到Module2中。
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
napi_property_descriptor desc[] = {
{ "add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr },
{ "invokeHarNative", nullptr, invokeHarNative, nullptr, nullptr, nullptr, napi_default, nullptr },
{ "invokeHarArkTS", nullptr, invokeHarArkTS, nullptr, nullptr, nullptr, napi_default, nullptr },
{ "invokeHspNative", nullptr, invokeHspNative, nullptr, nullptr, nullptr, napi_default, nullptr },
{ "invokeHspArkTS", nullptr, invokeHspArkTS, nullptr, nullptr, nullptr, napi_default, nullptr }
};
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
setHarEnv(env);
// ...
return exports;
}
EXTERN_C_END 在Module2中创建ArkTS方法,提供给Module2的Native侧调用。
export function add(a: number, b: number): number {
return a + b;
} 在Module2模块的build-profile.json5文件中进行以下配置。
{
"apiType": "stageMode",
"buildOption": {
// ...
"arkOptions" : {
"runtimeOnly" : {
"sources": [
"./src/main/ets/utils/Util.ets"
]
}
}
},
// ...
} 在Module2的Native侧调用ArkTS方法,并配置到头文件中。详细步骤如下所示。
napi_har.cpp代码如下所示。
napi_value harArkTSAdd(double a, double b) {
napi_env env = g_main_env;
napi_value module;
napi_status status = napi_load_module_with_info(env, "static_module/src/main/ets/utils/Util", "com.example.crossmodulereference/entry", &module);
if (napi_ok != status) {
return 0;
}
napi_value addFunc;
napi_get_named_property(env, module, "add", &addFunc);
napi_value addResult;
napi_value argv[2] = {nullptr, nullptr};
napi_create_double(env, a, &argv[0]);
napi_create_double(env, b, &argv[1]);
napi_call_function(env, module, addFunc, 2, argv, &addResult);
return addResult;
} 在module1的Native侧调用module2的harArkTSAdd()方法。
static napi_value invokeHarArkTS(napi_env env, napi_callback_info info)
{
size_t argc = 2;
napi_value args[2] = {nullptr};
napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
napi_valuetype valuetype0;
napi_typeof(env, args[0], &valuetype0);
napi_valuetype valuetype1;
napi_typeof(env, args[1], &valuetype1);
double value0;
napi_get_value_double(env, args[0], &value0);
double value1;
napi_get_value_double(env, args[1], &value1);
return harArkTSAdd(value0, value1);
} 在Module1的ArkTS侧调用Native侧的invokeHarArkTS()方法。
Button($r('app.string.call_har_ArkTS_method'))
.fontSize(16)
.width('100%')
.margin({ top: 12 })
.onClick(() => {
this.getUIContext().getPromptAction().showToast({ message: 'HarArkTS method call succeed, result is '
+ napi.invokeHarArkTS(2, 3).toString() });
})