基于lycium的开源c库编译与集成
场景描述
对于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_cplusplusC库仓克隆或者下载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++中的库分为静态库和动态库两种。静态库在链接时被完整地复制到可执行文件中,而动态库则是在运行时加载到内存中。它们有以下几个区别:
1. 静态库将库代码静态地编译到可执行文件中,因此可执行文件的大小会增大;而动态库则是在运行时从共享库中加载所需的代码,因此可执行文件的大小较小。
2. 静态库一旦被链接,其中所有的代码都不再发生更改;而动态库可以在程序运行时被升级或替换。
3. 多个可执行文件可以使用同一个动态库,以减少内存占用和磁盘空间的使用。但每个可执行文件都需要包含其自己的静态库副本,因此可能会浪费大量的磁盘空间。
如果是使用静态库,参考对应库文档。
下面说明如何连接动态库:
库名/架构名/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文件,如图: