共用方式為


從 Visual Studio 對遠端電腦上的 UWP 應用程式進行偵錯

您可以使用 Visual Studio,在另一部電腦或裝置上執行、偵錯、分析及測試通用 Windows 平台 (UWP) 應用程式。 當 Visual Studio 電腦不支援觸控、地理位置或實體方向等 UWP 特定功能時,在遠端電腦上執行 UWP 應用程式特別有用。

必要條件

若要從 Visual Studio 對遠端裝置上的 UWP 應用程式進行偵錯:

  • Visual Studio 專案必須設定為遠端偵錯。
  • 遠端電腦和 Visual Studio 電腦必須透過網路連接,或直接透過 USB 或乙太網路纜線連接。 不支援透過網際網路偵錯。
  • 您必須在 Visual Studio 電腦和遠端電腦上開啟開發人員模式
  • 遠端電腦必須執行 Visual Studio 遠端工具。

設定 Visual Studio 專案進行遠端偵錯

您可以使用專案 [屬性] 指定要連線的遠端裝置。 此設定會因程式語言而有所差異。

警告

根據預設,屬性頁會將 [通用 (未加密的通訊協定)] 設定為Windows 10 和更新版本的遠端連線 [驗證類型]。 您可能需要設定 [無驗證] 以連線到遠端偵錯工具。 [通用 (未加密通訊協定)][無驗證] 通訊協定沒有網路安全性,因此在開發與遠端電腦之間傳遞的資料很脆弱。 請只針對您確定不會有惡意或有害流量風險的受信任網路選擇這些驗證類型。

如果您選擇 [驗證類型][Windows 驗證],則必須在偵錯時登入遠端電腦。 遠端偵錯工具也必須在 [Windows 驗證] 模式下執行,且使用者帳戶與 Visual Studio 電腦上的使用者帳戶相同。

設定 C# 或 Visual Basic 專案以進行遠端偵錯

  1. 在 Visual Studio [方案總管] 中選取 C# 或 Visual Basic 專案,然後選取 [屬性] 圖示,按 Alt+Enter,或以滑鼠右鍵按一下並選擇 [屬性]

  2. 選取 [偵錯] 索引標籤。

  3. 在 [目標裝置] 下,針對遠端電腦選取 [遠端電腦],或針對直接連線的 Windows Mobile 10 裝置選取 [裝置]

  4. 針對遠端電腦,在 [遠端電腦] 欄位中輸入網路名稱或 IP 位址,或選取 [尋找] 以在 [遠端連線] 對話方塊中搜尋裝置。

    遠端偵錯的受控專案屬性

設定 C++ 專案以進行遠端偵錯

  1. 在 Visual Studio [方案總管] 中選取 C++ 專案,然後選取 [屬性] 圖示、按 Alt+Enter,或以滑鼠右鍵按一下並選擇 [屬性]

  2. 選取 [偵錯] 索引標籤。

  3. 在 [要啟動的偵錯工具] 下,針對遠端電腦選取 [遠端電腦],或針對直接連線的 Windows Mobile 10 裝置選取 [裝置]

  4. 針對遠端電腦,在 [電腦名稱] 欄位中輸入或選取網路名稱或 IP 位址,或下拉式清單,然後選取 [尋找] 以在 [遠端連線] 對話方塊中搜尋裝置。

    C++ 專案的遠端偵錯屬性。

使用 [遠端連線] 對話方塊

在 [遠端連線] 對話方塊中,您可以選取圓箭號重新整理圖示來搜尋特定的遠端電腦名稱稱或 IP 位址,或自動偵測連線。 對話方塊只會搜尋目前執行遠端偵錯工具之本機子網路上的裝置。 並非所有裝置都可以在 [遠端連線] 對話方塊中偵測到。

遠端連線對話框

提示

如果您無法依名稱連線到遠端裝置,請嘗試使用其 IP 位址。 若要判斷 IP 位址,請在遠端裝置上,在命令視窗中輸入 [ipconfig]。 IP 位址會顯示為 IPv4 位址

下載並安裝 Visual Studio 遠端工具

