共用方式為


為 Xamarin.iOS 開發與 Mac 配對

本指南描述如何使用 [與 Mac 配對] 將 Visual Studio 2019 連線至 Mac 組建主機。 這些指示同樣適用於 Visual Studio 2017。

概觀

建置原生 iOS 應用程式需要存取只在 Mac 上執行的 Apple 組建工具。 因此,Visual Studio 2019 必須連線至網路可存取 Mac,才能建置 Xamarin.iOS 應用程式。

Visual Studio 2019 的 [與 Mac 配對] 功能會探索、連線、驗證並記住 Mac 組建主機,讓以 Windows 為基礎的 iOS 開發人員的工作更有成效。

[與 Mac 配對] 會啟用下列開發工作流程:

  • 開發人員可以在 Visual Studio 2019 中撰寫 Xamarin.iOS 程式碼。

  • Visual Studio 2019 會開啟與 Mac 組建主機的網路連線,並在該電腦上使用組建工具編譯和簽署 iOS 應用程式。

  • 不需要在 Mac 上執行個別應用程式,Visual Studio 2019 會透過 SSH 安全地叫用 Mac 組建。

  • 一旦有變更發生,就會立即通知 Visual Studio 2019。 例如,將 iOS 裝置插入至 Mac 或在網路上變成可用時,會立即更新 iOS 工具列。

  • 多個 Visual Studio 2019 執行個體可以同時連線至 Mac。

  • 您可以使用 Windows 命令列建置 iOS 應用程式。

注意

遵循本指南中的指示,完成下列步驟:

如果您不想要安裝 Visual Studio for Mac,則 Visual Studio 2019 可以使用 Xamarin.iOS 和 Mono 來自動設定 Mac 組建主機。 您仍然必須安裝並執行 Xcode。 如需詳細資訊,請參閱自動 Mac 佈建

在 Mac 上啟用遠端登入

若要設定 Mac 組建主機,請先啟用遠端登入:

  1. 在 Mac 上,開啟 [系統偏好設定],並移至 [共享] 窗格。

  2. 核取 [服務] 清單中的 [遠端登入]

    Enabling Remote Login

    確定已設定為允許 [所有使用者] 存取,或是允許使用者清單中包含您的 Mac 使用者名稱或群組。

  3. 如果出現提示,請設定 macOS 防火牆。

    如果您已設定 macOS 防火牆封鎖傳入連線,則可能需要允許 mono-sgen 接收傳入連線。 如果是這種情況,則會顯示警示來提示您。

  4. 如果它位在與 Windows 電腦相同的網路上,則 Visual Studio 2019 現在應該可以探索到 Mac。 如果仍然探索不到 Mac,則請嘗試手動新增 Mac 或查看疑難排解指南

從 Visual Studio 2019 連線至 Mac

