共用方式為

準備 Xamarin.iOS 應用程式

  • 發行項

重要

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

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

本指南提供準備 Xamarin.UITests 以上傳至 App Center 測試的指示。 選取您的平臺以開始。

Xamarin.iOS 應用程式必須連結至應用程式的 .ipa 檔案中的 Xamarin Test Cloud Agent。 Xamarin Test Cloud Agent 是一種特殊的內嵌 HTTP 伺服器，可讓 Xamarin.UITests 與 iOS 使用者介面互動。 測試雲端代理程式會透過 NuGet 新增至 iOS 專案。

提示

Xamarin.UITest 也支援非 Xamarin iOS 應用程式，但不是 Xamarin Test Cloud Agent 需要 連結一個檔案。」

Visual Studio for Mac

針對 Visual Studio for Mac 中的 iOS 專案，以滑鼠右鍵按兩下 [套件] 資料夾，選取 [新增套件]。 搜尋 Xamarin Test Cloud Agent，然後按兩下 [ 新增套件]：

新增 Xamarin Test Cloud Agent (macOS)

Visual Studio (Windows)

重要

iOS 應用程式的 Xamarin.UITests 無法在 Windows 本機執行。 您仍然可以從 Windows 建立、編譯及上傳至 App Center 測試。

針對 Visual Studio for Windows 中的 iOS 專案，以滑鼠右鍵按兩下項目，然後從操作功能表中選取 [ 管理 NuGet 套件 ]。 在 NuGet 套件管理員 中搜尋 Xamarin Test Cloud Agent ，然後按兩下 [ 確定 ] 以安裝該套件：

新增 Xamarin Test Cloud Agent (windows)

初始化 Xamarin Test Cloud Agent

將 Xamarin Test Cloud Agent 新增至 iOS 項目之後，您必須在 iOS 應用程式啟動時初始化 Xamarin Test Cloud Agent。 編輯 AppDelegate 類別，並將下列代碼段新增至 FinishedLaunching 方法：

#if ENABLE_TEST_CLOUD
Xamarin.Calabash.Start();
#endif

警告

如果您提交包含 Xamarin Test Cloud Agent 的應用程式，Apple 將會拒絕您的應用程式。 只有使用開發佈建配置檔簽署的應用程式才支援 Xamarin Test Cloud Agent。 提交至 App Center 測試時，IPA 會盡可能使用我們的其中一個開發佈建配置檔自動重新簽署。

當您圍繞 ENABLE_TEST_CLOUD 條件式編譯語句中的初始化程序代碼時，Xamarin 連結器會將 Xamarin Test Cloud Agent 保留在使用 ENABLE_TEST_CLOUD 旗標的組建中。 通常偵錯組建，但不是發行組建。 在 Visual Studio 中建立的新 Xamarin.iOS 應用程式會使用此方法。

產生上傳命令

測試套件備妥之後，您可以 設定測試回合 來上傳並執行測試。 該程式會產生類似以下的原型命令列：

appcenter test run uitest --app "MyOrg/MyApp" --devices "MyOrg/MyDeviceSet" --app-path pathToFile.ipa --test-series "main" --locale "en_US" --build-dir pathToUITestBuildDir

命令列需要一些修改：

  1. 您必須提供自變數--app-path的路徑 & --build-dir。
  2. 如果 CLI 無法自動找到， 您可能需要 指定您使用的 UITest 套件： --uitest-tools-dir /Users/{your username}/.nuget/packages/xamarin.uitest/{UITest version}/tools