xcodebuild 是 Xcode 提供的一个强大的命令行工具，用于在命令行环境下编译、测试和打包 iOS、macOS、watchOS 和 tvOS 等项目。

xcodebuild 是 Xcode 提供的一个强大的命令行工具，用于在命令行环境下编译、测试和打包 iOS、macOS、watchOS 和 tvOS 等项目。以下是关于 xcodebuild 命令行工具的详细使用说明：

基本语法

 

bash

 

 

 

 

xcodebuild [-project <projectname>] [-target <targetname>]... [<buildsetting>=<value> ...] [<action>]

常用参数及选项

项目指定参数

• -project <projectname>：指定 Xcode 项目文件（.xcodeproj）的路径。例如：

 

bash

 

 

 

 

xcodebuild -project MyApp.xcodeproj

• -workspace <workspacename>：指定 Xcode 工作区文件（.xcworkspace）的路径。如果项目使用了 CocoaPods 或其他依赖管理工具，通常需要使用工作区。例如：

 

bash

 

 

 

 

xcodebuild -workspace MyApp.xcworkspace

目标指定参数

• -target <targetname>：指定要构建的目标。一个项目可能包含多个目标，如应用程序、测试目标等。例如：

 

bash

 

 

 

 

xcodebuild -project MyApp.xcodeproj -target MyApp

• -scheme <schemename>：指定要使用的 Scheme。Scheme 定义了构建、运行、测试等操作的配置。例如：

 

bash

 

 

 

 

xcodebuild -workspace MyApp.xcworkspace -scheme MyAppScheme

构建配置参数

• -configuration <configurationname>：指定构建配置，如 Debug 或 Release。默认值为 Debug。例如：

 

bash

 

 

 

 

xcodebuild -project MyApp.xcodeproj -target MyApp -configuration Release

设备和平台参数

• -destination <destination>：指定构建和运行的目标设备或模拟器。可以使用多种方式指定目标，例如：
  • 模拟器：platform=iOS Simulator,name=iPhone 14
  • 真机：platform=iOS,id=<device_id>

 

bash

 

 

 

 

xcodebuild -project MyApp.xcodeproj -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 14'

常用操作（Actions）

构建项目

使用 build 操作来编译项目。例如：

 

bash

 

 

 

 

xcodebuild -project MyApp.xcodeproj -scheme MyApp -configuration Release -destination 'platform=iOS Simulator,name=iPhone 14' build

清理项目

使用 clean 操作来清理项目的构建产物。例如：

 

bash

 

 

 

 

xcodebuild -project MyApp.xcodeproj -scheme MyApp clean

运行测试

使用 test 操作来运行项目的测试用例。例如：

 

bash

 

 

 

 

xcodebuild -project MyApp.xcodeproj -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 14' test

打包应用

使用 archive 操作来打包应用，生成 .xcarchive 文件。例如：

 

bash

 

 

 

 

xcodebuild -workspace MyApp.xcworkspace -scheme MyApp -configuration Release -archivePath ~/Desktop/MyApp.xcarchive archive

导出 IPA 文件

在完成打包后，可以使用 xcodebuild -exportArchive 命令将 .xcarchive 文件导出为 .ipa 文件。例如：

 

bash

 

 

 

 

xcodebuild -exportArchive -archivePath ~/Desktop/MyApp.xcarchive -exportOptionsPlist exportOptions.plist -exportPath ~/Desktop/MyAppExport

其中，exportOptions.plist 是一个包含导出选项的配置文件，示例内容如下：

 

xml

 

 

 

 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>method</key>
    <string>app-store</string>
    <key>teamID</key>
    <string>YOUR_TEAM_ID</string>
</dict>
</plist>

其他常用选项

• -verbose：显示详细的构建日志，有助于调试构建过程中的问题。例如：

 

bash

 

 

 

 

xcodebuild -project MyApp.xcodeproj -scheme MyApp -verbose build

• -quiet：安静模式，只显示必要的信息，减少输出。

总结

xcodebuild 命令行工具提供了丰富的功能，可以满足不同场景下的项目构建、测试和打包需求。通过合理组合参数和操作，可以实现自动化的开发流程。