XcodeBuild

XcodeBuild 构建助手是 Xcode 命令行调用的包装器。它将抽象化诸如 xcodebuild -project app.xcodeproj -configuration <config> -arch <arch> ... 之类的调用。

XcodeBuild 助手可以像这样使用:

from conan import conanfile
from conan.tools.apple import XcodeBuild

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

    def build(self):
        xcodebuild = XcodeBuild(self)
        xcodebuild.build("app.xcodeproj")

参考

class XcodeBuild(conanfile)
__init__(conanfile)
XcodeBuild.build(xcodeproj, target=None)

调用 xcodebuild 来构建 Xcode 项目。

参数:
  • xcodeproj – 要构建的 xcodeproj 文件。

  • target – 要构建的目标。如果此参数传递给 build() 方法,它将在构建系统调用中添加 -target 参数。如果未传递,它将构建所有目标,转而传递 -alltargets 参数。

返回:

启动的 xcodebuild 命令的返回码。

Xcode.build() 方法内部实现了一个对 xcodebuild 的调用,如下所示:

$ xcodebuild -project app.xcodeproj -configuration <configuration> -arch <architecture> <sdk> <verbosity> -target <target>/-alltargets *_DEPLOYMENT_TARGET=settings.os.version

其中

  • configuration 是配置,通常是 ReleaseDebug,将从 settings.build_type 获取。

  • architecture 是构建架构,它是将 settings.arch 映射到 Apple 定义的常见架构,如 'i386'、'x86_64'、'armv7'、'arm64' 等。

  • sdk 根据 os.sdkos.sdk_version 的值设置,并据此定义 SDKROOT Xcode 构建设置。例如,设置 os.sdk=iOSos.sdk_version=8.3` 将向构建系统传递 SDKROOT=iOS8.3。如果您在 [conf] 中定义了 tools.apple:sdk_path,则此值将优先,并将直接传递 SDKROOT=<tools.apple:sdk_path>,因此 请注意,在这种情况下,位于该路径的 SDK 应设置您的 os.sdkos.sdk_version 设置值。

  • verbosity 是构建的详细程度,如果在您的 [conf] 中通过 tools.build:verbosity 设置,则可取值“verbose”或“quiet”。

传递给 xcodebuild 的附加参数

  • 根据配置文件中 osos.version 的值设置部署目标,例如 MACOSX_DEPLOYMENT_TARGET=10.15IPHONEOS_DEPLOYMENT_TARGET=15.0

conf

  • tools.build:verbosity(或作为备用 tools.compilation:verbosity)接受 quietverbose,并在 XcodeBuild.install() 中设置 -verbose-quiet 标志。

  • tools.apple:sdk_path SDK 位置的路径,将优先设置 SDKROOT 值,而不是从 os.sdkos.sdk_version 设置中组合该值。