HarmonyOS开发学习：lycium的开源c库编译集成

不停留的码牛

于 2024-07-08 15:42:50 发布

阅读量521

点赞数 12

分类专栏：鸿蒙 HarmonyOS OpenHarmony 文章标签： harmonyos 华为 HarmonyOS Next 嵌入式硬件鸿蒙学习开源

本文链接：https://blog.csdn.net/m0_64422261/article/details/140270582

版权

鸿蒙同时被 3 个专栏收录

133 篇文章 0 订阅

订阅专栏

HarmonyOS

131 篇文章 0 订阅

订阅专栏

OpenHarmony

121 篇文章 0 订阅

订阅专栏

场景描述

对于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文件如图

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？但是又不知道从哪里下手，而且学习时频繁踩坑，最终浪费大量时间。所以本人整理了一些比较合适的鸿蒙（HarmonyOS NEXT）学习路径和一些资料的整理供小伙伴学习

点击领取→纯血鸿蒙Next全套最新学习资料希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取~~

一、鸿蒙（HarmonyOS NEXT）最新学习路线

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）…等技术知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

二、HarmonyOS Next 最新全套视频教程