鸿蒙开发5.0【基于lycium的开源c库编译与集成】

news2025/5/17 13:30:08

场景描述

对于c库编译问题，应用经常会遇到如下业务诉求

场景一：基于HarmonyOS编译开源C库

场景二：开源c库编译完成后的集成

方案描述

场景一：

需要使用开源c库

lycium的使用说明：lycium的特点就是自动化编译，只需要一个./build.sh命令就可以完成编译，下面的编译例子（openssl）代码库是通过hpkbuild脚本从github或者gitee上面拉取，在hpkbuild脚本中已经默认提供了一套编译默认的配置，也可以按照需求修改。

lycium的范围说明：在[开源c库仓]已经提供了一套默认配置，针对lycium自动化编译脚本的使用。lycium其涵盖了三种构建方式，不在c仓的需要针对该库的编译方式手动编译或者手动写脚本。

方案

使用lycium交叉编译框架将已经移植过来的c库编译，以及针对某些特定库在使用交叉编译过程中会遇到的一些常见问题。

我们从头开始演示如何编译移植过来的openssl库

lycium编译环境准备

1.对应平台下载[ohos sdk]并进行解压

2.配置环境变量如Mac环境举例

3.拷贝编译工具

在使用lycium工具前，需要将这些编译命令拷贝到SDK对应的目录下，具体操作如下：

cd lycium/Buildtools # 进入到工具包目录

sha512sum -c SHA512SUM # 可校验工具包是否正常, 若输出"toolchain.tar.gz: OK"则说明工具包正常，否则说明工具包异常，需重新下载

tar -zxvf toolchain.tar.gz # 解压拷贝编译工具

cp toolchain/* ${OHOS_SDK}/native/llvm/bin # 将命令文件拷贝到工具链的native/llvm/bin目录下

#是将toolchain.tar.gz解压出来的命令文件拷贝到工具链的native/llvm/bin目录下

快速编译开源C库

1.将 [tpc_c_cplusplus]C库仓克隆或者下载zip包下载以我的Mac目录为例子 cd到仓库lycium 目录

2…/build.sh openssl 开始编译并等待ALL JOBS DONE!!

3.编译好的openssl会生成在 lycium/usr 目录下

编译中可能遇到的问题

1.遇到网络问题 openssl/HPKBUILD 脚本中指定的三方库源码包下载不下来

ERROR during ：download XXX.tar.gz

因为仓库不承载三方库的源码部分，因此进行三方库编译时需要先从开源社区获取源码部分，此部分可能需要网络代理等方式保证对gitee、github等网站的连通，当出现此错误时代表wget等下载工具不能够正常获取代码，请检查网络配置。

解决办法

将source 链接中对应部分进行替换后复制进浏览器下载并将生成的包放在tpc_c_cplusplus-master\thirdparty\openssl后再重复编译操作

2.对需要的架构进行选择编译（一些伙伴使用模拟器需要使用到x86架构）

场景一：对于有些伙伴由于真机缺少真机，需要在模拟器上面使用x86架构的动态库，以网络库curl为例

由于curl由cmake构建所以只需要在编译脚本HPKBUILD文件中的archs=(“armeabi-v7a” “arm64-v8a”)添加"x86_64"

参考文档： lycium上面适配HarmonyOS不同架构的构建

3.“请先安装 xxx命令，才可以编译”

此信息代表当前编译三方库强需求xxx工具或者命令，请先安装对应的工具以及确保安装后的环境变量能够在tpc_c_cplusplus仓库目录生效。

场景二：

编译好的文件不知道如何进行集成，自行链接出现运行闪退

闪退原因：对于通用加载崩溃，都是没有打包到hap里面去导致的，或者是打包进去了，依赖库没打包进去，基本都是这种情况

方案

以openssl为例子

应用中集成三方库

在DevEco Studio的cpp目录（在引用三方库的模块的cpp目录下）下新增thirdparty目录，将编译生成的库拷贝到该目录下，如下图所示：

在最外层（cpp目录下）CMakeLists.txt中添加如下语句

#将三方库加入工程中

target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/openssl/${OHOS_ARCH}/lib/libssl.a)

target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/openssl/${OHOS_ARCH}/lib/libcrypto.a)



#将三方库的头文件加入工程中

target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/openssl/${OHOS_ARCH}/include)

C++中的库分为静态库和动态库两种。静态库在链接时被完整地复制到可执行文件中，而动态库则是在运行时加载到内存中。它们有以下几个区别：

静态库将库代码静态地编译到可执行文件中，因此可执行文件的大小会增大；而动态库则是在运行时从共享库中加载所需的代码，因此可执行文件的大小较小。
静态库一旦被链接，其中所有的代码都不再发生更改；而动态库可以在程序运行时被升级或替换。
多个可执行文件可以使用同一个动态库，以减少内存占用和磁盘空间的使用。但每个可执行文件都需要包含其自己的静态库副本，因此可能会浪费大量的磁盘空间。

如果是使用静态库，参考对应库文档

下面说明如何连接动态库

库名/架构名/lib目录下是编译时需要的动态库，cmakelist链接动态库时是指这个路径

libs/架构名 下的带主版本号的会打进hap包中，是运行时需要的动态库

应用在引用动态库的时候是通过soname来查找的，所以我们需要将名字为soname的库文件拷贝到entry/libs/${OHOS_ARCH}/目录下

soname查看方法：$OHOS_SDK/native/llvm/bin/llvm-readelf -d libxxx.so

大多数情况下soname就是带主版本号的动态库

所以详细步骤如下

libs/arm64-v8a下放入所有的.so.版本号文件

thirdparty\xxx(一般为库名)\arm64-v8a（架构名）\lib下放入所有的.so文件如图