Vzdálené ladění projektu C++ v sadě Visual Studio

Pokud chcete ladit aplikaci sady Visual Studio na jiném počítači, nainstalujte a spusťte vzdálené nástroje na počítači, kde aplikaci nasadíte. Nakonfigurujte projekt tak, aby se připojoval ke vzdálenému počítači, a poté aplikaci nasaďte a spusťte.

Informace o vzdáleném ladění univerzálních aplikací pro Windows (UPW) najdete v tématu Ladění nainstalovaného balíčku aplikace.

Požadavky

Vzdálený ladicí program je podporován v systémech Windows 7 a novějších verzích Systému Windows Server počínaje aktualizací Windows Server 2008 Service Pack 2. Úplný seznam požadavků najdete v tématu Požadavky.

Poznámka

Ladění mezi dvěma počítači připojenými přes proxy server se nepodporuje. Ladění přes připojení s vysokou latencí nebo malou šířkou pásma, jako je vytáčené připojení nebo přes internet napříč zeměmi nebo oblastmi, se nedoporučuje a může selhat nebo být nepřijatelně pomalé.

Stažení a instalace vzdálených nástrojů

Na vzdáleném zařízení nebo serveru, na který chcete ladit, a ne na počítači se sadou Visual Studio, stáhněte a nainstalujte správnou verzi vzdálených nástrojů z odkazů v následující tabulce.

• Stáhněte si nejnovější vzdálené nástroje pro vaši verzi sady Visual Studio. Nejnovější verze vzdálených nástrojů je kompatibilní se staršími verzemi sady Visual Studio, ale starší verze vzdálených nástrojů nejsou kompatibilní s novějšími verzemi sady Visual Studio. (Pokud například používáte Visual Studio 2019, stáhněte si nejnovější aktualizaci vzdálených nástrojů pro Visual Studio 2019. V tomto scénáři nestahujte vzdálené nástroje pro Visual Studio 2022.)
• Stáhněte si vzdálené nástroje se stejnou architekturou jako počítač, na který je instalujete. Pokud například chcete ladit 32bitovou aplikaci na vzdáleném počítači s 64bitovým operačním systémem, nainstalujte 64bitové vzdálené nástroje.
• Pokud vzdáleně ladíte aplikaci ARM64EC na zařízení ARM64, nainstalujte vzdálené nástroje ARM64 a spusťte vzdálený ladicí program x64, který se nainstaluje s těmito nástroji. Najdete ji v části: Program Files (x86)\Microsoft Visual Studio<verze>\Common7\IDE\Remote Debugger\x64.

Verze	Odkaz	Poznámky
Visual Studio 2022	Vzdálené nástroje	Kompatibilní se všemi verzemi sady Visual Studio 2022. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru se podívejte do části Odblokování stahování souboru pro nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2019	Vzdálené nástroje	Nástroje pro Visual Studio 2019 pro vzdálenou práci jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se ke programu Visual Studio Dev Essentials zdarma nebo se přihlaste pomocí ID předplatného programu Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru si přečtěte Odblokování stahování souboru nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2017	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2017 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatné programu Visual Studio Dev Essentials nebo se přihlaste pomocí ID předplatného sady Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. V systému Windows Server, podívejte se na Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2015	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2015 jsou k dispozici v My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste se pomocí ID svého předplatného sady Visual Studio. Ve Windows Serveru se podívejte na Odblokovat stahování souboru pro pomoc s dálným nástrojem.
Visual Studio 2013	vzdálených nástrojů	Stránka ke stažení v dokumentaci k sadě Visual Studio 2013
Visual Studio 2012	Vzdálené nástroje	Stránka ke stažení v dokumentaci k sadě Visual Studio 2012

Vzdálený ladicí program můžete spustit zkopírováním msvsmon.exe do vzdáleného počítače, nikoli instalací vzdálených nástrojů. Průvodce konfigurací vzdáleného ladicího programu (rdbgwiz.exe) je však k dispozici pouze při instalaci vzdálených nástrojů. Pokud chcete spustit vzdálený ladicí program jako službu, možná budete muset použít průvodce pro konfiguraci. Další informace viz (volitelné) konfigurace vzdáleného debuggeru jako služby.

Poznámka

• Pokud chcete ladit aplikace pro Windows 10 nebo novější na zařízeních ARM, použijte ARM64, který je k dispozici s nejnovější verzí vzdálených nástrojů.
• Pokud chcete ladit aplikace pro Windows 10 na zařízeních s Windows RT, použijte ARM, který je dostupný jenom ve stažení vzdálených nástrojů sady Visual Studio 2015.

Spropitné

V některých scénářích může být nejúčinnější spustit vzdálený ladicí program ze sdílené složky. Další informace viz Spuštění vzdáleného ladicího programu ze sdílené složky.

Nastavte vzdálený ladicí program

1. Na vzdáleném počítači vyhledejte a spusťte vzdálený ladicí program z nabídky Start.

   Pokud nemáte oprávnění správce na vzdáleném počítači, klikněte pravým tlačítkem myši na aplikaci vzdáleného ladicího programu a vyberte Spustit jako správce. V opačném případě ho jednoduše zahajte normálně.

   Pokud se chystáte připojit k procesu, který běží jako správce nebo běží pod jiným uživatelským účtem (například IIS), klikněte pravým tlačítkem na aplikaci Remote Debugger a vyberte Spustit jako správce. Další informace naleznete v tématu Spuštění vzdáleného ladicího programu jako správce.

