xcodebuild编译参数有哪些常用选项？

下面我将详细梳理 xcodebuild 的编译参数，从核心命令到各种常用选项，并提供示例。

核心命令

xcodebuild 的基本语法结构如下：

xcodebuild [-project <project>] [-scheme <scheme>] [-target <target>] ... [action]

一个典型的构建命令会包含以下几个部分：

1. 指定项目/工作区：告诉 xcodebuild 要构建哪个 Xcode 项目或工作区。
2. 指定构建目标：明确要构建哪个 Scheme 或 Target。
3. 指定操作：要执行什么操作，build (构建), test (测试), archive (归档), analyze (静态分析) 等。
4. 指定选项：控制构建过程的各种参数，如配置、架构、代码签名等。

指定项目和目标

这些参数用于精确定位你要操作的项目和构建目标。

指定构建操作

这是 xcodebuild 命令的核心，告诉它要做什么。

核心编译与链接参数

这些参数直接控制编译器和链接器的行为,是自定义构建过程的关键。

代码签名与打包参数

这些参数在准备发布应用时至关重要。

输出与日志参数

综合示例

示例 1：基本构建（Debug，模拟器）

# 构建名为 "MyApp" 的 Scheme，配置为 Debug，目标为 iOS 模拟器
xcodebuild -workspace MyApp.xcworkspace -scheme MyApp -configuration Debug -sdk iphonesimulator build

示例 2：为所有架构构建并打包（用于 Ad Hoc 分发）

这个脚本会为 arm64 和 x86_64 架构分别构建，然后链接成一个通用二进制文件，并打包成 .ipa。

#!/bin/bash
# 定义变量
SCHEME="MyApp"
CONFIGURATION="Release"
WORKSPACE="MyApp.xcworkspace"
ARCHIVE_PATH="build/MyApp.xcarchive"
EXPORT_PATH="build/IPA"
EXPORT_OPTIONS_PLIST="ExportOptions-AdHoc.plist" # 这个plist文件需要提前准备好
# 清理旧构建
xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" clean
# 归档（xcodebuild会自动处理多架构）
xcodebuild archive \
  -workspace "$WORKSPACE" \
  -scheme "$SCHEME" \
  -configuration "$CONFIGURATION" \
  -archivePath "$ARCHIVE_PATH" \
  -allowProvisioningUpdates
# 检查归档是否成功
if [ $? -ne 0 ]; then
  echo "Archive failed"
  exit 1
fi
# 导出 IPA
xcodebuild -exportArchive \
  -archivePath "$ARCHIVE_PATH" \
  -exportPath "$EXPORT_PATH" \
  -exportOptionsPlist "$EXPORT_OPTIONS_PLIST"
# 检查导出是否成功
if [ $? -ne 0 ]; then
  echo "Export failed"
  exit 1
fi
echo "Build and export successful! IPA is at $EXPORT_PATH"

示例 3：在 CI 环境中构建并运行测试

# 在 CI 中，通常需要设置 CODE_SIGN_IDENTITY 和 PROVISIONING_PROFILE_SPECIFIER 为 "-"
# 表示禁用代码签名，因为 CI 服务器没有有效的证书和描述文件。
xcodebuild test \
  -project MyApp.xcodeproj \
  -scheme MyApp \
  -destination 'platform=iOS Simulator,name=iPhone 14 Pro,OS=latest' \
  -enableCodeCoverage YES \
  -codeSignIdentity "-" \
  -PROVISIONING_PROFILE_SPECIFIER "-"

掌握 xcodebuild 的关键在于理解其分层结构：

1. 定位：用 -workspace/-project 和 -scheme/-target 找到你要构建的东西。
2. 行动：用 build, test, archive 等命令告诉它要做什么。
3. 定制：用 -sdk, -arch, -configuration 等参数控制构建环境和类型。
4. 发布：用 -codeSignIdentity, -exportOptionsPlist 等参数处理签名和打包。

对于复杂的构建,建议从 Xcode 的 Product -> Scheme -> Edit Scheme 菜单中查看当前 Scheme 的配置，这能帮助你理解 xcodebuild 在后台执行的具体操作。