若要讓 Visual Studio 對遠端電腦上的應用程式進行偵錯,遠端電腦必須執行 Visual Studio 遠端工具。

  • Windows Mobile 10 裝置不需要或支援遠端工具。
  • 執行 Creators Update (版本 1703) 和更新版本的 Windows 11 電腦和 Windows 10 電腦、Windows 10 Xbox、IoT 和 HoloLens 裝置會在部署應用程式時自動安裝遠端工具。
  • 在前置 Creators Update Windows 10 電腦上,您必須先手動下載、安裝及執行遠端電腦上的遠端工具,才能開始偵錯。

若要下載及安裝遠端工具:

在您要進行偵錯的遠端裝置或伺服器上 (而非 Visual Studio 機器上),從下表的連結中下載並安裝正確的遠端工具版本。

  • 請下載適用您的 Visual Studio 版本的遠端工具最新更新。 舊版遠端工具與較新的 Visual Studio 版本無法相容。 (例如,如果您使用 Visual Studio 2019,請下載 Visual Studio 2019 的遠端工具最新更新。在此情況下,請勿下載 Visual Studio 2022 的遠端工具。)
  • 下載遠端工具時,其結構須與您安裝工具所在的電腦相同。 例如,如果您想要在執行 x64 作業系統的遠端電腦上,對 x86 應用程式進行偵錯,請安裝 x64 遠端工具。 若要在 ARM64 作業系統上對 x86、ARM 或 x64 應用程式進行偵錯,請安裝 ARM64 遠端工具。
版本 連結 備註
Visual Studio 2022 遠端工具 與所有 Visual Studio 2022 版本相容。 下載符合您裝置作業系統的版本 (x86、x64 (AMD64) 或 ARM64)。 在較舊版本的 Windows Server 上,請參閱解除封鎖檔案下載以取得關於下載遠端工具的説明。
Visual Studio 2019 遠端工具 適用於 Visual Studio 2019 的遠端工具可從 My.VisualStudio.com 取得。 如果出現提示,請加入免費的 Visual Studio Dev Essentials 計畫,或使用您的 Visual Studio 訂閱識別碼登入。 下載符合您裝置作業系統的版本 (x86、x64 (AMD64) 或 ARM64)。 在較舊版本的 Windows Server 上,請參閱解除封鎖檔案下載以取得關於下載遠端工具的説明。
Visual Studio 2017 遠端工具 適用於 Visual Studio 2017 的遠端工具可從 My.VisualStudio.com 取得。 如果出現提示,請加入免費的 Visual Studio Dev Essentials 計畫,或使用您的 Visual Studio 訂閱識別碼登入。 下載符合您裝置作業系統的版本 (x86、x64 (AMD64) 或 ARM64)。 在 Windows Server 上,請參閱將下載的檔案解除封鎖 ,以取得下載遠端工具的說明。
Visual Studio 2015 遠端工具 適用於 Visual Studio 2015 的遠端工具可從 My.VisualStudio.com 取得。 如果出現提示,請加入免費的 Visual Studio Dev Essentials 計畫,或使用您的 Visual Studio 訂閱識別碼登入。 在 Windows Server 上,請參閱將下載的檔案解除封鎖 ,以取得下載遠端工具的說明。
Visual Studio 2013 遠端工具 Visual Studio 2013 文件中的下載頁面
Visual Studio 2012 遠端工具 Visual Studio 2012 文件中的下載頁面
版本 連結 備註
Visual Studio 2019 遠端工具 與所有 Visual Studio 2019 版本相容。 下載符合您裝置作業系統的版本 (x86、x64 (AMD64) 或 ARM64)。 在 Windows Server 上,請參閱將下載的檔案解除封鎖 ,以取得下載遠端工具的說明。 如需最新版本的遠端工具,請開啟 Visual Studio 2022 文件
Visual Studio 2017 遠端工具 與所有 Visual Studio 2017 版本相容。 下載符合您裝置作業系統的版本 (x86、x64 (AMD64) 或 ARM64)。 在 Windows Server 上,請參閱將下載的檔案解除封鎖 ,以取得下載遠端工具的說明。
Visual Studio 2015 遠端工具 適用於 Visual Studio 2015 的遠端工具可從 My.VisualStudio.com 取得。 如果出現提示,請加入免費的 Visual Studio Dev Essentials 計畫,或使用您的 Visual Studio 訂閱識別碼登入。 在 Windows Server 上,請參閱將下載的檔案解除封鎖 ,以取得下載遠端工具的說明。
Visual Studio 2013 遠端工具 Visual Studio 2013 文件中的下載頁面
Visual Studio 2012 遠端工具 Visual Studio 2012 文件中的下載頁面

