XcodeDeps¶
XcodeDeps
工具是用于 Xcode 的依赖信息生成器。它将生成多个 .xcconfig 配置文件,这些文件可供使用 xcodebuild 或 Xcode 的消费者使用。要使用它们,只需将生成的配置文件添加到 Xcode 项目中,或从命令行设置 -xcconfig
参数。
XcodeDeps
生成器可以在 conanfiles 中按名称使用
class Pkg(ConanFile):
generators = "XcodeDeps"
[generators]
XcodeDeps
它也可以在 conanfile 的 generate()
方法中完全实例化
from conan import ConanFile
from conan.tools.apple import XcodeDeps
class Pkg(ConanFile):
settings = "os", "compiler", "arch", "build_type"
requires = "libpng/1.6.37@" # Note libpng has zlib as transitive dependency
def generate(self):
xcode = XcodeDeps(self)
xcode.generate()
当使用 XcodeDeps
生成器时,每次调用 conan install
都会为每个依赖项和配置生成多个配置文件。例如,对于上面的 conanfile.py
$ conan install conanfile.py # default is Release
$ conan install conanfile.py -s build_type=Debug
此生成器支持多配置。它会为每个需求的不同 Debug/Release 配置生成不同的文件。它还会生成一个单独的文件(conandeps.xcconfig),聚合所有直接依赖项的文件(本例中仅为 libpng)。上述命令生成以下文件
.
├── conan_config.xcconfig
├── conan_libpng.xcconfig
├── conan_libpng_libpng.xcconfig
├── conan_libpng_libpng_debug_x86_64.xcconfig
├── conan_libpng_libpng_release_x86_64.xcconfig
├── conan_zlib.xcconfig
├── conan_zlib_zlib.xcconfig
├── conan_zlib_zlib_debug_x86_64.xcconfig
├── conan_zlib_zlib_release_x86_64.xcconfig
└── conandeps.xcconfig
第一次使用默认 Release 和 x86_64 配置的 conan install
生成了
conan_libpng_libpng_release_x86_64.xcconfig:声明了带有条件逻辑的变量,这些变量仅在 Xcode 中或通过命令行传递给 xcodebuild 时,才针对活动配置进行考虑。
conan_libpng_libpng.xcconfig:包含 conan_libpng_libpng_release_x86_64.xcconfig 并声明以下 Xcode 构建设置:
SYSTEM_HEADER_SEARCH_PATHS
,GCC_PREPROCESSOR_DEFINITIONS
,OTHER_CFLAGS
,OTHER_CPLUSPLUSFLAGS
,FRAMEWORK_SEARCH_PATHS
,LIBRARY_SEARCH_PATHS
,OTHER_LDFLAGS
。它还包含为传递性依赖项生成的 xcconfig 文件(本例中为 conan_zlib_zlib.xcconfig)。conan_libpng.xcconfig:在这种情况下,它只包含 conan_libpng_libpng.xcconfig,但如果所需包包含组件,此文件将包含该包的所有组件。
图中每个依赖项都会生成相同的 3 个文件。在这种情况下,由于 zlib 是 libpng 的一个依赖项,它将生成:conan_zlib_zlib_release_x86_64.xcconfig、conan_zlib_zlib.xcconfig 和 conan_zlib.xcconfig。
conandeps.xcconfig:包含所有直接依赖项的配置文件,在这种情况下,它只包含
conan_libpng.xcconfig
。主 conan_config.xcconfig 文件,需要添加到项目中。它既包含此生成器生成的文件,也包含在设置了 XcodeToolchain 的情况下由其生成的文件。
第二次 conan install -s build_type=Debug
生成了
conan_libpng_libpng_debug_x86_64.xcconfig:与下面针对 Debug 配置的变量相同。
conan_libpng_libpng.xcconfig:此文件已由之前的命令创建,现在对其进行修改以添加对 conan_libpng_debug_x86_64.xcconfig 的包含。
conan_libpng.xcconfig:此文件将保持不变。
与之前的命令一样,图中每个依赖项都会生成相同的 3 个文件。在这种情况下,由于 zlib 是 libpng 的一个依赖项,它将生成:conan_zlib_zlib_debug_x86_64.xcconfig、conan_zlib_zlib.xcconfig 和 conan_zlib.xcconfig。
conandeps.xcconfig:包含所有直接依赖项的配置文件,在这种情况下,它只包含
conan_libpng.xcconfig
。主 conan_config.xcconfig 文件,需要添加到项目中。它既包含此生成器生成的文件,也包含在设置了 XcodeToolchain 的情况下由其生成的文件。
如果您想将这些依赖项添加到您的 Xcode 项目中,您只需为您想要使用的所有配置(通常是 Debug 和 Release)添加 conan_config.xcconfig 配置文件。
额外定义的变量¶
除了上面提到的定义 Xcode 构建设置的变量之外,还声明了一些额外的变量,这些变量可能对您的 Xcode 项目有用
PACKAGE_ROOT_<package_name>:设置为 package_folder 属性的位置。
组件支持¶
此生成器支持带有组件的包。这意味着
如果一个 依赖项
package_info()
在某些组件上声明了cpp_info.requires
,则生成的 .xcconfig 文件将仅包含这些组件的包含项。当前包的
requires
将完全依赖于所有组件。请注意,package_info()
仅适用于消费者,而不适用于当前包。
自定义配置¶
如果您的 Xcode 项目定义了自定义配置,例如 ReleaseShared
或 MyCustomConfig
,则可以将其定义到 XcodeDeps
生成器中,以便不同的项目配置可以使用不同的依赖项集。假设我们当前的项目可以作为共享库构建,使用自定义配置 ReleaseShared
,并且包也通过 shared
选项来控制这一点
from conan import ConanFile
from conan.tools.apple import XcodeDeps
class Pkg(ConanFile):
settings = "os", "compiler", "arch", "build_type"
options = {"shared": [True, False]}
default_options = {"shared": False}
requires = "zlib/1.3.1"
def generate(self):
xcode = XcodeDeps(self)
# We assume that -o *:shared=True is used to install all shared deps too
if self.options.shared:
xcode.configuration = str(self.settings.build_type) + "Shared"
xcode.generate()
这将生成用于此自定义配置的新 .xcconfig 文件,当您在 IDE 中切换到此配置时,构建系统将根据我们是想链接共享库还是静态库来获取正确的值。