既然已啟用遠端登入,請將 Visual Studio 2019 連線至 Mac。

  1. 在 Visual Studio 2019 中,開啟現有的 iOS 專案,或選擇 [檔案 > 新 > 專案],然後選取 iOS 專案範本來建立新的專案

  2. 開啟 [與 Mac 配對] 對話方塊。

    • 使用 [與 Mac 配對] 按鈕 iOS 工具列:

      The iOS toolbar, with the Pair to Mac button highlighted

    • 或者,選取 [工具 iOS > 配對至 Mac>]。

    • [與 Mac 配對] 對話方塊會顯示所有先前連線且目前可用的 Mac 組建主機清單:

      The Pair to Mac dialog

  3. 在清單中,選取 Mac。 按一下 連線

  4. 輸入您的使用者名稱和密碼。

    • 第一次連線至任何特定 Mac 時,系統會提示您輸入該電腦的使用者名稱與密碼:

      Entering a username and password for the Mac

      提示

      登入時,請使用您的系統使用者名稱,而非完整名稱。

    • [與 Mac 配對] 會使用這些認證來建立與 Mac 的新 SSH 連線。 如果成功,則會將金鑰新增至 Mac 上的 authorized_keys 檔案。 後續連線至相同 Mac 將會自動登入。

  5. [與 Mac 配對] 會自動設定 Mac。

    從 Visual Studio 2019 15.6 版開始,Visual Studio 2019 會視需要安裝或更新已連線 Mac 組建主機上的 Mono 和 Xamarin.iOS (請注意,Xcode 仍須靠您手動安裝)。 如需詳細資訊,請參閱自動 Mac 佈建

  6. 尋找連線狀態圖示。

    • Visual Studio 2019 連線至 Mac 時,[與 Mac 配對] 對話方塊中該 Mac 的項目會顯示圖示,指出目前已連線:

      A connected Mac

      一次只能有一個已連線的 Mac。

      提示

      以滑鼠右鍵按一下 [與 Mac 配對] 清單中的任何 Mac 都會啟動操作功能表,讓您可以 [連線...]、[不要記住這部 Mac] 或 [中斷連線]

      The Pair to Mac context menus

      如果您選擇 [不要記住這部 Mac],則會忘記所選取 Mac 的認證。 若要重新連線至該 Mac,您需要重新輸入使用者名稱和密碼。

如果您已成功與 Mac 組建主機配對,則已可開始在 Visual Studio 2019 中建置 Xamarin.iOS 應用程式。 請查看 Xamarin.iOS for Visual Studio 簡介指南。

如果您還是無法與 Mac 配對,則請嘗試手動新增 Mac 或查看疑難排解指南

手動新增 Mac

如果 [與 Mac 配對] 對話方塊中未列出特定 Mac,則請手動予以新增:

  1. 找到 Mac 的 IP 位址。

    • 開啟 Mac 上的系統喜好設定 > 共享 > 遠端登入

      The Mac's IP address in System Preferences > Sharing

    • 或者,使用命令列。 在 [終端機] 中,發出此命令:

      $ ipconfig getifaddr en0
      196.168.1.8
      

      根據網路組態,您可能需要使用 en0 以外的介面名稱。 例如:en1en2 等等。

  2. 在 Visual Studio 2019 的 [與 Mac 配對] 對話方塊中,選取 [新增 Mac...]

    The Add Mac button in the Pair to Mac dialog

  3. 輸入 Mac 的 IP 位址,然後按一下 [新增]

    Entering the Mac's IP address

  4. 輸入 Mac 的使用者名稱和密碼:

    Enter a username and password

    提示

    登入時,請使用您的系統使用者名稱,而非完整名稱。

  5. 按一下 [登入],透過 SSH 將 Visual Studio 2019 連線至 Mac,並將它新增至已知電腦的清單。

自動 Mac 佈建

Visual Studio 2019 15.6 版開始,與 Mac 配對會自動布建 Mac 與建置 Xamarin.iOS 應用程式所需的軟體:Mono、Xamarin.iOS(軟體架構,而非 Visual Studio for Mac IDE),以及各種 Xcode 相關工具(但不是 Xcode 本身)。

重要

  • [與 Mac 配對] 無法安裝 Xcode;您必須在 Mac 組建主機上手動安裝它。 它是進行 Xamarin.iOS 開發的必要項目。
  • 自動 Mac 佈建需要在 Mac 上啟用遠端登入,而且 Mac 必須可透過網路存取 Windows 電腦。 如需詳細資訊,請參閱在 Mac 上啟用遠端登入
  • 自動化的 Mac 佈建需要 Mac 有 3 GB 的可用空間,才能安裝 Xamarin.iOS。

[與 Mac 配對] 會在 Visual Studio 2019 連線至 Mac 時執行必要的軟體安裝/更新。

Mono

[與 Mac 配對] 將會確定已安裝 Mono。 如果未安裝,則 [與 Mac 配對] 將會在 Mac 下載和安裝 Mono 的最新穩定版本。

