HarmonyOS NEXT开辟：C代码打包so库，napi调用函数及回调

适用流程：已有一些C代码，不想把源码添加到HarmonyOS工程中，想要把已有的C代码编译成HarmonyOS平台可以使用的so库，在DevEco Studio工程的cpp模块加载so库并调用里面的函数，终极使用ArkTS/TS调用该函数（获取回调）。
C源码可以添加到HarmonyOS工程的，可以省略手动编译过程。

  
C代码打包.so动态库

获取OpenHarmony SDK

官网或套件货架获取DevEco Studio安装包（也可以直接下载Command Line Tools）
解压后得到 免安装版 或 exe(需安装)
安装后，在安装目录下找到 sdk\HarmonyOS-NEXT-DB1\openharmony\native
不同版本的路径名称略有差异，大抵雷同，终极找到native目录
配置环境变量

新建以下环境变量（假设你的SDK放在XXX目录下）
环境变量名环境变量值HDC_SERVER_PORT7035OHOS_HDC_SERVER_PORT7036OHOS_NDK_HOMEXXX\sdk\HarmonyOS-NEXT-DB1\openharmony\native 把以下路径加入Path环境变量
XXX\sdk\HarmonyOS-NEXT-DB1\openharmony\native\build-tools\cmake\bin
编写CMakeLists

在要编译的C代码根目录下添加CMakeLists.txt

1. cmake_minimum_required(VERSION 3.5.0)
2. project(net)
4. # SKIP REPATH SETTING. Next four lines are set for skipping repath.
5. # The fourth line works. Don't know if the third line works.
6. set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -s -ftrapv -D_FORTIFY_SOURCE=2 -O2")
7. set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -s -ftrapv -D_FORTIFY_SOURCE=2 -O2")
8. set(CMAKE_SKIP_BUILD_RPATH_TRUE)
9. set(CMAKE_SKIP_RPATH TRUE)
11. # SKIP REPATH SETTING. Next two line is set for skipping repath.
12. add_compile_options(-fstack-protector-all)
13. # stack protector and Strip
14. add_link_options(-s)
16. include_directories(${CMAKE_CURRENT_SOURCE_DIR}
17.                     ${CMAKE_CURRENT_SOURCE_DIR}/include)
19. # 链接静态库（例如需要链接OpenSSL）
20. link_libraries(${CMAKE_CURRENT_SOURCE_DIR}/lib/${OHOS_ARCH}/libcrypto.a)
21. link_libraries(${CMAKE_CURRENT_SOURCE_DIR}/lib/${OHOS_ARCH}/libssl.a)
23. # 将所有.c文件添加进来
24. file(GLOB_RECURSE SOURCES "./src/*.c")
26. # 编译为动态库，net是动态库的名称
27. # SHARED 动态库, STATIC 静态库
28. add_library(net
29.             SHARED
30.             ${SOURCES})
32. # 包含所有头文件的目录
33. target_include_directories(net PUBLIC
34.                                         "${CMAKE_CURRENT_SOURCE_DIR}/include"
35.                                         "${CMAKE_CURRENT_SOURCE_DIR}/include/openssl"
36. )
38. # 添加导入库的查找目录
39. target_link_directories(net PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/lib/${OHOS_ARCH}/)
41. # 链接导入库
42. target_link_libraries(net PUBLIC libssl.a libcrypto.a libace_napi.z.so libhilog_ndk.z.so libnet_connection.so)

复制代码

编写脚本（Windows）

以编译脚本(.bat)与CMakeLists在同级目录为例

1. rd /s /Q build_cmake
3. mkdir build_cmake
5. cd build_cmake
7. cmake -DCMAKE_C_COMPILER:FILEPATH=%OHOS_NDK_HOME%\llvm\bin\clang.exe -DCMAKE_CXX_COMPILER:FILEPATH=%OHOS_NDK_HOME%\llvm\bin\clang++.exe -DCMAKE_TOOLCHAIN_FILE=%OHOS_NDK_HOME%\build\cmake\ohos.toolchain.cmake -DCMAKE_MAKE_PROGRAM=%OHOS_NDK_HOME%\build-tools\cmake\bin\ninja.exe -DOHOS_ARCH=arm64-v8a -DOHOS_STL=c++_shared .. -G Ninja
9. cmake --build .
11. cd /d %~dp0

复制代码

编译

在命令行工具实行该脚本，即可打包成arm64-v8a的动态库，在build_cmake目录下获取libtest.so
使用NAPI调用动态库的函数

添加so

创建Native C++ Project

把动态库放在module的libs目录下

在napi.cpp中调用动态库的函数

假设C库中有一个函数是这样的：（必要ohos.permission.GET_NETWORK_INFO权限）

1. int get_client_ip(char*** client_ip, int* ip_size);

复制代码

下面是napi.cpp中调用该函数

