共用方式為

適用於 Windows 的遠端 iOS 模擬器

  • 發行項

適用於 Windows 的遠端 iOS 模擬器可讓您在 Windows 和 Visual Studio 2022 中顯示的 iOS 模擬器上測試您的應用程式。

開始使用

Windows 的遠端 iOS 模擬器會自動安裝為 Visual Studio 2022 中 .NET 多平臺應用程式 UI 開發工作負載的一部分。 若要使用它，請遵循下列步驟：

  1. 啟動 Visual Studio 2022 並建立或載入 .NET MAUI 應用程式專案。

  2. 在 Visual Studio 2022 中，請將 IDE 連接至 Mac 組建主機，如果您先前尚未這麼做。 如需詳細資訊，請參閱 與 Mac 配對以進行 iOS 開發。

  3. 在 Visual Studio 工具列中，使用 [偵錯目標] 下拉式清單選取 [iOS 模擬器]，然後選取特定的 iOS 模擬器：

    Visual Studio iOS 模擬器偵錯目標。

  4. 在 Visual Studio 工具列中，按所選 iOS 模擬器的綠色 [開始] 按鈕：

    Visual Studio iOS 模擬器偵錯目標選擇。

    Visual Studio 會建置應用程式、啟動適用於 Windows 的遠端 iOS 模擬器，並將應用程式部署至模擬器：

    執行應用程式的Visual Studio iOS遠程模擬器。

啟用適用於 Windows 的遠端 iOS 模擬器

默認會啟用適用於 Windows 的遠端 iOS 模擬器。 然而，如果先前已停用，可以在 Visual Studio 中瀏覽至 Tools > Options > Xamarin > iOS 設定，然後確認已勾選 遠端模擬器至 Windows：

Visual Studio 複選框，以啟用 iOS 遠端模擬器。

注意

在 Visual Studio 中停用遠端模擬器時，偵錯 .NET MAUI iOS 應用程式會在連線的 Mac 組建主機上開啟 iOS 模擬器。

模擬器視窗工具列

模擬器視窗頂端的工具列會顯示五個按鈕：

適用於 Windows 工具列的 Visual Studio iOS 遠端模擬器。

按鈕如下所示：

  • Home – 模擬 iOS 裝置上的首頁按鈕。
  • 鎖定 – 鎖定模擬器（撥動以解除鎖定）。
  • [撷取螢幕快照] – 將模擬器的螢幕快照儲存至 \Users\{User}\Pictures\Xamarin\iOS 模擬器。
  • [設定] – 顯示鍵盤和其他設定。
  • 其他選項 – 顯示各種模擬器選項，例如旋轉和搖動手勢。

點選工具列 [設定] 按鈕 （齒輪圖示） 會開啟 [設定] 視窗：

iOS 遠端模擬器設定。

這些設定可讓您啟用硬體鍵盤，並重設模擬器的內容和設定。

按下工具列 [其他選項] 按鈕 （省略號圖示） 會顯示其他按鈕，例如旋轉、搖動手勢和重新啟動：

iOS 遠端模擬器其他設定。

注意

以滑鼠右鍵按下遠端 iOS 模擬器視窗中的任何位置，就會將所有工具列按鈕顯示為操作選單。

觸控屏幕支援

許多 Windows 電腦都有觸摸屏。 由於適用於 Windows 的遠端 iOS 模擬器支援觸控互動，因此您可以使用與實體 iOS 裝置一起使用的相同捏合、撥動和多指觸控手勢來測試您的應用程式。

同樣地，適用於 Windows 的遠端 iOS 模擬器會將 Windows 手寫筆輸入視為 Apple Pencil 輸入。

音效處理

模擬機播放的聲音將來自主機 Mac 的喇叭。 Windows 上不會聽到 iOS 音效。

故障排除

在某些情況下，Xcode 的設定問題可能會導致 Windows 上的遠端 iOS 模擬器陷入「連線到 Mac...檢查伺服器...已連接...」的迴圈中。 發生這種情況時，您必須移除並重設 Mac 組建主機上的模擬器：

  • 請確定 Xamarin Mac 代理程式 （XMA） 和 Xcode 未執行。
  • 刪除您的 ~/Library/Developer/CoreSimulator/Devices 資料夾。
  • 執行 killall -9 com.apple.CoreSimulator.CoreSimulatorService。
  • 執行 xcrun simctl list devices。

在某些情況下，Xcode 可能會產生模擬器裝置，這會導致 Windows 的遠端 iOS 模擬器無法正確讀取這些裝置的屬性，因為其在嘗試確認哪些裝置可以部署時，可能造成開機循環問題。

您可以移除並建立可部署至的新模擬器，以解決此問題：

  • 請確定 Xamarin Mac 代理程式 （XMA） 和 Xcode 未執行。
  • 執行 xcrun simctl list | grep -w "Shutdown" | grep -o "([-A-Z0-9]*)" | sed 's/[\(\)]//g' | xargs -I uuid xcrun simctl delete uuid。
  • 執行 xcrun simctl list devices。 您應該不會看到任何列出的裝置。
  • 在連線的 Mac 上開啟 Xcode。
  • 開啟 Windows > 裝置 & 模擬器。
  • 選擇 模擬器。
  • 建立您想要部署的新模擬器。

日誌

如果您遇到遠端 iOS 模擬器的問題，您可以在下列位置檢視記錄：

  • Mac – ~/Library/Logs/Xamarin/Simulator.Server
  • Windows – %LOCALAPPDATA%\Xamarin\Logs\Xamarin.Simulator