鸿蒙Native输出so动态库，并提供给第三方导入使用

前言：

DevEco Studio版本：4.0.0.600

API:9

最近在学习鸿蒙的Native输出so动态库，下面就给大家分享下我的学习心得及在实现过程中遇到的问题。

实现需求：通过so库输出文本内容 “你好，鸿蒙！”

参考资料：OpenHarmony Native API

实现过程：

1、创建Native工程

File-->New-->create Project，选择Native C++项目

正常点击Finish后，在项目中会自动生成一个示例模板代码，hello.cpp

2、创建C++文件，实现需求

我们有两种方式，一个是直接修改模板hello.cpp，另外一种是自己新建一个.cpp文件。这边以新建方式来实现。

在cpp目录右键新建c++文件

show.cpp代码实现：（C代码能力有限，只能参考hello.cpp写个简单的文本输出!!!）

#include "napi/native_api.h"
#include <string.h>

static napi_value show(napi_env env, napi_callback_info info) {
    char *returnStr = "你好 鸿蒙！";
    napi_value result;
    napi_create_string_utf8(env, returnStr, strlen(returnStr), &result);

    return result;
}

EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports) {
    napi_property_descriptor desc[] = {{"show", NULL, show, NULL, NULL, NULL, napi_default, NULL}};
    napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
    return exports;
}
EXTERN_C_END

static napi_module demoModule = {
    .nm_version = 1,
    .nm_flags = 0,
    .nm_filename = NULL,
    .nm_register_func = Init,
    .nm_modname = "show",
    .nm_priv = ((void *)0),
    .reserved = {0},
};

extern "C" __attribute__((constructor)) void RegisterEntryModule(void) { napi_module_register(&demoModule); }

3、CMakeLists.txt中添加对show.cpp的引用

# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(NativeShow)

set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})

include_directories(${NATIVERENDER_ROOT_PATH}
                    ${NATIVERENDER_ROOT_PATH}/include)

#add_library(entry SHARED hello.cpp)
#target_link_libraries(entry PUBLIC libace_napi.z.so)

add_library(show SHARED show.cpp)
target_link_libraries(show PUBLIC libace_napi.z.so)

4、编译并导出so库

执行build-->build Hap，进行编译

然后在build--> intermediates --> libs -->default中可以看到arm64-v8a、armeabi-v7a、x86_64这三个默认的架构。

可以在项目的build-profile.json5中添加abiFilters输出的架构

"abiFilters": [
  'armeabi-v7a',
  'arm64-v8a'
]

重新执行build-->build Hap

5、在第三方应用中引用

新建一个应用，并在entry目录下新建libs目录，将上一步中的so库拷贝到新建的libs中

在index.ets中添加使用

import show from 'libshow.so'

@Entry
@Component
struct Index {
  @State message: string = 'Hello World';

  aboutToAppear(){
    this.message = show.show()
  }

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

效果：

实现中遇到的坑：

1、libc++_shared.so没有导入，引起的‘undefined’错误

libc++_shared是C++运行时库，因此必须要引入。

2、so库架构放置错误，引起的‘undefined’错误

测试中，我在分开测试arm64-v8a、armeabi-v7a时误将v8a的so复制到v7a中进行使用导致。因此在实际使用中，尽量连带着文件夹目录一起拷贝避免出现目录放置错误的情况