您可以將 msvsmon.exe 複製到遠端電腦 (而不是安裝遠端工具),來執行遠端偵錯工具。 不過,只有在安裝遠端工具時,才會出現遠端偵錯工具設定精靈 (rdbgwiz.exe)。 如果您想要以服務形式執行遠端偵錯工具,您可能需要使用精靈進行設定。 如需詳細資訊,請參閱 (選擇性) 將遠端偵錯工具設定為服務

注意

  • 若要對 ARM 裝置上的 Windows 10 或更新版的應用程式進行偵錯,請使用 ARM64,其可透過最新版本的遠端工具取得。
  • 若要對 Windows RT 裝置上的 Windows 10 應用程式進行偵錯,請使用 ARM,其只能在 Visual Studio 2015 遠端工具下載中取得。
  • 若要對 ARM64 作業系統上的 x64 應用程式進行偵錯,請執行隨著 ARM64 遠端工具一起安裝的 x64 msvsmon.exe。

設定遠端工具

  1. 在遠端電腦上,從 [開始] 功能表尋找並啟動遠端偵錯工具

    如果您沒有遠端電腦上的系統管理權限,請以滑鼠右鍵按一下 [遠端偵錯工具] 應用程式,然後選取 [以系統管理員身分執行]。 否則,只要正常啟動即可。

    如果您打算連結至以系統管理員身分執行的程序,或是在不同使用者帳戶下執行的程序,請以滑鼠右鍵按一下 [遠端偵錯工具] 應用程式,然後選取 [以系統管理員身分執行]。 如需詳細資訊,請參閱以系統管理員身分執行遠端偵錯工具

  2. 第一次啟動遠端偵錯工具時 (或設定遠端工具之前),遠端偵錯設定精靈會隨即出現。

    在大部分情況下,請一直選擇 [下一步],直到進入精靈的 [設定 Windows 防火牆] 頁面為止。

    遠端偵錯工具設定的螢幕擷取畫面。

    遠端偵錯工具設定的螢幕擷取畫面。

    如果沒有安裝 Windows Web 服務 API (只有在 Windows Server 2008 R2 上才會發生這種情況),請選取 [安裝] 按鈕。

  3. 請選取至少一個您想要在其中使用遠端工具的網路類型。 如果此電腦經由網域連線,您就必須選擇第一個項目。 如果電腦經由工作群組或家用群組連線,請視情況選擇第二個或第三個項目。

    接下來,選取 [完成] 以啟動遠端偵錯工具。

    接下來,選取 [設定遠端偵錯] 以啟動遠端偵錯工具。

  4. 設定完成時,[遠端偵錯工具] 視窗會隨即出現。

    遠端偵錯工具視窗的螢幕擷取畫面

    遠端偵錯工具視窗的螢幕擷取畫面

    遠端偵錯工具現在會等候連線。 使用顯示的伺服器名稱和連接埠號碼,在 Visual Studio 中設定遠端連線設定。

若要停止遠端偵錯工具,請選取 [檔案]>[結束]。 您可以從 [開始] 功能表或從命令列將其重新啟動:

<Remote debugger installation directory>\msvsmon.exe

從遠端偵錯 UWP 應用程式

遠端偵錯的運作方式與本機偵錯相同。

  1. 在 Windows 10 Creators Update 之前的版本上,請確定遠端偵錯監視 (msvsmon.exe) 正在遠端裝置上執行。

  2. 在 Visual Studio 電腦上,確定工具列上綠色箭號旁邊會出現正確的偵錯目標 ([遠端電腦] 或 [裝置])。

  3. 選取 [偵錯]>[開始偵錯],按 [F5],或選取工具列上的綠色箭頭,以開始偵錯。

    專案會重新編譯,然後在遠端裝置上部署並啟動。 偵錯工具會在中斷點暫停執行,而您可以逐步執行、跳過和跳離程式碼。

  4. 如有必要,請選取 [偵錯]>[停止偵錯],或按 Shift+F5 停止偵錯並關閉遠端應用程式。