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")
参考¶
- 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
是配置,通常是 Release 或 Debug,将从settings.build_type
获取。architecture
是构建架构,它是将settings.arch
映射到 Apple 定义的常见架构,如 'i386'、'x86_64'、'armv7'、'arm64' 等。sdk
根据os.sdk
和os.sdk_version
的值设置,并据此定义SDKROOT
Xcode 构建设置。例如,设置os.sdk=iOS
和 os.sdk_version=8.3` 将向构建系统传递SDKROOT=iOS8.3
。如果您在 [conf] 中定义了tools.apple:sdk_path
,则此值将优先,并将直接传递SDKROOT=<tools.apple:sdk_path>
,因此 请注意,在这种情况下,位于该路径的 SDK 应设置您的os.sdk
和os.sdk_version
设置值。verbosity
是构建的详细程度,如果在您的 [conf] 中通过tools.build:verbosity
设置,则可取值“verbose”或“quiet”。
传递给 xcodebuild
的附加参数
根据配置文件中
os
和os.version
的值设置部署目标,例如MACOSX_DEPLOYMENT_TARGET=10.15
或IPHONEOS_DEPLOYMENT_TARGET=15.0
conf¶
tools.build:verbosity
(或作为备用tools.compilation:verbosity
)接受quiet
或verbose
,并在XcodeBuild.install()
中设置-verbose
或-quiet
标志。tools.apple:sdk_path
SDK 位置的路径,将优先设置SDKROOT
值,而不是从os.sdk
和os.sdk_version
设置中组合该值。