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

Pokud chcete ladit Visual Studio aplikaci na jiném počítači, nainstalujte a spusťte vzdálené nástroje na počítači, na kterém aplikaci nasadíte, nakonfigurujte project pro připojení ke vzdálenému počítači z Visual Studio a pak nasaďte a spusťte aplikaci.

komponenty vzdáleného ladicího programuRemote_debugger_components

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 nízkou šířkou pásma, jako je například vytáčené připojení k internetu nebo přes internet mezi různými 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, místo Visual Studio počítače 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ší aktualizaci vzdálených nástrojů pro vaši verzi Visual Studio. Vzdálené nástroje pro Visual Studio 2022 a 2026 je možné použít s některou verzí Visual Studio. Verze vzdálených nástrojů starší než Visual Studio 2022 ale nejsou kompatibilní s novějšími verzemi 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<version>\Common7\IDE\Remote Debugger\x64.

Verze	Odkaz	Poznámky
Visual Studio 2026	Vzdálené nástroje	Kompatibilní s Visual Studio 2022 a novějšími verzemi. 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 2022	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2022 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 pomocí SVÉHO ID předplatného 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 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	Dálkové nástroje pro Visual Studio 2019 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného 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 se podívejte do části Odblokování stahování souboru pro 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ému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného 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 pomocí SVÉHO ID předplatného Visual Studio. 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 2013	Vzdálené nástroje	Stránka ke stažení v dokumentaci k Visual Studio 2013
Visual Studio 2012	Vzdálené nástroje	Stránka ke stažení v dokumentaci k 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

• K ladění Windows 10 nebo novějších aplikací na zařízeních ARM použijte ARM64, který je k dispozici s nejnovější verzí vzdálených nástrojů.
• Pokud chcete ladit Windows 10 aplikace na zařízeních Windows RT, použijte ARM, který je k dispozici pouze ve stažení vzdálených nástrojů 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

Po instalaci vzdáleného ladicího programu postupujte podle těchto kroků.

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 Konfigurovat vzdálené ladění.

   Snímek obrazovky konfigurace vzdáleného ladicího programu.Konfigurace vzdáleného ladicího programu

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.

   snímek obrazovky okna vzdáleného ladicího programuokno 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 Visual Studio použijte název serveru a číslo portu.

Pokud chcete vzdálený ladicí program zastavit, vyberte SouborUkonč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ěňte režim ověřování nebo číslo portu vzdáleného ladicího programu, viz Konfigurace vzdáleného ladicího programu.

Vzdálené ladění C++ projektu

V následujícím postupu je cesta project 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 .

3. V Solution Explorer klikněte pravým tlačítkem na project a vyberte Properties. 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 ověřením systému Windows
   Typ ladicího programu	Pouze nativní
   Adresář nasazení	C:\remotetemp
   Další soubory k nasazení	$(ProjectDir)\data

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

   Další informace o vlastnostech najdete v tématu nastavení projektu pro ladicí konfiguraci C++.

6. V Solution Explorer 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 nedoménovém počítači můžete zadat název počítače a platný název uživatelského účtu, například MySurface\, spolu se správným heslem.

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

    Spropitné

    Případně můžete soubory nasadit jako samostatný krok. V Solution Explorer klikněte pravým tlačítkem na uzel project a potom zvolte Deploy.

    Pokud máte neprogramové soubory, které aplikace vyžaduje, můžete je zadat v seznamu odděleném středníkem v části Další soubory k nasazení na stránce vlastností Ladicího programu s vybranou možností Vzdálený ladicí program systému Windows.

    Případně můžete zahrnout soubory do svého project a nastavit vlastnost Content na Yes na stránce Properties 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. Typ položky můžete také změnit 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ů

Kód byste měli být schopni ladit pomocí symbolů, které vygenerujete v počítači Visual Studio. Výkon vzdáleného ladicího programu je lepší, když používáte místní symboly.

Pokud je nutné použít vzdálené symboly, je nutné zadat vzdálené symboly v Visual Studio přidáním sdílené složky Systému Windows do cesty hledání symbolů.

Otevřete podokno NástrojeMožnosti, rozbalte v části Veškerá nastaveníLaděníObecnésymbolyLokality hledání a aktualizujte seznam umístění souborů symbolů (.pdb). Podle potřeby upravte další nastavení.

Související obsah

• ladění v 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
• Vzdálené ladění ASP.NET na vzdáleném počítači s IIS
• Chyby vzdáleného ladění a odstraňování problémů