场景描述
对于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)技术知识点。
本路线共分为四个阶段:
第一阶段:鸿蒙初中级开发必备技能
第二阶段:鸿蒙南北双向高工技能基础:gitee.com/MNxiaona/733GH
第三阶段:应用开发中高级就业技术
第四阶段:全网首发-工业级南向设备开发就业技术:gitee.com/MNxiaona/733GH
《鸿蒙 (Harmony OS)开发学习手册》(共计892页)
如何快速入门?
1.基本概念
2.构建第一个ArkTS应用
3.……
开发基础知识:gitee.com/MNxiaona/733GH
1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……
基于ArkTS 开发
1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……
鸿蒙开发面试真题(含参考答案):gitee.com/MNxiaona/733GH
鸿蒙入门教学视频:
美团APP实战开发教学:gitee.com/MNxiaona/733GH
写在最后
- 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
- 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
- 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
- 想要获取更多完整鸿蒙最新学习资源,请移步前往小编:
gitee.com/MNxiaona/733GH