XcodeToolchain

XcodeToolchain 是 Xcode 的工具链生成器。它将生成可以添加到 Xcode 项目的 .xcconfig 配置文件。此生成器将当前包配置、设置和选项转换为 Xcode .xcconfig 文件语法。

XcodeToolchain 生成器可以在 conanfiles 中按名称使用

conanfile.py
class Pkg(ConanFile):
    generators = "XcodeToolchain"
conanfile.txt
[generators]
XcodeToolchain

它也可以在 conanfile 的 generate() 方法中完全实例化

from conan import ConanFile
from conan.tools.apple import XcodeToolchain

class App(ConanFile):
    settings = "os", "arch", "compiler", "build_type"

    def generate(self):
        tc = XcodeToolchain(self)
        tc.generate()

XcodeToolchain 在执行 conan install 命令后将生成三个文件。如上文 XcodeDeps 生成器所述,每种不同的配置都将创建一组具有不同名称的文件。例如,首先为 Release 然后为 Debug 配置运行 conan install

$ conan install conanfile.py # default is Release
$ conan install conanfile.py -s build_type=Debug

将创建这些文件

.
├── conan_config.xcconfig
├── conantoolchain_release_x86_64.xcconfig
├── conantoolchain_debug_x86_64.xcconfig
├── conantoolchain.xcconfig
└── conan_global_flags.xcconfig

这些文件是

  • conan_config.xcconfig 文件,将添加到项目中。它包含来自此生成器的文件,以及在 XcodeDeps 也已设置时由其生成的文件。

  • conantoolchain_<debug/release>_x86_64.xcconfig:声明 CLANG_CXX_LIBRARYCLANG_CXX_LANGUAGE_STANDARDMACOSX_DEPLOYMENT_TARGET (当 os 设置为 Macos 时) 变量,这些变量具有取决于构建配置、架构和已设置的 SDK 的条件逻辑。

  • conantoolchain.xcconfig:聚合所有针对不同已安装配置的 conantoolchain_<config>_<arch>.xcconfig 文件。

  • conan_global_flags.xcconfig:仅当设置了与编译器或链接器标志相关的任何配置变量时,才会生成此文件。有关更多详细信息,请查看下方的配置部分

每次以不同配置调用 conan install 都将创建一个新的 conantoolchain_<config>_<arch>.xcconfig 文件,该文件会聚合到 conantoolchain.xcconfig 中,这样你就可以在 Xcode 项目中包含不同的配置。

XcodeToolchain 文件可以根据 Conan 设置值声明以下 Xcode 构建设置

  • *_DEPLOYMENT_TARGET 基于 os + os.version 设置的值,并将使构建系统传递相应标志(例如,MACOSX_DEPLOYMENT_TARGET 对于 macOS 转换为 -mmacosx-version-min),并带上该值(如果已设置)。它定义了二进制文件应运行的最低操作系统版本。

  • CLANG_CXX_LANGUAGE_STANDARD 基于 compiler.cppstd 设置的值,该设置定义了 C++ 语言标准。

  • CLANG_CXX_LIBRARY 基于 compiler.libcxx 设置的值,并定义要使用的 C++ 标准库版本。

使用工具链的优点之一是,它们有助于在本地开发流程中实现与在缓存中创建包时完全相同的构建。

conf

此工具链也受这些 [conf] 变量的影响

  • tools.build:cxxflags C++ 标志列表。

  • tools.build:cflags 纯 C 标志列表。

  • tools.build:sharedlinkflags 链接器在创建共享库时将使用的标志列表。

  • tools.build:exelinkflags 链接器在创建可执行文件时将使用的标志列表。

  • tools.build:defines 预处理器定义列表。

如果你设置了这些变量中的任何一个,工具链将使用它们来生成 conan_global_flags.xcconfig 文件,该文件将从 conan_config.xcconfig 文件中包含。