1. #include "aaa.h"//为了方便使用C库里面的一些结构体和宏定义，把头文件拷贝过来并引用
2. #include "dlfcn.h"
4. #undef LOG_TAG
5. #define LOG_TAG "NapiTest"
6. #define NATIVE_PATH "/data/storage/el1/bundle/libs/arm64/libnet.so"//这个路径可以在上层通过context获取，目前是固定的
8. void *native_lib = nullptr;
10. #define GET_NAPI_ERROR()                                                                                                    \
11.     const napi_extended_error_info *errorInfo;                                                                              \
12.     status = napi_get_last_error_info(gEnv, &errorInfo);                                                                    \
13.     if (status == napi_ok) {                                                                                                \
14.         OH_LOG_ERROR(LOG_APP, "last error info : %{public}s", errorInfo->error_message);                                    \
15.     } else {                                                                                                                \
16.         OH_LOG_ERROR(LOG_APP, "get last error error");                                                                      \
17.     }
19. typedef int (*GetClientIP)(char ***client_ip, int *ip_size);
20. static napi_value getClientIP(napi_env env, napi_callback_info info) {
21.     OH_LOG_INFO(LOG_APP, "getClientIP");
22.     char **client_ip = nullptr;
23.     int ip_size = 0;
25.     napi_value result = nullptr;
26.     if (native_lib == nullptr) {
27.         OH_LOG_INFO(LOG_APP, "arrayGetClientPublicIP native_lib is empty, dlopen");
28.         native_lib = dlopen(NATIVE_PATH, RTLD_LAZY | RTLD_GLOBAL);
29.         if (native_lib == nullptr) {
30.             OH_LOG_ERROR(LOG_APP, "cannot load library: %{public}s", dlerror());
31.             napi_get_undefined(env, &result);
32.             return result;
33.         }
34.     }
35.     dlerror();
36.     GetClientIP getIP = (GetClientIP)dlsym(native_lib, "get_client_ip");
37.     if (dlerror()) {
38.         OH_LOG_ERROR(LOG_APP, "load get_client_ip failed: %{public}s", dlerror());
39.         napi_get_undefined(env, &result);
40.         return result;
41.     }
42.     int value = getIP(&client_ip, &ip_size);
43.     if (value == ERR_SUCCESS) {
44.         OH_LOG_INFO(LOG_APP, "get client ip success, ip_size=%{public}d", ip_size);
45.         napi_value ip_array;
46.         napi_create_array_with_length(env, ip_size, &ip_array);
48.         for (int i = 0; i < ip_size; ++i) {
49.             OH_LOG_INFO(LOG_APP, "client ip[%{public}d]=%{public}s", i, client_ip[i]);
50.             napi_value ip_string;
51.             napi_create_string_utf8(env, client_ip[i], NAPI_AUTO_LENGTH, &ip_string);
52.             napi_set_element(env, ip_array, i, ip_string);
53.         }
55.         result = ip_array;
56.     } else {
57.         OH_LOG_INFO(LOG_APP, "get client ip failed, ret=%{public}d", value);
58.         napi_get_undefined(env, &result);
59.     }
61.     for (int i = 0; i < ip_size; ++i) {
62.         free(client_ip[i]);
63.     }
64.     free(client_ip);
66.     return result;
67. }
69. EXTERN_C_START
70. static napi_value Init(napi_env env, napi_value exports)
71. {
72.     napi_property_descriptor desc[] = {
73.         { "getClientIP", nullptr, getClientIP, nullptr, nullptr, nullptr, napi_default, nullptr }
74.     };
75.     napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
76.     return exports;
77. }
78. EXTERN_C_END
80. static napi_module demoModule = {
81.     .nm_version = 1,
82.     .nm_flags = 0,
83.     .nm_filename = nullptr,
84.     .nm_register_func = Init,
85.     .nm_modname = "entry",
86.     .nm_priv = ((void*)0),
87.     .reserved = { 0 },
88. };
90. extern "C" __attribute__((constructor)) void RegisterEntryModule(void)
91. {
92.     napi_module_register(&demoModule);
93. }

复制代码

CMakeLists.txt

把napi.cpp和头文件、库添加进来

1. cmake_minimum_required(VERSION 3.5.0)
2. project(NativeDemo)
4. set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})
6. if(DEFINED PACKAGE_FIND_FILE)
7.     include(${PACKAGE_FIND_FILE})
8. endif()
10. include_directories(${NATIVERENDER_ROOT_PATH}
11.                     ${NATIVERENDER_ROOT_PATH}/include)
13. link_libraries(${NATIVERENDER_ROOT_PATH}/../../../libs/${OHOS_ARCH}/libnet.so)
15. add_library(entry SHARED napi.cpp)
16. target_link_libraries(extry PUBLIC libace_napi.z.so libhilog_ndk.z.so libnet.so libnet_connection.so)

复制代码

桥接TS与C++

在Index.d.ts中添加该接口的TS界说

1. export const getClientIP: () => Array<string>

复制代码

TS/ArkTS调用

终极，在TS代码中添加库的引用，即可调用该native接口

1. import testNapi from 'libentry.so';
3. @Entry
4. @Component
5. struct Index {
6.   @State message: string = ''
8.   build() {
9.     Row() {
10.       Column() {
11.         Button('Get Client IP')
12.           .fontSize(20)
13.           .onClick(() => {
14.             this.message = testNapi.getClientIP().toString()
15.           })
16.         Text(this.message)
17.           .fontSize(20)
18.           .margin({ top: 20 })
19.       }
20.       .width('100%')
21.     }
22.     .height('100%')
23.   }
24. }

复制代码

  签名，运行，大功告成！
  Gitee代码库

https://gitee.com/huyuhy/harmony-os
先写这么多，回调下次再写。。。


免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。