定义提供多个库的 Conan 包的组件

在 关于 package_info() 方法的教程部分，我们学习了如何在包中定义供消费者使用的信息，例如库名称或包含和库文件夹。在教程中，我们创建了一个只有一个库的包，供消费者链接。但是，在某些情况下，库将其功能分成不同的组件。这些组件可以独立使用，并且在某些情况下，它们可能需要来自同一库或其他库的其他组件。例如，考虑像 OpenSSL 这样的库，它提供 libcrypto 和 libssl，其中 libssl 依赖于 libcrypto。

Conan 提供了一种使用 CppInfo 对象的 components 属性来抽象此信息的方法，以定义 Conan 包的每个单独组件的信息。消费者也可以选择特定的组件进行链接，而不是整个包。

让我们以一个游戏引擎库为例，它提供几个组件，例如 algorithms（算法）、ai（人工智能）、rendering（渲染）和 network（网络）。ai 和 rendering 都依赖于 algorithms 组件。

digraph components { node [fillcolor="lightskyblue", style=filled, shape=box] algorithms -> ai; algorithms -> rendering; ai; algorithms; network; }

游戏引擎包的组件

请首先克隆源代码以重新创建此项目。您可以在 GitHub 的 examples2 仓库中找到它们。

$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/examples/conanfile/package_info/components

您可以查看项目的目录结构

.
├── CMakeLists.txt
├── conanfile.py
├── include
│   ├── ai.h
│   ├── algorithms.h
│   ├── network.h
│   └── rendering.h
├── src
│   ├── ai.cpp
│   ├── algorithms.cpp
│   ├── network.cpp
│   └── rendering.cpp
└── test_package
    ├── CMakeLists.txt
    ├── CMakeUserPresets.json
    ├── conanfile.py
    └── src
        └── example.cpp

如您所见，每个组件都有源代码，以及一个 CMakeLists.txt 文件来构建它们。我们还有一个 test_package，我们将使用它来测试单独组件的消耗。

首先，让我们看一下 conanfile.py 中的 package_info() 方法，以及我们如何声明要提供给游戏引擎包消费者的每个组件的信息

...

def package_info(self):
    self.cpp_info.components["algorithms"].libs = ["algorithms"]
    self.cpp_info.components["algorithms"].set_property("cmake_target_name", "algorithms")

    self.cpp_info.components["network"].libs = ["network"]
    self.cpp_info.components["network"].set_property("cmake_target_name", "network")

    self.cpp_info.components["ai"].libs = ["ai"]
    self.cpp_info.components["ai"].requires = ["algorithms"]
    self.cpp_info.components["ai"].set_property("cmake_target_name", "ai")

    self.cpp_info.components["rendering"].libs = ["rendering"]
    self.cpp_info.components["rendering"].requires = ["algorithms"]
    self.cpp_info.components["rendering"].set_property("cmake_target_name", "rendering")

有几点需要注意

  • 我们通过在 cpp_info.components 属性中设置信息来声明每个组件生成的库。您可以为每个组件设置与为 self.cpp_info 对象设置信息相同的信息。与 self.cpp_info 一样，cpp_info 对象也具有一些默认定义。例如，cpp_info.components 对象提供 .includedirs 和 .libdirs 属性来定义这些位置，但 Conan 默认将它们的值设置为 ["lib"] 和 ["include"]，因此在这种情况下无需添加它们。

  • 我们还使用 .requires 属性声明组件的依赖项。使用此属性，您可以声明组件级别的要求，不仅针对同一配方中的组件，还针对声明为 Conan 包要求的其他包的组件。

  • 我们使用 属性模型 更改组件的默认目标名称。默认情况下，Conan 为组件设置类似 <package_name::component_name> 的目标名称，但对于本教程，我们将组件目标名称设置为仅使用组件名称，省略 ::。

  • 当 cpp_info 具有全局构建信息（例如 cpp_info.defines）时，它不会继承到组件。如果您想与组件共享此信息，则需要显式地为每个组件设置它。

您可以查看消费者部分，方法是检查 test_package 文件夹。首先是 conanfile.py

...

def generate(self):
    deps = CMakeDeps(self)
    deps.check_components_exist = True
    deps.generate()

您可以看到我们正在为 CMakeDeps 设置 check_components_exist 属性。这并非必需，只是为了展示您如果希望消费者在组件不存在时失败可以这样做。因此，CMakeLists.txt 的外观如下

cmake_minimum_required(VERSION 3.15)
project(PackageTest CXX)

find_package(game-engine REQUIRED COMPONENTS algorithms network ai rendering)

add_executable(example src/example.cpp)

target_link_libraries(example algorithms
                              network
                              ai
                              rendering)

如果任何组件目标不存在，则 find_package() 调用将失败。

让我们运行示例

$ conan create .
...
game-engine/1.0: RUN: cmake --build "/Users/barbarian/.conan2/p/t/game-d6e361d329116/b/build/Release" -- -j16
[ 12%] Building CXX object CMakeFiles/algorithms.dir/src/algorithms.cpp.o
[ 25%] Building CXX object CMakeFiles/network.dir/src/network.cpp.o
[ 37%] Linking CXX static library libnetwork.a
[ 50%] Linking CXX static library libalgorithms.a
[ 50%] Built target network
[ 50%] Built target algorithms
[ 62%] Building CXX object CMakeFiles/ai.dir/src/ai.cpp.o
[ 75%] Building CXX object CMakeFiles/rendering.dir/src/rendering.cpp.o
[ 87%] Linking CXX static library libai.a
[100%] Linking CXX static library librendering.a
[100%] Built target ai
[100%] Built target rendering
...

======== Launching test_package ========

...
-- Conan: Component target declared 'algorithms'
-- Conan: Component target declared 'network'
-- Conan: Component target declared 'ai'
-- Conan: Component target declared 'rendering'
...
[ 50%] Building CXX object CMakeFiles/example.dir/src/example.cpp.o
[100%] Linking CXX executable example
[100%] Built target example


======== Testing the package: Executing test ========
game-engine/1.0 (test package): Running test()
game-engine/1.0 (test package): RUN: ./example
I am the algorithms component!
I am the network component!
I am the ai component!
└───> I am the algorithms component!
I am the rendering component!
└───> I am the algorithms component!

您可以检查需要不存在的组件将引发错误。将 nonexistent 组件添加到 find_package() 调用

cmake_minimum_required(VERSION 3.15)
project(PackageTest CXX)

find_package(game-engine REQUIRED COMPONENTS nonexistent algorithms network ai rendering)

add_executable(example src/example.cpp)

target_link_libraries(example algorithms
                              network
                              ai
                              rendering)

然后再次测试包

$ conan test test_package game-engine/1.0

...

Conan: Component 'nonexistent' NOT found in package 'game-engine'
Call Stack (most recent call first):
CMakeLists.txt:4 (find_package)

-- Configuring incomplete, errors occurred!

...

ERROR: game-engine/1.0 (test package): Error in build() method, line 22
        cmake.configure()
        ConanException: Error 1 while executing

另请参阅

如果您想使用定义了组件的配方在 editable 模式下，请查看 使用组件和可编辑包 中的示例。