2. Při prvním spuštění vzdáleného debuggeru (nebo před jeho nakonfigurováním) se zobrazí průvodce konfigurací vzdáleného ladění.

   Ve většině scénářů zvolte Další, dokud se nedostanete na stránku konfiguračního průvodce Konfigurovat Windows Firewall.

   

3. Vyberte aspoň jeden typ sítě, na který chcete používat vzdálené nástroje. Pokud jsou počítače připojené přes doménu, musíte zvolit první položku. Pokud jsou počítače připojené přes pracovní skupinu nebo domácí skupinu, podle potřeby zvolte druhou nebo třetí položku.

   Potom vyberte Dokončit a spusťte vzdálený ladicí program.

4. Po dokončení konfigurace se zobrazí okno vzdáleného ladicího programu.

   

   Vzdálený ladicí nástroj teď čeká na připojení. K nastavení konfigurace vzdáleného připojení v sadě Visual Studio použijte název serveru a číslo portu.

Pokud chcete vzdálený ladicí program zastavit, vyberte Soubor>Ukončit. Můžete ho restartovat z nabídky Start nebo z příkazového řádku:

<Remote debugger installation directory>\msvsmon.exe

Poznámka

Pokud potřebujete přidat oprávnění pro další uživatele, změnit režim ověřování nebo číslo portu vzdáleného ladicího programu, přečtěte si téma Konfigurace vzdáleného ladicího programu.

Vzdáleně ladit projekt v C++

V následujícím postupu je cesta projektu C:\remotetemp a název vzdáleného počítače je MySurface.

1. Vytvoření konzolové aplikace C++ s názvem CppConsoleApp

2. Nastavte zarážku na místě v aplikaci, které je snadno dosažitelné, například v CppConsoleApp.cpp, ve funkci main.

3. V Průzkumníku řešení klikněte pravým tlačítkem na projekt a vyberte Vlastnosti. Otevřete kartu Ladění.

4. Nastavte ladicí program na spuštění na vzdálený ladicí program systému Windows.

   

5. Proveďte následující změny vlastností:

   Nastavení	Hodnota
   Vzdálený příkaz	C:\remotetemp\CppConsoleApp.exe
   Pracovní adresář	C:\remotetemp
   Název vzdáleného serveru	MySurface:číslo portu
   Připojení	Vzdálený přístup s autentizací systému Windows
   Typ ladicího programu	Pouze nativní
   Adresář nasazení	C:\remotetemp
   Další soubory k nasazení	$(ProjectDir)\data

   Pokud nasadíte další složky a chcete všechny soubory ve složce nasazené do stejné složky, zadejte název složky.

   Chcete-li získat další informace o vlastnostech, podívejte se na Nastavení projektu pro konfiguraci ladění C++.

6. V Průzkumníku řešení klikněte pravým tlačítkem na řešení a zvolte Configuration Manager.

7. Pro konfiguraci Ladění zaškrtněte políčko Nasazení.

   

8. Spusťte ladění (Ladění > Spustit ladění, nebo F5).

9. Spustitelný soubor se automaticky nasadí do vzdáleného počítače.

10. Pokud se zobrazí výzva, zadejte síťové přihlašovací údaje pro připojení ke vzdálenému počítači.

    Požadované přihlašovací údaje jsou specifické pro konfiguraci zabezpečení vaší sítě. Například na počítači domény můžete zvolit certifikát zabezpečení nebo zadat název domény a heslo. Na počítači, který není doména, můžete zadat název počítače a platný název uživatelského účtu, například MySurface\name@something.com, spolu se správným heslem.

11. Na počítači s Visual Studiem byste měli vidět, že se spuštění zastavilo na zarážce.

    Spropitné

    Případně můžete soubory nasadit jako samostatný krok. V Průzkumníku řešení klikněte pravým tlačítkem myši na uzel projektu a pak zvolte Nasadit.

    Pokud máte nekódové soubory, které aplikace potřebuje, můžete je zadat v seznamu odděleném středníkem v Další soubory k nasazení na stránce vlastností ladicího programu s vybranou možností vzdáleného ladicího programu systému Windows.

    Alternativně můžete zahrnout soubory do projektu a nastavit vlastnost Content na Ano na stránce Vlastnosti pro každý soubor. Tyto soubory se zkopírují do adresáře nasazení Deployment Directory, který je uveden na stránce vlastností ladicího programu s vybraným Vzdálený ladicí program systému Windows. Můžete také změnit typ položky na Kopírovat soubor a zadat další vlastnosti, pokud potřebujete soubory zkopírovat do podsložky adresáře Nasazení.

Nastavení ladění pomocí vzdálených symbolů

Měli byste být schopni ladit kód pomocí symbolů, které vygenerujete na počítači se sadou Visual Studio. Výkon vzdáleného ladicího programu je mnohem lepší, když používáte lokální symboly.

Pokud je nutné použít vzdálené symboly, je nutné zadat vzdálené symboly v sadě Visual Studio přidáním sdílené složky systému Windows do cesty hledání symbolů v nástrojích Nástroje > Možnosti > Ladění > symboly.

Související obsah

• ladění v sadě Visual Studio
• Nejprve se podívejte na ladicího programu
• Konfigurace brány Windows Firewall pro vzdálené ladění
• přiřazení portů vzdáleného ladicího programu
• Ladění ASP.NET na vzdáleném serveru IIS
• Chyby vzdáleného ladění a odstraňování problémů