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

Posted 2022-02-23 10km

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

Conan 是 C 和 C++ 语言的依赖项和包管理器。它是免费和开源的，适用于所有平台（Windows、Linux、OSX、FreeBSD、Solaris 等），可用于开发所有目标，包括嵌入式、移动（ios、android）和裸机。它还与 CMake、Visual Studio (MSBuild)、Makefiles、SCons 等所有构建系统集成，包括专有系统。
它专为加速 C 和 C++ 项目的开发和持续集成而设计和优化。通过完整的二进制包管理，它可以为任意数量的不同版本的包创建和重用任意数量的不同二进制文件（用于不同的配置，如架构、编译器版本等），在所有平台上使用完全相同的过程。由于它是去中心化的，因此很容易运行自己的服务器来私下托管自己的包和二进制文件，而无需共享它们。@《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》

conan系列文章

《conan入门(一):conan 及 JFrog Artifactory 安装》
《conan入门(二)：conan 服务配置-密码管理及策略》
《conan入门(三):上传预编译的库(artifact)》
《conan入门(四):conan 引用第三方库示例》
《conan入门(五):conan 交叉编译引用第三方库示例》
《conan入门(六):conanfile.txt conanfile.py的区别》
《conan入门(七):将自己的项目生成conan包》
《conan入门(八):交叉编译自己的conan包项目》