conan NDK交叉编译自己的conan包项目塈profile的定义
上一篇博客《conan入门(八):交叉编译自己的conan包项目》中我们以jsonlib为例说明了如何将交叉编译自己封装成conan的模块。但是使用的DS-5 ARM的交叉编译器(arm-linux-gnueabihf
)并不常见,也不方便读者实际操作。
本文还以 jsonlib 为例,说明如何将自己的封装成conan的模块使用Android NDK实现交叉编译。
jsonlib示例程序
示例的所有源码都保存在GIT仓库 conan_example的jsonlib分支,请直接克隆代码到本地:
代码语言:javascript复制git clone https://gitee.com/l0km/conan_example.git -b jsonlib
# -b jsonlib 切换到 jsonlib 分支,等价于 'git checkout jsonlib' 命令
jsonlib是个很简单的库,只有两个文件:jsonlib.h,jsonlib.c
,只实现了一个功能从JSON字符串中解析name指定的字段内容,结果保存到输出缓冲区,JSON解析的工作实际上是调用cJSON来实现的。
profile
上一篇博客《conan入门(八):交叉编译自己的conan包项目》中我们是以如下指定来执行交叉编译的。操作系统,CPU体系,编译器及版本都是通过命令行参数传递的,每次执行都要输入这么多参数也真是挺辛苦的。
代码语言:javascript复制conan install . -s os=Linux -s arch=armv7 -s compiler=gcc -s compiler.version=4.8 --build missing -pr:b default
Android NDK交叉编译需要提供的参数更多,要是都通过命令行参数传递,更加麻烦,所以这次Android NDK交叉编译,我们使用Conan官方推荐的profile文件定义方式来为conan install 提供编译参数
Conan官方文档:《Using Profile》
使用conan profile文件,我们不仅可以声明settings
将识别我们的二进制文件(host
设置),还可以声明使用工具链或交叉编译器所需的所有环境变量。该配置文件需要以下部分:
- 包含常规设置的**settings**
os
部分: 、arch
和 取决于您的库compiler
。build_type
这些设置将识别您的二进制文件。 - 带有指向已安装工具链的 PATH 变量的**env部分。**还有工具链期望的任何其他变量(阅读编译器的文档)。一些构建系统需要一个变量
SYSROOT
来定位主机系统库和工具的位置。
以下以Android NDK(android-ndk-r19c
)为例,我参照《Linux/Windows/macOS to Android》
写的用于Android NDK交叉的配置文件:
android_21_arm_clang
代码语言:javascript复制include(default)
# 需要修改为你的Android NDK实际安装位置
android_ndk=D:/j/android-ndk-r19c
[settings]
arch=armv8
build_type=Release
compiler=clang
compiler.libcxx=c _static
compiler.version=8
os=Android
os.api_level=21
[tool_requires]
[options]
[env]
# 定义交叉编译工具链文件
CONAN_CMAKE_TOOLCHAIN_FILE=$android_ndk/build/cmake/android.toolchain.cmake
[conf]
tools.android:ndk_path=$android_ndk
这个profile文件你可以保存在任何位置,但建议保存在Conan专门保存profile文件的文件夹下
$HOME/.conan/profiles
conan create(交叉编译jsonlib)
创建了conanfile.py后,编译conan包非常简单
代码语言:javascript复制# 注意是 conan_example jsonlib分支
$ cd conan_example
# 将conan包(conanfile.py 和相关文件,不包括编译生成的二进制包)复制到本地仓库。
conan create . -pr:h android_21_arm_clang -pr:b default --build jsolib --build missing --test-folder None
conan create .
根据配置文件 (同级文件夹下的conanfile.py) 构建二进制包 –test-folder None 参数指定不执行测试命令 -pr:h android_21_arm_clang 指定目标设备的profile交叉编译配置文件,如果配置文件不在Conan专门保存profile文件的文件夹$HOME/.conan/profiles
下,需要准确指定路径 -pr:b default 指定使用名为default的profile文件作为当前主机的配置文件 –build missing 如果依赖包中没有找到预编译的二进制包则从源码编译 –build 的可选值(可多个组合): --build never 禁止编译依赖包,只下载预编译的二进制包,如果没找到预编译包则报错不可与其他可选值组合 --build missing 如果依赖包中没有找到预编译的二进制包则从源码编译 --build outdated 如果依赖包中没有找到预编译的二进制包或过期(日期旧于源码)则从源码编译 --build cascade --build pattern 编译包名匹配pattern的所有包 --build undefined 编译包名匹配pattern的之外所有包--build=missing
也是有效的写法conan create
命令行用法详细说明参见Conan官方文档《conan create》
conan create
执行成功后,就会将生成的二进制包保存在本地仓库$HOME/.conan/data/jsonlib/1.0.0/_/_package
执行conan search jsonlib/1.0.0@
会显示二进制包的信息
conan upload(上传到私有制品库)
项目编译成功就可以上执行conan upload
传到私有制品库了:
conan upload jsonlib/1.0.0 -r ${repo} --all
# ${repo}为私有制品库的名字
–all 指定上传所有内容(配置文件conanfile.py,源码和二进制包),如果不指定些选项,只上传除二进制包之外的所有文件 关于
conan upload
命令的详细说明参见Conan官方文档:《conan upload》
上传成功进入JFrog Artifactory后台就可以看到已经上传的package
总结
上面一套流程做完,可以总结一下将一个conan封装项目执行Android NDK交叉编译的conan二进制包发布的过程:
开始麻烦些,需要准备profile(可复用),后面就很简单 :
conan create
完成交叉编译
conan upload
负责 conan包的上传发布
参考资料
《conan create》
《conan upload》
《Package scaffolding for conan new command》