测试 Conan 包¶
在教程的所有先前部分中,我们使用了 test_package。在构建我们的包并验证包是否正确创建后,它会在 conan create
命令结束时自动调用。让我们在本节中更详细地解释 test_package
请先克隆源代码以重新创建此项目。您可以在 GitHub 上的 examples2 仓库 中找到它们
$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/tutorial/creating_packages/testing_packages
关于 test_package 需要牢记的一些重要说明
test_package 文件夹与单元测试或集成测试不同。这些测试是“包”测试,并验证包是否已正确创建,以及包使用者是否能够链接到它并重用它。
它本身就是一个小型 Conan 项目,它包含自己的 conanfile.py 和源代码(包括构建脚本),这些脚本依赖于正在创建的包,并构建和执行一个需要包中库的小型应用程序。
它不属于包。它只存在于源代码存储库中,而不是包中。
test_package 文件夹是默认文件夹,但可以在命令行
--test-folder
参数或使用test_package_folder
配方属性中定义不同的文件夹。
我们 hello/1.0 Conan 包的 test_package 文件夹具有以下内容
test_package
├── CMakeLists.txt
├── conanfile.py
└── src
└── example.cpp
让我们看一下 test_package 中的不同文件。首先,example.cpp 只是我们正在打包的 libhello 库使用方法的最小示例
#include "hello.h"
int main() {
hello();
}
然后是 CMakeLists.txt 文件,用于告诉 CMake 如何构建示例
cmake_minimum_required(VERSION 3.15)
project(PackageTest CXX)
find_package(hello CONFIG REQUIRED)
add_executable(example src/example.cpp)
target_link_libraries(example hello::hello)
最后,使用 hello/1.0 Conan 包的 test_package 的配方
import os
from conan import ConanFile
from conan.tools.cmake import CMake, cmake_layout
from conan.tools.build import can_run
class helloTestConan(ConanFile):
settings = "os", "compiler", "build_type", "arch"
generators = "CMakeDeps", "CMakeToolchain"
def requirements(self):
self.requires(self.tested_reference_str)
def build(self):
cmake = CMake(self)
cmake.configure()
cmake.build()
def layout(self):
cmake_layout(self)
def test(self):
if can_run(self):
cmd = os.path.join(self.cpp.build.bindir, "example")
self.run(cmd, env="conanrun")
让我们浏览最相关的部分
我们在
requirements()
方法中添加了需求,但在这种情况下,我们使用 Conan 设置的tested_reference_str
属性传递给 test_package。这是一个方便的属性,用于避免在 test_package 中硬编码包名称,以便我们可以对同一个 Conan 包的多个版本重复使用相同的 test_package。在我们的例子中,此变量将取hello/1.0
值。我们定义了一个
test()
方法。此方法仅在 test_package 配方中调用。它在调用build()
后立即执行,旨在对二进制文件运行一些可执行文件或测试,以证明包已正确创建。关于我们test()
方法内容的一些说明我们使用 conan.tools.build.cross_building 工具来检查我们是否可以在我们的平台上运行构建的可执行文件。此工具将返回
tools.build.cross_building:can_run
的值(如果已设置)。否则,它将返回我们是否正在进行交叉构建。对于您的架构可以运行多个目标的情况,这是一个有用的功能。例如,Mac M1 机器可以运行 armv8 和 x86_64。我们运行示例二进制文件,该文件是在
self.cpp.build.bindir
文件夹中使用 Conan 放入运行环境中的环境信息生成的。然后,Conan 将调用一个包含运行时环境信息的启动器,任何环境运行编译的可执行文件和应用程序所需的内容。
现在我们已经了解了代码的所有重要部分,让我们尝试一下我们的 test_package。尽管我们已经了解到在调用 conan create
时会调用 test_package,但如果您已经在 Conan 缓存中创建了 hello/1.0
包,您也可以只创建 test_package。这可以通过 conan test 命令完成
$ conan test test_package hello/1.0
...
-------- test_package: Computing necessary packages --------
Requirements
fmt/8.1.1#cd132b054cf999f31bd2fd2424053ddc:ff7a496f48fca9a88dc478962881e015f4a5b98f#1d9bb4c015de50bcb4a338c07229b3bc - Cache
hello/1.0#25e0b5c00ae41ef9fbfbbb1e5ac86e1e:fd7c4113dad406f7d8211b3470c16627b54ff3af#4ff3fd65a1d37b52436bf62ea6eaac04 - Cache
Test requirements
gtest/1.11.0#d136b3379fdb29bdfe31404b916b29e1:656efb9d626073d4ffa0dda2cc8178bc408b1bee#ee8cbd2bf32d1c89e553bdd9d5606127 - Skip
...
[ 50%] Building CXX object CMakeFiles/example.dir/src/example.cpp.o
[100%] Linking CXX executable example
[100%] Built target example
-------- Testing the package: Running test() --------
hello/1.0 (test package): Running test()
hello/1.0 (test package): RUN: ./example
hello/1.0: Hello World Release! (with color!)
正如您在输出中看到的,我们的 test_package 成功构建,测试 hello/1.0 Conan 包可以毫无问题地使用。
另请参阅
测试 tool_requires 包
…