建置適用於 macOS 的 Objective-C 或 Swift 應用程式

重要

Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center,直到完全淘汰為止,但有數個建議的替代方案可以考慮移轉至。

深入瞭解支持時程表和替代方案。

若要開始建置您的第一個 Mac 應用程式,請執行下列步驟:

  1. (GitHub、Bitbucket、VSTS、Azure DevOps) 連線到您的存放庫服務帳戶。
  2. 選取您應用程式所在的存放庫和分支。
  3. 設定組建的專案或工作區,以及您想要建置的配置。

注意

若要散發應用程式,組建必須是使用憑證簽署的程序代碼。 布建配置檔是選擇性的。 此外,目前不支援 Mac 安裝程式的組建。

1.連結您的存放庫

您必須連線到您的存放庫服務帳戶。 一旦您的帳戶連線,請選取 Mac 專案所在的存放庫。 若要設定存放庫的組建,您需要管理員和提取許可權。

2.選取分支

選取存放庫之後,請選取您要建置的分支。 根據預設,所有作用中的分支都會列出。

3.設定您的第一個組建

第一次建置之前,必須先設定Mac專案。

3.1. 專案/工作區和配置

針對組建組態,需要 Xcode 專案或 Xcode 工作區和共用配置。 App Center 會自動偵測分支中的專案、工作區和共用配置。 選取您要建置的專案或工作區,以及對應的配置。

如果找不到配置,請確認您想要用來建置的配置已共用,且配置容器是您選取的專案或工作區。 此外,請確定這些變更已簽入您要設定組建的分支。

將配置標示為共享

3.2. Xcode 版本

選取要執行組建的 Xcode 版本。

3.3. 建置觸發程式

根據預設,每當開發人員推送至已設定的分支時,就會觸發新的組建。 這稱為「持續整合」。 如果您想要手動觸發新的組建,您可以在組建組態中變更此設定。

3.4. 遞增組建編號

啟用時, CFBundleVersion 應用程式 Info.plist 中的 會自動遞增每個組建。 變更會在建置前進行,且不會認可至您的存放庫。

3.5. 測試

如果選取的配置具有已選取測試目標的測試動作,您可以將測試設定為在每個組建中執行的一部分。 App Center 目前可執行 XCTest 單元測試。 App Center 不支援 Mac 組建的啟動測試。

3.6. 程式碼簽署

成功的建置會產生 .app 檔案。 若要在裝置上安裝組建,它必須經過簽署憑證。 若要簽署從分支產生的組建,請在組態窗格中啟用程式代碼簽署,並將 有效的憑證上傳 (.p12) ,以及憑證的密碼。 Xcode 專案中的設定必須與您要上傳的檔案相容。 布建配置檔是程式代碼簽署的選擇性。

App Center 目前僅支援這些簽署組態:

  • 僅使用開發導出方法搭配開發憑證手動簽署
  • 使用開發人員標識碼匯出方法手動簽署
  • 使用開發導出方法自動簽署

您可以在 App Center 的 macOS 程式代碼簽署指南官方 Apple 開發人員指南中深入瞭解程式代碼簽署。

3.7. CocoaPods

App Center 會掃描選取的分支,如果找到 Podfile,它就會在每個組建的開頭自動執行 pod install 步驟。 這可確保已安裝所有相依性。

如果存放庫已經包含 /Pods 資料夾,App Center 會假設您已存回存放庫中的 Pod,且不再執行 pod install

3.8. 散發至通訊群組

您可以將每個成功簽署的組建從分支設定為發佈至先前建立的通訊群組。 您可以從 [散發] 區段內新增通訊群組。 一律有一個名為「共同作業者」的預設通訊群組,其中包含可存取應用程式的所有使用者。

儲存設定之後,系統會自動啟動新的組建。

4.建置結果

觸發建置之後,它可以處於下列狀態:

  • queued - 組建已排入佇列,等候資源可用。
  • building - 組建正在執行預先定義的工作。
  • succeeded - 建置已順利完成。
  • failed - 組建發現導致無法完成的失敗。 您可以 下載並檢查組建記錄來針對組建進行疑難解答。
  • 已取消 - 組建已由用戶動作取消,或逾時。

4.1. 組建記錄

如需完成的建置 (成功或失敗) ,請下載記錄以深入瞭解組建的運作方式。 App Center 提供具有下列檔案的封存:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1> (e.g. 2_Get Sources.txt)
    |-- <build-step-2> (e.g. 3_Pod install.txt)
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

建置步驟特定記錄 (位於 build 封存) 的目錄中,有助於針對建置失敗的步驟和原因進行疑難解答和瞭解。

4.2. 應用程式 (.app)

檔案 .app 是 Mac 應用程式封存盤案,其中包含 Mac 應用程式。

  • 如果組建正確簽署, .app 檔案可以安裝在對應到簽署時所使用的布建配置檔的裝置上。 如需有關 App Center 程式代碼簽署和散發的詳細資訊,請參閱 App Center 的 macOS 程式代碼簽署檔
  • 如果組建尚未簽署, .app 開發人員就可以簽署檔案。 例如,使用codeign。

4.3. 符號檔案 (.dsym)

檔案 .dsym 包含應用程式的偵錯符號。

  • 如果您已在應用程式中新增已啟用當機報告模組的 App Center SDK,當機報告服務需要此 .dsym 檔案,組建才能顯示人類可讀 (符號化) 當機報告。
  • 如果您已在應用程式中新增另一個 SDK 來報告當機,例如 HockeyApp SDK,服務會要求 .dsym 檔案顯示人類可讀取的當機報告。

簽署的程式代碼.app時,檔案.dsym不會變更。 如果您稍後決定程式代碼簽署組建, .dsym 則程式代碼簽署之前產生的 仍然有效。

建置內部

為了建置您的項目,我們使用 xcodebuild的命令行工具可讓您建置、查詢、分析、測試及封存您的 Xcode 專案和工作區。

支援的版本和需求

每次新增新版本的 macOS 時,都會更新組建計算機版本詳細數據。 我們會在組建 VM 上儘快包含 Apple 發行的最新版本。