conan入门(八):交叉编译自己的conan包项目

conan 交叉编译自己的conan包项目

上一篇博客《conan入门(七):将自己的项目生成conan包》中我们以jsonlib为例说明了如何将自己的模块封装成conan提供给第三方使用。

那是比较简单的一种编译本机目标代码的应用场景(编译环境是Windows,目标代码也是Windows平台)。在物联应用的大背景下，C/C++开发中跨平台交叉编译的应用是非常广泛的。在使用conan来管理C/C++包(制品库)的环境下，如何实现对conan包封装的项目实现交叉编译的支持呢？因为我的工作涉及不少嵌入式平台的开发，conan对交叉编译的支持是我最关心的部分。

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

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来实现的。

TOOLCHAIN_FILE

要实现交叉首先要定义好工具链文件，我有一个DS-5 ARM的交叉编译器(arm-linux-gnueabihf)。已经写好了交叉编译工具链文件

conan_example/cmake/ds5-arm-linux-gnueabihf.toolchain.cmake

我们需要通过定义环境变量CONAN_CMAKE_TOOLCHAIN_FILE指定工具链文件

$ export CONAN_CMAKE_TOOLCHAIN_FILE=/j/conan_example/cmake/ds5-arm-linux-gnueabihf.toolchain.cmake

关于CONAN_CMAKE_TOOLCHAIN_FILE及其他conan环境变量定义更详细说明参见Conan官方文档《Environment variables》

conan install(交叉编译jsonlib)

创建了conanfile.py后，编译conan包非常简单

# 注意是 conan_example jsonlib分支
$ cd conan_example
# 将conan包（conanfile.py 和相关文件,不包括编译生成的二进制包）复制到本地仓库。
$ conan export .
$ conan install . -s os=Linux -s arch=armv7 -s compiler=gcc -s compiler.version=4.8 --build missing -pr:b default

conan install .根据配置文件 (同级文件夹下的conanfile.py) 构建二进制包 -s os=Linux -s arch=armv7 -s compiler=gcc -s compiler.version=4.8 指定交叉编译的目标平台编译器及版本 -pr:b default 指定使用名为default的profile文件 –build missing 如果依赖包中没有找到预编译的二进制包则从源码编译 –build 的可选值(可多个组合): ​ --build never 禁止编译依赖包,只下载预编译的二进制包,如果没找到预编译包则报错[不可与其他可选值组合] ​ --build missing 如果依赖包中没有找到预编译的二进制包则从源码编译 ​ --build outdated 如果依赖包中没有找到预编译的二进制包或过期(日期旧于源码)则从源码编译 ​ --build cascade ​ --build [pattern] 编译包名匹配[pattern]的所有包 ​ --build ![pattern] 编译包名匹配[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 create

上面执行交叉编译jsonlib使用了两条命令conan exoprt 和conan install

其实可以用一条conan create命令来代替完成

根据Conan官方文档《conan create》的说明，conan create等价于

$ conan export . 
$ conan install jsonlib/1.0.0@ --build jsonlib
# package is created now, use test to test it
$ cd test_package
$ conan test . jsonlib/1.0.0@

也就是说执行conan create相当执行了conan export,conan install,conan test三条命令

在交叉编译环境下不能执行测试命令conan test

所以可以通过增加--test-folder None参数指定不执行测试命令就可以达到与执行两条命令conan exoprt 和conan install一样的效果:

$ conan create . --test-folder None

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封装项目生成交叉编译的conan二进制包发布的过程：

开始麻烦些，需要工具链文件,并设置环境变量CONAN_CMAKE_TOOLCHAIN_FILE。

后面就很简单 :

conan export 将conan包 复制到本地仓库

conan install 完成conan 二进制包交叉编译

或直接用 conan create . --test-folder None代替上面两条命令

conan upload 负责 conan包的上传发布

参考资料

《conan export》

《conan install》

《conan upload》

《Package scaffolding for conan new command》