上一篇博客《conan入门(七):将自己的项目生成conan包》中我们以jsonlib为例说明了如何将自己的模块封装成conan提供给第三方使用。
那是比较简单的一种编译本机目标代码的应用场景(编译环境是Windows,目标代码也是Windows平台)。在物联应用的大背景下,C/C++开发中跨平台交叉编译的应用是非常广泛的。在使用conan来管理C/C++包(制品库)的环境下,如何实现对conan包封装的项目实现交叉编译的支持呢?因为我的工作涉及不少嵌入式平台的开发,conan对交叉编译的支持是我最关心的部分。
本文还以 jsonlib 为例,说明如何将自己的封装成conan的模块实现交叉编译。
示例的所有源码都保存在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来实现的。
要实现交叉首先要定义好工具链文件,我有一个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》
创建了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@
会显示二进制包的信息
上面执行交叉编译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 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包的上传发布