Xcode@2 - Xcode 組建 v2 工作
使用此工作在macOS上建置 Xcode 工作區。
語法
# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
inputs:
actions: 'build' # string. Required. Actions. Default: build.
#configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
#sdk: '$(SDK)' # string. SDK. Default: $(SDK).
#xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
#scheme: # string. Scheme.
#packageApp: true # boolean. Create App Package. Default: true.
# Package Options
packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
#archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path.
#exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
#exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. Export Options. Default: auto.
#exportMethod: 'development' # string. Required when exportOptions == specify. Export Method. Default: development.
#exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID.
#exportOptionsPlist: # string. Required when exportOptions == plist. Export Options Plist.
# Signing & Provisioning
#xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
#teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID.
#signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
#iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity.
#unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
#defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password.
#provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID.
#p12: # string. Optional. Use when signMethod = file. P12 Certificate File.
#p12pwd: # string. Optional. Use when signMethod = file. P12 Password.
#provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File.
#removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
# Advanced
#args: # string. Arguments.
#cwd: # string. Working Directory.
outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
#xcodeDeveloperDir: # string. Xcode Developer Path.
#useXcpretty: false # boolean. Use xcpretty. Default: false.
#publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
# xctool (deprecated)
#useXctool: # boolean. Use xctool.
#xctoolReporter: # string. xctool Test Reporter Format.
輸入
actions
-
動作
string。 必須的。 預設值：build。
指定以空格分隔的動作清單。 有效的選項為 build、clean、test、analyze 和 archive。 例如，build clean 執行全新組建。 請參閱 Apple：使用 Xcode 常見問題從命令列建置。
configuration
-
組態
string。 預設值：$(Configuration)。
指定要建置的 Xcode 專案或工作區組態。 使用變數時，請在 Release] 索引標籤上指定值（例如，）。
sdk
-
SDK
string。 預設值：$(SDK)。
根據指定的 SDK 建置 Xcode 專案或工作區。 執行 xcodebuild -showsdks 以查看有效的 SDK 清單。
xcWorkspacePath
-
工作區/項目路徑
string。 預設值：**/*.xcodeproj/*.xcworkspace。
選擇性。 指定從存放庫根目錄到 Xcode 工作區或項目的相對路徑。 例如： MyApp/MyApp.xcworkspace 或 MyApp/MyApp.xcworkspace/MyApp.xcodeproj。
如果您要在 [進階自變數] 底下使用 -target flag，請保留空白。
scheme
-
方案
string。
選擇性。 指定 Xcode 設定名稱。 必須是共用配置（Xcode 中 Managed Schemes 底下的共用複選框）。 指定工作區時為必要專案。
packageApp
-
建立應用程式套件
boolean。 預設值：true。
指定IPA是否產生為組建的一部分。 若要使用 Xcode 7 和 Xcode 8 匯出封存，請檢閱 套件選項 區段中的其他輸入。
packageTool
-
使用 建立套件 （IPA）
string。 必須的。 允許的值：xcrun（xcrun（由 Apple 取代））、xcodebuild（xcodebuild 封存和匯出）。 預設值：xcodebuild。
指定要用來產生 IPA 的工具。
archivePath
-
封存路徑
string。 選擇性。
packageTool == xcodebuild時使用 。
指定放置已建立封存的目錄。
exportPath
-
匯出路徑
string。 選擇性。
packageTool == xcodebuild時使用 。 預設值：output/$(SDK)/$(Configuration)。
指定從封存匯出之產品的目的地。
exportOptions
-
匯出選項
string。 選擇性。
packageTool == xcodebuild時使用 。 允許的值：auto、plist、specify。 預設值：auto。
指定在匯出封存時傳入 匯出選項 的方式。
exportMethod
-
匯出方法
string。
exportOptions == specify時為必要項。 預設值：development。
指定 Xcode 用來匯出封存的方法。 例如，app-store、package、ad-hoc、enterprise或 development。
exportTeamId
-
小組標識碼
string。 選擇性。
exportOptions == specify時使用 。
指定要用於導出的Apple Developer Portal 10位數小組標識碼。
exportOptionsPlist
-
匯出選項 Plist
string。
exportOptions == plist時為必要項。
指定設定封存匯出之 plist 檔案的路徑。
xcode8AutomaticSigning
-
自動簽署
boolean。 預設值：false。
如果您有針對自動簽署設定的 Xcode 8 或 Xcode 9 專案，請使用此輸入。
teamId
-
小組標識碼
string。 選擇性。
xcode8AutomaticSigning = true時使用 。
指定10位數的開發人員小組標識碼。 如果您是多個開發小組的成員，則需要此專案。
使用覆寫 signMethod -
string。 允許的值：file（檔案內容）、id（標識符）。 預設值：file。
如果組建使用與預設值不同的簽署或布建方法，請使用此輸入。 選擇 [File Contents] 以使用 P12 憑證和布建配置檔。 選擇 [Identifiers]，從預設密鑰鏈和預安裝的配置檔擷取簽署設定。 如果您不想覆寫預設組建設定，請將對應的欄位保留空白。
iosSigningIdentity
-
簽署身分識別
string。 選擇性。
signMethod = id時使用 。
指定用來簽署組建的簽署身分識別覆寫。 預設為 Xcode 項目設定。 可能需要選取 [解除鎖定預設密鑰鏈]。
unlockDefaultKeychain
-
解除鎖定預設金鑰鏈
boolean。 選擇性。
signMethod = id時使用 。 預設值：false。
藉由解除鎖定預設密鑰鏈，解決 不允許使用者互動 錯誤。
defaultKeychainPassword
-
預設金鑰鏈密碼
string。 選擇性。
signMethod = id時使用 。
指定要解除鎖定預設金鑰鏈的密碼。
provProfileUuid
-
布建配置檔 UUID
string。 選擇性。
signMethod = id時使用 。
指定要用於組建的已安裝布建配置檔的 UUID。 使用具有不同配置或目標的個別建置工作，以在單一工作區中以目標指定布建配置檔（iOS、WatchKit、tvOS）。
p12
-
P12 憑證檔案
string。 選擇性。
signMethod = file時使用 。
指定 PKCS12 格式化 P12 憑證檔案的相對路徑，其中包含要用於組建的簽署憑證。
p12pwd
-
P12 密碼
string。 選擇性。
signMethod = file時使用 。
指定 P12 憑證檔案的密碼。如果指定的話。 使用組建變數來加密。
provProfile
-
布建配置檔案
string。 選擇性。
signMethod = file時使用 。
指定檔案的相對路徑，其中包含要用於組建的布建配置檔覆寫。 使用具有不同配置或目標的個別建置工作，以在單一工作區中以目標指定布建配置檔（iOS、WatchKit、tvOS）。
removeProfile
-
建置後移除配置檔
boolean。 選擇性。
signMethod = file時使用 。 預設值：false。
在建置完成之後，從組建代理程式移除布建配置檔檔的內容。 僅檢查您是否正在每個使用者執行一個代理程式。
args
-
自變數
string。
指定用來建置的其他命令行自變數。 如果您想要使用 -target 或 -project，而不是指定工作區和配置，則此輸入很有用。
cwd
-
工作目錄
string。
指定組建執行的工作目錄。 預設為存放庫的根目錄。
outputPattern
-
輸出目錄
string。 必須的。 預設值：output/$(SDK)/$(Configuration)。
指定建置輸出 （二進位檔） 放置位置的相對路徑。
xcodeDeveloperDir
-
Xcode 開發人員路徑
string。
選擇性。 如果不是系統預設值，則指定 Xcode Developer 資料夾的路徑。 在系統上安裝多個 Xcode 版本時使用。 例如： /Applications/Xcode 7.app/Contents/Developer 。
useXcpretty
-
使用 xcpretty
boolean。 預設值：false。
格式化 xcodebuild 輸出，併產生 JUnit 測試結果報告。 必須安裝在代理程式主機上。 深入瞭解 xcpretty。
publishJUnitResults
-
發佈至 VSTS/TFS
boolean。 預設值：false。
使用 xctool 所產生的 JUnit 測試結果會發佈至 VSTS/TFS。
useXctool
-
使用 xctool
boolean。
使用 xctool，而不是使用 xcodebuild。 必須安裝在代理程式主機上。 深入瞭解 xctool 。
注意：xctool 已被取代，且不適用於 Xcode 8。
xctoolReporter
-
xctool 測試記者格式
string。
測試指定 測試 動作時要使用的記者格式，並 檢查 [使用 xctool]。 指定 junit:output-file-path-here.xml，以產生與發行測試結果工作相容的檔格式。 指定時，會自動新增 一般。
xctool 必須安裝在代理程式主機上。 深入瞭解 xctool 。
注意：xctool 已被取代，且不適用於 Xcode 8。
工作控制選項
除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。
輸出變數
沒有。