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

「已注销」

于 2024-07-10 22:59:20 发布

阅读量1k

点赞数 21

分类专栏：鸿蒙开发移动开发 HarmonyOS 文章标签： harmonyos 开源 c语言组件化开发 arkts 移动开发 lycium

本文链接：https://blog.csdn.net/HarmonyOSMN/article/details/140336501

版权

鸿蒙开发同时被 3 个专栏收录

101 篇文章 2 订阅

订阅专栏

移动开发

101 篇文章 0 订阅

订阅专栏

HarmonyOS

101 篇文章 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）学习路线与学习文档用来跟着学习是非常有必要的。

针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。