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

Posted 2022-02-23 10km

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

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

上一篇博客《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 ![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 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》

conan系列文章

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