將 App Center 組建組態導出至 Azure Pipelines
重要
Visual Studio App Center 定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center,直到它完全淘汰為止,但有數個建議您考慮移轉至的建議替代方案。
概觀
使用 App Center,您可以使用建置導出功能,將所有 App Center 組建組態導出至 Azure Pipelines。 您可以下載 JSON 或 YAML 檔案,並將其匯入 Azure Pipelines。
雖然將 App Center 組建組態直接移轉至 Azure Pipelines 是最簡單的選項,但可能無法針對您的特定應用程式進行優化。 請考慮從頭建置 Azure Pipelines 以取得更優化的體驗(Android、Xcode、Xamarin)
必要條件
您將需要 Azure DevOps 專案,您可以在其中匯入組建組態。 您可以建立新專案或使用現有的專案。
(選擇性)新增 App Center 工作的服務連線
如果您已將App Center測試或App Center散發整合到組建組態中,則必須建立服務連線
- 流覽至 Azure DevOps 專案設定 -> 管線 -> 服務連線
- 選取 [新增服務連線]
- 搜尋 'Visual Studio App Center' -> 下一步
- 建立 API 令牌,為連線提供名稱並加以儲存
使用 JSON 檔案導出
從 App Center 組建頁面匯出 JSON 檔案。
- 流覽至 App Center 入口網站
- 選擇您的應用程式
- 移至 [建置] 區段,選擇您的分支,然後選取 [匯出]
- 選取 [下載] 並選擇 [下載 JSON]
變更 JSON 檔案中的項目識別碼
取得 Azure DevOps 專案的標識碼
- 流覽至下方的 URL,並複製專案的識別碼
https://dev.azure.com/{organization}/_apis/projects?api-version=6.0
2.將您的項目標識碼貼到
project
JSON 檔案中的 參數
建立 Azure Pipeline
- 流覽至 Azure DevOps - 管線 ->> 匯入管線並選擇下載的 JSON 檔案
- 在
Pipeline
區段中,選擇Hosted (Azure Pipelines)
參數底下Agent Pool
- 在參數下
Agent Specification
選擇最新的 macOS Microsoft裝載代理程式 - 在
Get Sources
區段中,新增應用程式存放庫的連線
(選擇性)上傳簽署檔案並更新密碼
如果您使用 App Center 組建組態中的程式代碼登入,則必須使用 安全檔案 功能將個別檔案上傳至 Azure Pipelines。 此外,您必須更新儲存在管線中的密碼變數
Android
- 將金鑰存放區檔案上傳至您的 Azure DevOps 專案
- 更新
keystorePassword
、keyAlias
、keyPassword
、 和keystoreFilename
變數
iOS/macOS
- 將布建配置檔和憑證上傳至 Azure DevOps 專案
- 更新
P12Password
、P12Filename
和MobileProvisionFilename
變數
Windows (UWP)
- 將憑證上傳至您的 Azure DevOps 專案
- 更新
packageCertificatePassword
、packageCertificateFileName
、 和packageCertificateBase64String
(選擇性)將服務連線新增至 App Center 相關工作
如果您已整合 App Center 散發或 App Center 測試,則必須修改個別的工作
- 流覽至 Azure DevOps -> 管線
- 選取匯入的管線,然後選取 [編輯]
- 尋找 App Center 工作,然後在 [App Center 服務連線] 參數中選擇先前建立的服務連線
使用 YAML 檔案匯出
從 App Center 組建頁面匯出 YAML 檔案。
- 流覽至 App Center 入口網站
- 選擇您的應用程式
- 移至 [建置] 區段,選擇您的分支,然後選取 [匯出]
- 選取 [下載] 並選擇 [下載 YAML]
將您的存放庫設定為使用 Azure Pipelines
- 將下載的
azure-pipelines.yml
檔案認可至應用程式的存放庫 - 流覽至 Azure DevOps -> 管線 -> 建立管線
- 選擇程序代碼所在的位置
- 檢閱管線並選取
Run
如需 YAML 管線建立程式的詳細資訊,請參閱 這裡。
(選擇性)上傳簽署檔案並更新密碼
如果您使用 App Center 組建組態中的程式代碼登入,則必須使用 安全檔案 功能將個別檔案上傳至 Azure Pipelines。 此外,您必須更新儲存在管線中的密碼變數
Android
- 將金鑰存放區檔案上傳至您的 Azure DevOps 專案
- 在 Azure Pipelines 中建立
keystorePassword
、keyAlias
、keyPassword
和keystoreFilename
秘密變數 - 使用建立的秘密變數更新 YAML 檔案
...
keystorePassword: $(keystorePassword)
keyAlias: $(keyAlias)
keyPassword: $(keyPassword)
keystoreFilename: $(keystoreFilename)
...
iOS/macOS
- 將布建配置檔和憑證上傳至 Azure DevOps 專案
- 在 Azure Pipelines 中建立
P12Password
、P12Filename
和MobileProvisionFilename
秘密變數 - 使用建立的秘密變數更新 YAML 檔案
...
P12Password: $(P12Password)
P12Filename: $(P12Filename)
MobileProvisionFilename: $(MobileProvisionFilename)
...
Windows (UWP)
- 將憑證上傳至您的 Azure DevOps 專案
- 在 Azure Pipelines 中建立
packageCertificatePassword
、packageCertificateFileName
和packageCertificateBase64String
秘密變數 - 使用建立的秘密變數更新 YAML 檔案
...
packageCertificatePassword: $(packageCertificatePassword)
packageCertificateBase64String: $(packageCertificateFileName)
packageCertificateFileName: $(packageCertificateBase64String)
...
(選擇性)授權新建立的管線使用App Center服務連線
如果您已整合 App Center 散發或測試,則必須授權管線使用服務連線。
- 開啟目前執行中的作業,您會看到有關許可權的訊息
- 選取執行中的作業並
Permit
存取服務連線