使用 Visual Studio 部署和偵錯

無論您是使用 DirectX 或 Unity 來開發混合實境應用程式,Visual Studio 都是進行偵錯和部署的必備工具。 在本節中,您將瞭解如何:

  • 透過 Visual Studio 將應用程式部署到 HoloLens 或 Windows Mixed Reality 沉浸式頭戴裝置。
  • 使用 Visual Studio 內建的 HoloLens 模擬器。
  • 針對混合實境應用程式進行偵錯。

必要條件

  1. 如需安裝指示,請參閱安裝工具
  2. UnityVisual Studio 中建立新的混合實境專案。
  3. 依照我們的指示建置 Unity 專案

啟用開發人員模式

首先,在您的裝置上啟用 開發人員模式 ,讓 Visual Studio 可以與其連線。

HoloLens 上的開發人員模式

  1. 開啟您的 HoloLens 並將裝置戴上。
  2. 使用開始手勢來啟動主功能表。
  3. 選取 [設定] 磚,在您的環境中啟動應用程式。
  4. 選取 [更新] 功能表項目。
  5. 選取 [適用於開發人員] 功能表項目。
  6. 啟用 [使用開發人員功能],以將應用程式從 Visual Studio 部署至 HoloLens。 如果您的裝置執行 Windows 全像攝影版 21H1 或更新版本,也啟用 [裝置探索]。
  7. 選擇性:向下捲動而且啟用 [裝置入口網站],可讓您從網頁瀏覽器連線到您 HoloLens 上的 Windows 裝置入口網站

Windows 電腦上的開發人員模式

如果您使用的是連線到電腦的 Windows Mixed Reality 頭戴式裝置,就必須在電腦上啟用開發人員模式

  1. 移至 [設定] 。
  2. 選取 [更新和安全性]。
  3. 選取 [針對開發人員]。
  4. 啟用 開發人員模式,閱讀您選擇的設定免責聲明,然後選取 [ ] 以接受變更。

透過 Wi-Fi 或 USB 部署 HoloLens 應用程式

編譯選項

  1. 在 Visual Studio 中開啟您的專案

  2. 按兩下 [編譯選項] 下拉式清單,然後執行下列其中一項:

    • 針對 Unity 專案,選擇 [發行 ] 或 [ 主圖形]
    • 針對所有其他專案,選擇 [發行]

    顯示 Visual Studio 中編譯選項的螢幕快照

    以下是編譯選項的定義:

設定 說明
偵錯 關閉所有優化,並啟用分析工具。 用來偵錯腳本。
Master 所有優化都會開啟,並停用分析工具。 用來將應用程式提交至市集。
發行 所有優化都會開啟,並啟用分析工具。 用來評估應用程式效能。

組建組態

  1. 根據您的裝置選取您的組建組態。

    選擇 ARMARM64 組態選項

    Visual Studio 中的ARM64組建組態

    若要深入瞭解組建組態,請參閱 Unity 檔中的表格。

    注意

    若要部署至 HoloLens 2 裝置,請選擇ARM64或ARM架構。

    如果您看不到 [裝置] 目標選項,則可能需要將 Visual Studio 解決方案的啟動專案從 IL2CPP 專案變更為 UWP 專案。 若要這樣做,請在 方案總管 中,以滑鼠右鍵按下您的專案,然後選取 [設定為啟始專案]。

  2. 按一下部署目標下拉式功能表,然後執行下列其中一項動作:

    • 如果您要透過 Wi-Fi 進行建置及部署,請選取 [遠端電腦]。

    在 Visual Studio 中選取 [遠端電腦] 作為部署目標

    • 如果您要透過 USB 進行建置及部署,請選取 [裝置]。

    在 Visual Studio 中選取 [裝置] 作為部署目標

遠端連線

若要設定遠端連線:

  1. 在功能表欄上,選取 [項目 > 屬性 > 組態屬性 > 偵錯]。

    注意

    針對 C# 專案,對話方塊應該會自動出現。

  2. 按兩下 [除錯程式] 啟動 下拉式清單,然後選取 [ 遠端電腦]。

  3. 在 [電腦名稱] 欄位中,輸入裝置的 IP 位址。

    Visual Studio 中的 [遠端連線] 對話方塊

    • 您可以在 HoloLens 的 [ 設定 > 網络] & [因特網 > 進階選項] 底下找到 IP 位址。

    • 建議您手動輸入您的 IP 位址,而不要依賴「自動偵測」功能。

  4. 將 [驗證模式] 設定為 [通用 (未加密的通訊協定)]。

  5. 根據您的需求建置、部署及偵錯您的應用程式:

    • 若要建置、部署並開始偵錯,請選取 [>偵錯開始偵錯]。

    • 若要在不偵錯的情況下建置和部署,請選取 [ 建 > 置部署解決方案]。

  6. 當您第一次從電腦將應用程式部署到 HoloLens 時,系統會提示您輸入 PIN 碼。 遵循以下的配對您的裝置指示。

注意

如果您在 HoloLens 2 上開始偵錯已安裝的 UWP 應用程式時發生下列錯誤,請嘗試重新命名您的套件或卸載您的 UWP 應用程式。

