三方库迁移至 OpenHarmony 应用

三方库是指其他公司或者组织提供的服务或模块，例如常见的开源 OpenCV、libcurl 库，将三方库迁移至OpenHarmony 上，有助于系统的生态建设。

本文首先以三方库 curl 为例，分别给出 Windows 和 Linux 开发环境下，curl 移植到 OpenHarmony 上的流程示意。主要涉及三部分内容，分别为编译环境的准备、编译工具的使用以及生成文件的调用。然后以 luajit 库为例，介绍非camke编译时，如何配置环境变量，并使用make进行编译构建。

1. Windows

编译环境准备

• curl 库的源码下载至本地，并新建一个build文件夹

git clone https://github.com/curl/curl.git

• native中cmake的相关工具添加到系统环境变量，cmake编译工具位于OpenHarmony SDK的native目录下

  • HUAWEI DevEco Studio下载安装
  • DevEco 中可以安装OpenHarmony SDK，也可以手动下载安装

动态库的编译

• libcurl.so 的编译

mkdir build
cd build

# 编译64或者32，二选一，选择 Ninja 生成器
# arm64-v8a 编译64位
cmake -DCMAKE_TOOLCHAIN_FILE=C:\Users\duwentao\AppData\Local\OpenHarmony\Sdk\9\native\build\cmake\ohos.toolchain.cmake -DOHOS_ARCH=arm64-v8a -DOHOS_STL=c++_shared .. -G Ninja

# lib下的cmake

# armeabi-v7a 编译32位
cmake -DCMAKE_TOOLCHAIN_FILE=C:\Users\duwentao\AppData\Local\OpenHarmony\Sdk\9\native\build\cmake\ohos.toolchain.cmake -DOHOS_ARCH=armeabi-v7a -DOHOS_STL=c++_shared .. -G Ninja

# 编译构建
cmake --build .

• cmake参数介绍
  • OHOS_STL，目标文件类型，可以是 c++_shared 和 c++_static，默认是c++_shared
  • OHOS_ARCH，设置应用程序二进制接口ABI，可以是 armeabi-v7a 和 arm64-v8a，默认值 arm64-v8a
  • CMAKE_TOOLCHAIN_FILE，工具链文件所在的位置，即 ohos.toolchain.cmake 的路径
  • -G Ninja，使用生成器Ninja

libcurl.so 的调用

• so 文件放入对应目录下

• 在 CMakeLists.txt 中链入对应so，需要根据编译出来的abiFilters类型，将so放入对应文件夹

• 在 CPP 代码中调用头文件中的接口。也可以通过NAPI的方式封装C++接口，然后在JS侧进行调用，这种方式会在后续介绍

---

2.Linux

编译环境目前主要支持Ubuntu18.04和Ubuntu20.04（Ubuntu22.04暂不支持）

编译环境准备

本节基于wsl和Ubuntu20.04，在Linux环境下编译 curl 库，并在应用中调用 curl 中的相关接口

• curl 库的源码下载至本地，并新建一个build文件夹

git clone https://github.com/curl/curl.git

下载 OpenHarmony SDK 命令行工具

• SDK下载 地址 及ohsdkmgr使用 指导
• 解压命令行工具，工具名称请根据实际情况进行修改

unzip command-line-tools.zip

• 打开SDK工具配置文件config.properties，并设置OpenHarmony SDK存储路径，请注意，指定路径时请使用绝对路径

vim config.properties

• 进入到command-line-tools/sdkmanager/bin下，安装OpenHarmony SDK，SDK中包含ArkTS、JS和Native SDK，以及toolchains工具链。例如，同时安装native和toolchains

./sdkmgr install native:9 toolchains --accept-license

• 配置SDK环境变量

vim ~/.bashrc
# 配置路径
export PATH='/home/dwt/ndk/9/native/build-tools/cmake/bin':$PATH
# 执行source命令使配置文件立即生效
source ~/.bashrc  

动态库的编译

• curl代码下载完成后，在curl目录下，按照以下步骤编译

