conan入门(九):NDK交叉编译自己的conan包项目塈profile的定义

conan NDK交叉编译自己的conan包项目塈profile的定义

上一篇博客《conan入门(八):交叉编译自己的conan包项目》中我们以jsonlib为例说明了如何将交叉编译自己封装成conan的模块。但是使用的DS-5 ARM的交叉编译器(arm-linux-gnueabihf)并不常见，也不方便读者实际操作。

本文还以 jsonlib 为例,说明如何将自己的封装成conan的模块使用Android NDK实现交叉编译。

jsonlib示例程序

示例的所有源码都保存在GIT仓库 conan_example的jsonlib分支,请直接克隆代码到本地：

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体系，编译器及版本都是通过命令行参数传递的，每次执行都要输入这么多参数也真是挺辛苦的。

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

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包非常简单

# 注意是 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》