在NDK工程中，可以通过CMake语法规则引入并使用预构建库。模块libs目录中的预构建库，以及在CMakeLists.txt中声明的预构建库都会被打包。

一、预构建库使用

二、直接引入预构建库

2.1 文件结构示例

预构建库文件存放路径示例：

entry/src/main/
├── cpp/
│   ├── third_party/
│   │   └── FFmpeg/
│   │       ├── include/         # 头文件目录
│   │       └── libs/            # 库文件目录
│   │           ├── arm64-v8a/
│   │           │   └── libavcodec_ffmpeg.so
│   │           └── armeabi-v7a/
│   │               └── libavcodec_ffmpeg.so
│   └── CMakeLists.txt

2.2 CMakeLists.txt配置

# 添加源码产物
add_library(library SHARED hello.cpp)

# 添加预构建库（IMPORTED表示预构建）
add_library(avcodec_ffmpeg SHARED IMPORTED)

# 设置预构建库的属性
set_target_properties(avcodec_ffmpeg
  PROPERTIES
  IMPORTED_LOCATION ${CMAKE_CURRENT_SOURCE_DIR}/third_party/FFmpeg/libs/${OHOS_ARCH}/libavcodec_ffmpeg.so
)

# 声明链接该预构建库
target_link_libraries(library PUBLIC libace_napi.z.so avcodec_ffmpeg)

# 添加头文件目录
include_directories(
  ${CMAKE_CURRENT_SOURCE_DIR}/third_party/FFmpeg/include
)

说明：

• add_library(avcodec_ffmpeg SHARED IMPORTED)：IMPORTED表示这是预构建库，不需要编译

• set_target_properties：设置IMPORTED_LOCATION属性指定库文件路径

• ${OHOS_ARCH}：根据编译架构自动选择对应目录（arm64-v8a/armeabi-v7a等）

2.3 HAR中使用预构建库

当在HAR中使用预构建库时，当前编译的库和链接所需预构建库会打包到HAR中的libs目录下。

三、预构建库的SONAME问题

如果预构建SO没有设置SONAME，链接器将会将SO的绝对路径插入到依赖这个SO的二进制文件的dynamic section中。当这些二进制文件随HAP包发布运行时，动态加载器可能最终无法找到这个SO而导致错误。

检查SONAME

使用llvm-readelf工具查看SO文件是否设置了SONAME：

# 工具路径
${DevEco Studio安装目录}/sdk/default/openharmony/native/llvm/bin/llvm-readelf

# 示例命令
${YOUR_PATH}/command-line-tools/sdk/default/openharmony/native/llvm/bin/llvm-readelf -d libavcodec_ffmpeg.so | grep SONAME

# 正确输出示例
0x000000000000000e (SONAME) Library soname: [libavcodec_ffmpeg.so]

设置SONAME的方法

四、使用远程依赖HAR中集成的预构建库

# 设置依赖路径
set(DEPENDENCY_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules)

# 添加预构建库
add_library(library SHARED IMPORTED)

# 设置库文件路径
set_target_properties(library
  PROPERTIES
  IMPORTED_LOCATION ${DEPENDENCY_PATH}/library/libs/${OHOS_ARCH}/liblibrary.so
)

# 链接到主产物
add_library(entry SHARED hello.cpp)
target_link_libraries(entry PUBLIC libace_napi.z.so library)

路径说明：../../../oh_modules是远程依赖HAR在工程中的默认存放位置。

五、使用本地HAR中集成的预构建库

# 设置本地HAR库路径
set(LIBRARY_DIR "${NATIVERENDER_ROOT_PATH}/../../../../library/build/default/intermediates/libs/default/${OHOS_ARCH}/")

# 添加预构建库
add_library(library SHARED IMPORTED)

# 设置库文件路径
set_target_properties(library
  PROPERTIES
  IMPORTED_LOCATION ${LIBRARY_DIR}/liblibrary.so
)

# 链接到主产物
add_library(entry SHARED hello.cpp)
target_link_libraries(entry PUBLIC libace_napi.z.so library)

六、核心点

路径类型