使用 Azure DevOps 進行 UI 測試
重要
Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center,直到完全淘汰為止,但有數個建議的替代方案可以考慮移轉至。
本指南說明如何修改現有的 Azure Pipelines 組建,以建立應用程式二進位 (或.ipa
檔案) .apk
,以新增在 App Center 測試中執行測試套件的 App Center 測試工作。
Azure Pipelines 是 Azure DevOps Services 的一部分。 Azure Pipelines 可協助您實作任何應用程式的組建、測試與部署管線。 如需 Azure DevOps Services 或 Azure Pipelines 的詳細資訊,請參閱 Azure DevOps 檔或 Azure Pipelines。
Azure Pipelines 的 App Center 測試工作可讓您在 App Center 測試中執行測試套件。 您可以使用 Appium、XCUItest、和 Xamarin.UITest 架構。 深入瞭解 App Center 測試支援的架構頁面上的架構 。
本指南中的每個架構都有自己的區段,您可以在其中閱讀在 Azure Pipelines 中設定 App Center 測試工作定義的基本需求。
一般設定步驟
開始之前
開始測試之前,您需要下列專案。
- 建立應用程式二進位 (
.apk
或.ipa
檔案) 的 Azure Pipelines 組建。 - 作用中的 App Center 測試帳戶。 您可以在 App Center 啟用 App Center 測試的試用版。 請先選取您的應用程式,然後選取左側功能表中的 [測試]。
- 設定管線以使用 Node 10.x.x。 請閱讀 Azure DevOps 檔中的作法,檔是關於 Javascript,但原則也適用於此處。
Azure Pipelines 一般設定
找出您的 Azure Pipelines 專案,然後針對 [編輯] 加以開啟。 按兩下 + 以新增工作,然後搜尋 應用程式中心。
按兩下 App Center 測試工作旁的 [新增]。 在畫面左側,按兩下 [使用 Visual Studio App Center 新增的測試 ] 工作來選取和修改它。 App Center 測試工作分成區段。
在頂端區段中,於 [二進位應用程式檔案路徑] 字段中插入應用程式二進位檔 (.apk
或 .ipa
) 的路徑。
線上到 App Center 測試
使用服務之前先登入App Center;有兩種驗證方法可供您使用。
第一個方法會使用 API 令牌;以取得您帳戶的 API 令牌:
- 登入 App Center,然後按兩下 App Center 入口網站左上角的使用者設定圖示。
- 在出現的功能表中,選取 [ 帳戶設定]。
- 在 [ 設定] 面板中,選取 [API 令牌]。
- 按兩下面板右上角的 [ 新增 API 令牌 ] 按鈕。
- 將新的 API 令牌命名為 -例如,您可以將其命名為 Azure DevOps。 未來,此名稱將協助您識別哪個服務正在使用服務。
- 按兩下 [新增 API 令牌 ] 按鈕。 彈出視窗會顯示新的 API 令牌;此快顯是 App Center 將顯示此令牌 的唯一時間 。 按下剪貼簿按鈕,將 API 令牌複製到瀏覽器的剪貼簿。 將 API 令牌儲存在 Azure 金鑰保存庫 (某處,例如) 您可以在需要時安全地參考它。
在剪貼簿上使用 API 令牌:
- 切換至您的 Azure DevOps Services 視窗。 在 [App Center 連線] 字段的 [執行] 區段中, 按兩下 [App Center 測試] 工作的 [ 新增 ] 按鈕。
- 以適當的連線名稱填入表單的 [ 名稱 ] 欄位 (,例如: App Center) 。
- 將 App Center API 令牌貼到 [API 令牌 ] 字段中。
- 按兩下[關閉] 來完成設定。
請確定新建立的連接會出現在 [App Center 連線] 字段中。
第二種方法會使用您的 App Center 帳戶認證:
- 從 [驗證方法] 下拉功能表中選取 [認證]。
- 使用來自您 App Center 帳戶的認證,填入 App Center 使用者 名稱和 App Center 密碼 欄位。
注意
您的 App Center 使用者名稱位於 App Center 帳戶設定檔中。 如果使用您的 Microsoft 認證登入,請使用密碼設定您的帳戶,或工作無法登入。 您可以在 App Center 中設定密碼。
Appium
- 建立測試回合之前,請先完成本指南開始 之前 一節的步驟。
- 準備您的存放庫以進行App Center測試、Appium測試。
Appium 的 Azure Pipelines 設定
首先,將 App Center 測試工作新增至組建定義,如先前在 Azure Pipelines 一般設定中所述。
在 [準備測試] 區段中,確定已核取 [ 準備測試 ] 複選框,然後針對 [測試架構],選取 [Appium Test Framework]。 將 Appium test-classes、dependency-jars 和 pom.xml
檔案的路徑插入 [ 建置目錄 ] 字段。 這三個成品通常位於 upload
資料夾中。
現在您可以設定測試回合。 在 App Center 中建立新的測試,即可找到您需要的所有資訊。 請遵循 啟動測試回合中的指示。 將提交頁面保留 (測試回合安裝程序的最後一頁,) 開啟,因此您可以在設定 App Center 測試工作時使用該資訊。
appcenter test run appium --app "username/appname" --devices 209ed689
--app-path pathToFile.apk --test-series "main" --locale "en_US"
--build-dir target/upload
- 在提交頁面上,應用程式 slug 是
--app
參數。 將該插入至 [應用程式 Slug ] 欄位。 - 裝置選取是
--devices
參數。 將該插入 [ 裝置] 欄位。 - 測試系列 是自由文字欄位 - 它可以是任何專案。
--test-series
它是參數。 - 系統語言 是下拉功能表。 如果選取 [其他 ], [其他地區 設定] 字段隨即出現,您可以在其中輸入語言和國家/地區代碼,如下所示:
en_US
。
儲存組態,且您已設定為啟動組建和 App Center 測試回合。
濃縮咖啡
- 建立測試回合之前,請先完成本指南開始 之前 一節的步驟。
- 瞭解如何為 App Center 測試、一項測試準備您的存放庫。
適用於的 Azure Pipelines 組態
首先,將 App Center 測試工作新增至組建定義,如先前在 Azure Pipelines 一般設定中所述。
在 [準備測試] 區段中,確定已核取 [ 準備測試 ] 複選框,然後針對 [測試架構],選取 [ 測試架構]。
現在您可以設定測試回合。 在 App Center 中建立新的測試,即可找到您需要的所有資訊。 請遵循 啟動測試回合中的指示。 將提交頁面保留 (測試回合安裝程序的最後一頁,) 開啟,因此您可以在設定 App Center 測試工作時使用該資訊。
appcenter test run espresso --app "username/appname" --devices 209ed689
--app-path pathToFile.apk --test-series "main" --locale "en_US"
--build-dir pathToEspressoBuildFolder
- 在提交頁面上,應用程式 slug 是
--app
參數。 將該插入至 [應用程式 Slug ] 欄位。 - 裝置選取是
--devices
參數。 將該插入 [ 裝置] 欄位。 - 測試系列 是自由文字欄位 - 它可以是任何專案。
--test-series
它是參數。 - 系統語言 是下拉功能表。 如果選取 [其他 ], [其他地區 設定] 字段隨即出現,您可以在其中輸入語言和國家/地區代碼,如下所示:
en_US
。
儲存組態,且您已設定為啟動組建和 App Center 測試回合。
Xamarin.UITest
- 建立測試回合之前,請先完成本指南開始 之前 一節的步驟。
- 瞭解如何 為 App Center Test、Xamarin.UITest 測試準備 Xamarin.Android 存放庫。
- 瞭解如何 為 App Center 測試、Xamarin.UITest 測試準備 Xamarin.iOS 存放庫。
適用於 Xamarin.UITest 的 Azure Pipelines 設定
首先,將 App Center 測試工作新增至組建定義,如先前在 Azure Pipelines 一般設定中所述。
在 [準備測試] 區段中,確定已核取 [準備測試] 複選框,並在 [測試架構] 底下選取 [Xamarin UI 測試]。 將路徑插入至您的組建目錄;在大部分情況下,組建資料夾是: <ProjectName>/bin/<configuration>
。
現在您可以設定測試回合。 在 App Center 中建立新的測試,即可找到您需要的所有資訊。 請遵循 啟動測試回合中的指示。 將提交頁面保留 (測試回合安裝程序的最後一頁,) 開啟,因此您可以在設定 App Center 測試工作時使用該資訊。
appcenter test run uitest --app "username/appname" --devices 209ed689
--app-path pathToFile.apk --test-series "main" --locale "en_US"
--build-dir pathTUITestBuildDir
- 在提交頁面上,應用程式 slug 是
--app
參數。 將該插入至 [應用程式 Slug ] 欄位。 - 裝置選取是
--devices
參數。 將該插入 [ 裝置] 欄位。 - 測試系列 是自由文字欄位 - 它可以是任何專案。
--test-series
它是參數。 - 系統語言 是下拉功能表。 如果選取 [其他 ], [其他地區 設定] 字段隨即出現,您可以在其中輸入語言和國家/地區代碼,如下所示:
en_US
。
儲存組態,且您已設定為啟動組建和 App Center 測試回合。
XCUITest
- 建立測試回合之前,請先完成本指南開始 之前 一節的步驟。
- 瞭解如何準備App Center測試、XCUITest測試的存放庫。
注意
在您的管線中,在 App Center 測試工作之前,您需要 Xcode 工作步驟,並採取 動作 build-for-testing
來建置測試所需的測試執行器應用程式。 在該工作中,在 [進階] 區段中的 [自變數] 下,指定衍生的數據路徑,通常使用 -derivedDataPath DerivedData
。 您也需要 .ipa file
應用程式的 。 您可以在相同的 Xcodebuild-for-testing
工作中建置 ,.ipa file
方法是檢查 Create app package
選項,或在個別的 Xcode 建置步驟或 Bash 腳本步驟中建置 。
適用於 XCUITest 的 Azure Pipelines 設定
首先,將 App Center 測試工作新增至組建定義,如先前在 Azure Pipelines 一般設定中所述。
在 [準備測試] 區段中,確定已核取 [準備測試] 複選框,並在 [測試架構] 底下選取 [XCUITest]。 從 Xcode build-for-testing
步驟插入組建目錄的路徑。 一般而言,組建資料夾為: DerivedData/Build/Products/Debug-iphoneos/
。
現在您可以設定測試回合。 在 App Center 中建立新的測試,即可找到您需要的所有資訊。 請遵循 啟動測試回合中的指示。 將提交頁面保留 (測試回合安裝程序的最後一頁,) 開啟,因此您可以在設定 App Center 測試工作時使用該資訊。
appcenter test run xcuitest --app "username/appname" --devices 209ed689 --test-series "main" --locale "en_US" --build-dir pathToXCUItestBuildFolder
- 在提交頁面上,應用程式 slug 是
--app
參數。 將該插入至 [應用程式 Slug ] 欄位。 - 裝置選取是
--devices
參數。 將該插入 [ 裝置] 欄位。 - 測試系列 是自由文字欄位 - 它可以是任何專案。
--test-series
它是參數。 - 系統語言 是下拉功能表。 如果選取 [其他 ], [其他地區 設定] 字段隨即出現,您可以在其中輸入語言和國家/地區代碼,如下所示:
en_US
。
儲存組態,且您已設定為啟動組建和 App Center 測試回合。