测试 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 库的最小示例。

test_package/src/example.cpp¶

#include "hello.h"

int main() {
    hello();
}

然后是 CMakeLists.txt 文件，用于告诉 CMake 如何构建示例。

test_package/CMakeLists.txt¶

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)

最后，是 test_package 的配方，它使用 hello/1.0 Conan 包。

test_package/conanfile.py¶

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。
- 我们使用 Conan 放入运行环境中的环境信息运行在 self.cpp.build.bindir 文件夹中生成的示例二进制文件。然后，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 包
…