「無法開始偵錯」
「不支援作業。 未知的錯誤:0x80070057」

將應用程式部署至 HoloLens (第 1 代) 模擬器

  1. 請確定您已 安裝 HoloLens 模擬器
  2. 為您的應用程式選取 x86 組建設定。 在 Visual Studio 中選取 x86 組建組態
  3. Visual Studio 的部署目標下拉功能表
    中選取 HoloLens 模擬器目標
  4. 選取 [偵錯>開始偵錯] 以部署您的應用程式,並在Visual Studio 中開始偵錯 [啟動
    但不偵錯]

將應用程式部署至 HoloLens 2 模擬器

  1. 請確定您已 安裝 HoloLens 模擬器
  2. 選取您應用程式的 x86x64 組建組態。
    Visual Studio 中的 x86 組建設定組態
  3. 在 Visual Studio 應用程式中,選取 [部署目標] 下拉功能表中的 [模擬器] HoloLens 2
    模擬器目標
  4. 選取 [偵錯>開始偵錯] 以部署您的應用程式,並在Visual Studio 中開始偵錯 [啟動
    但不偵錯]

將 VR 應用程式部署至本機電腦

若要使用可連線到您的電腦或混合實境模擬器的 Windows Mixed Reality 沉浸式頭戴裝置:

  1. 為您的應用程式選取 x86x64 組建設定
  2. 在 [部署目標] 下拉式功能表中,選取 [本機電腦]
  3. 根據您的需求建置、部署及偵錯您的應用程式
    • 選取 [偵錯開始偵錯] 以部署您的應用程式並開始偵錯>
    • 選取 [建置 > 部署 ] 以建置和部署而不進行偵錯

配對您的裝置

當您第一次從 Visual Studio 將應用程式部署到 HoloLens 時,系統會提示您輸入 PIN 碼。 在 HoloLens 上,啟動 [設定] 應用程式以產生 PIN,移至 [適用於開發人員的更新>],然後點選 [配對]。 當您的 HoloLens 上顯示 PIN 時,請將其輸入 Visual Studio 中。 配對完成之後,點選 HoloLens 上的 [完成] 以關閉對話方塊。 這部電腦現在已與 HoloLens 配對,您可以自動部署應用程式。 針對用來將應用程式部署至 HoloLens 的每部電腦重複這些步驟。

若要解除配對您的 HoloLens 與所有配對的電腦:

  • 啟動 [設定] 應用程式,移至 [適用於開發人員的更新>],然後點選 [清除]。

HoloLens (第 1 代) 的圖形偵錯工具

撰寫和最佳化全像攝影應用程式時,Visual Studio 圖形診斷工具很有幫助。 如需完整詳細資料,請參閱 MSDN 上的 Visual Studio 圖形診斷

啟動圖形偵錯工具

  1. 遵循上述指示,以裝置或模擬器為目標
  2. 移至 偵 > 錯圖形 > 開始診斷
  3. 第一次使用 HoloLens 開始診斷時,您可能會遇到「拒絕存取」錯誤。 將 HoloLens 重新開機,讓更新的權限生效,然後再試一次。

程式碼剖析

Visual Studio 程式碼剖析工具可讓您分析應用程式的效能和資源使用。 包括將 CPU、記憶體、圖形和網路使用最佳化的工具。 如需完整詳細資料,請參閱 MSDN 上的執行診斷工具而不進行偵錯

使用 HoloLens 啟動程式碼剖析工具

  1. 遵循上述指示,以裝置或模擬器為目標
  2. 移至 [>偵錯][啟動診斷工具但不偵錯...]
  3. 選取您想要使用的工具
  4. 選取 [啟動]
  5. 第一次使用 HoloLens 開始診斷但不進行偵錯時,您可能會遇到「拒絕存取」錯誤。 將 HoloLens 重新開機,讓更新的權限生效,然後再試一次。

針對已安裝或執行中的應用程式進行偵錯

您可以使用 Visual Studio 針對已安裝但未從 Visual Studio 專案部署的通用 Windows 應用程式進行偵錯。 如果您想要對已安裝的應用程式套件進行偵錯,或對已經在執行中的應用程式進行偵錯,這會很有用。

  1. 移至偵 錯 -> 其他偵錯目標 -> 偵錯已安裝的應用程式套件
  2. 針對 HoloLens 選取 [遠端電腦] 目標,或針對沉浸式頭戴裝置選取 [本機電腦] 。
  3. 輸入您裝置的 IP 位址
  4. 選擇 [通用] 驗證模式
  5. 此視窗會顯示執行中和非使用中的應用程式。 挑選您想要進行偵錯的應用程式。
  6. 選擇要進行偵錯的程式碼類型 (受控、原生、混合)
  7. 選取 [連結] 或 [啟動]

下一個開發檢查點

依循我們配置的 Unity 開發檢查點旅程,此時您會進入部署階段。 接下來,您可以繼續進行下一個主題:

或者,直接跳到新增進階服務的主題:

您可以隨時回到 Unity 開發檢查點

另請參閱