進度是以各種提示指出,如下列螢幕擷取畫面所示 (按一下以縮放):

Mono 安裝檢查 下載 正在安裝
Missing Mono installation Downloading Mono Installing Mono

Xamarin.iOS

[與 Mac 配對] 會在 Mac 上升級 Xamarin.iOS,以符合 Windows 電腦上已安裝的版本。

重要

[與 Mac 配對] 不會將 Mac 上的 Xamarin.iOS 從 alpha/beta 降級至穩定。 如果您已安裝 Visual Studio for Mac,則請設定發行通道,如下所示:

  • 如果您使用 Visual Studio 2019,請選取 Visual Studio for Mac 中的 [穩定] 更新通道。
  • 如果您使用 Visual Studio 2019 Preview,請選取 Visual Studio for Mac 中的 Alpha 更新通道。

進度是以各種提示指出,如下列螢幕擷取畫面所示 (按一下以縮放):

Xamarin.iOS 安裝檢查 下載 正在安裝
Missing Xamarin.iOS installation Downloading Xamarin.iOS Installing Xamarin.iOS

Xcode 工具和授權

[與 Mac 配對] 也會確認是否已安裝 Xcode 並接受其授權。 [與 Mac 配對] 未安裝 Xcode 時,系統會提示接受授權,如下列螢幕擷取畫面所示 (按一下以縮放):

Xcode 安裝檢查 接受授權
Missing Xcode installation Xcode license

此外,[與 Mac 配對] 將會安裝或更新利用 Xcode 所散發的各種套件。 例如:

  • MobileDeviceDevelopment.pkg
  • XcodeExtensionSupport.pkg
  • MobileDevice.pkg
  • XcodeSystemResources.pkg

這些套件的安裝會快速發生,而且不會出現提示。

注意

這些工具與 Xcode 命令列工具不同,而從 macOS 10.9 開始是使用 Xcode 安裝

針對自動 Mac 佈建進行疑難排解

如果您使用自動 Mac 佈建時發生任何問題,請查看儲存在 %LOCALAPPDATA%\Xamarin\Logs\16.0 中的 Visual Studio 2019 IDE 記錄。 這些記錄可能包含錯誤訊息,協助您進一步診斷失敗或取得支援。

從 Windows 命令列建置 iOS 應用程式

[與 Mac 配對] 支援從命令列建置 Xamarin.iOS 應用程式。 例如:

C:\samples\App1>msbuild App1.sln /p:ServerAddress=10.211.55.2 /p:ServerUser=xamUser /p:Platform=iPhoneSimulator /p:ServerPassword=mypassword

上述範例中傳遞給 msbuild 的參數如下:

  • ServerAddress - Mac 組建主機的 IP 位址。
  • ServerUser - 要在登入 Mac 組建主機時使用的使用者名稱。 請使用您的系統使用者名稱,而非完整名稱。
  • ServerPassword - 要在登入 Mac 組建主機時使用的密碼。

注意

Visual Studio 2019 儲存 msbuild 在下列目錄中: C:\Program Files (x86)\Microsoft Visual Studio\2019\<Version>\MSBuild\Current\Bin

[與 Mac 配對] 第一次從 Visual Studio 2019 或命令列登入特定 Mac 組建主機時,會設定 SSH 金鑰。 如果使用這些金鑰,則未來的登入不需要使用者名稱或密碼。 新建立的金鑰會儲存在 %LOCALAPPDATA%\Xamarin\MonoTouch 中。

如果從命令列組建叫用來省略 ServerPassword 參數,則 [與 Mac 配對] 會嘗試使用已儲存的 SSH 金鑰來登入 Mac 組建主機。

摘要

本文說明如何使用 [與 Mac 配對] 將 Visual Studio 2019 連線至 Mac 組建主機,並讓 Visual Studio 2019 開發人員使用 Xamarin.iOS 建置原生 iOS 應用程式。

下一步