mkdir build
cd build
cmake -DCMAKE_TOOLCHAIN_FILE=//home/dwt/ndk/9/native/build/cmake/ohos.toolchain.cmake -DOHOS_ARCH=arm64-v8a -DOHOS_STL=c++_shared .. -G Ninja -DHAVE_WRITABLE_ARGV_EXITCODE=0 -DHAVE_WRITABLE_ARGV_EXITCODE__TRYRUN_OUTPUT=0

• DHAVE_WRITABLE_ARGV_EXITCODE和DHAVE_WRITABLE_ARGV_EXITCODE__TRYRUN_OUTPUT为cmake中 try_run()函数 所需缓存变量

• 在 /curl/build/lib 目录下将会生成目标文件：libcurl.so

libcurl.so 的调用

参照上文windows示例的调用方式，开发者可在业务native代码中调用curl相关接口

---

3. 非cmake编译

luajit 是一个以makefile进行构建的三方库。这种情况下有两种处理策略，一种是使用 cmake 构建脚本重写开源库的构建过程，对于cmake的命令语法要求较高。另一种是直接使用开源库原生的构建工具，例如 configure、makefile，然后配置ohos_sdk的环境变量，进行编译。

方法一：使用 cmake 构建脚本重写开源库的构建过程

• 请参考 oh 三方库 cmake 编写指导

方法二：使用开源库原生的构建工具，例如 configure、makefile

首先，编译工具都有自己对应的环境变量。构建脚本并不是直接调用 gcc 或者 clang 编译工具链的，而是优先调用 CC 环境变量以达到调用 c 编译器的目的，对应的 CXX 环境变量对应 c++ 编译器。通过设置环境变量，让构建工具使用 ohos SDK 的编译工具链。

• 设置 ohos 64bit 库编译工具链环境变量

#aarch64-linux-ohos
export OHOS_SDK=/home/dwt/ndk/9
export AS=${OHOS_SDK}/native/llvm/bin/llvm-as
export CC="${OHOS_SDK}/native/llvm/bin/clang --target=aarch64-linux-ohos"
export CXX="${OHOS_SDK}/native/llvm/bin/clang++ --target=aarch64-linux-ohos"
export LD="${OHOS_SDK}/native/llvm/bin/lld --target=aarch64-linux-ohos"
export STRIP=${OHOS_SDK}/native/llvm/bin/llvm-strip
export RANLIB=${OHOS_SDK}/native/llvm/bin/llvm-ranlib
export OBJDUMP=${OHOS_SDK}/native/llvm/bin/llvm-objdump
export OBJCOPY=${OHOS_SDK}/native/llvm/bin/llvm-objcopy
export NM=${OHOS_SDK}/native/llvm/bin/llvm-nm
export AR=${OHOS_SDK}/native/llvm/bin/llvm-ar
export CFLAGS="-fPIC -D__MUSL__=1"
export CXXFLAGS="-fPIC -D__MUSL__=1"

• 设置 ohos 32bit 库编译工具链环境变量

linux-arm
export OHOS_SDK=/home/dwt/ndk/9
export AS=${OHOS_SDK}/native/llvm/bin/llvm-as
export CC="${OHOS_SDK}/native/llvm/bin/clang --target=arm-linux-ohos"
export CXX="${OHOS_SDK}/native/llvm/bin/clang++ --target=arm-linux-ohos"
export LD="${OHOS_SDK}/native/llvm/bin/lld --target=arm-linux-ohos"
export STRIP=${OHOS_SDK}/native/llvm/bin/llvm-strip
export RANLIB=${OHOS_SDK}/native/llvm/bin/llvm-ranlib
export OBJDUMP=${OHOS_SDK}/native/llvm/bin/llvm-objdump
export OBJCOPY=${OHOS_SDK}/native/llvm/bin/llvm-objcopy
export NM=${OHOS_SDK}/native/llvm/bin/llvm-nm
export AR=${OHOS_SDK}/native/llvm/bin/llvm-ar
export CFLAGS="-fPIC -march=armv7a -D__MUSL__=1"
export CXXFLAGS="-fPIC -march=armv7a -D__MUSL__=1"

• 编译

make