Fjärrfelsökning av ett C++-projekt i Visual Studio

Om du vill felsöka ett Visual Studio-program på en annan dator installerar och kör du fjärrverktygen på den dator där du ska distribuera din app, konfigurerar projektet för att ansluta till fjärrdatorn från Visual Studio och distribuerar och kör sedan appen.

Information om fjärrfelsökning av Universella Windows-appar (UWP) finns i Felsöka ett installerat apppaket.

Krav

Fjärrfelsökaren stöds på Windows 7 och senare och versioner av Windows Server från och med Windows Server 2008 Service Pack 2. En fullständig lista över krav finns i Krav.

Ladda ned och installera fjärrverktygen

På fjärrenheten eller servern som du vill felsöka på i stället för Visual Studio-datorn laddar du ned och installerar rätt version av fjärrverktygen från länkarna i följande tabell.

• Ladda ned de senaste fjärrverktygen för din version av Visual Studio. Den senaste versionen av fjärrverktyg är kompatibel med tidigare Visual Studio-versioner, men tidigare versioner av fjärrverktyg är inte kompatibla med senare Visual Studio-versioner. (Om du till exempel använder Visual Studio 2019 laddar du ned den senaste uppdateringen av fjärrverktygen för Visual Studio 2019. I det här scenariot ska du inte ladda ned fjärrverktygen för Visual Studio 2022.)
• Ladda ned fjärrverktygen med samma arkitektur som den dator som du installerar dem på. Om du till exempel vill felsöka en 32-bitarsapp på en fjärrdator som kör ett 64-bitars operativsystem installerar du 64-bitars fjärrverktygen.
• Om du fjärrfelsöker ett ARM64EC program på en ARM64-enhet installerar du ARM64-fjärrverktygen och startar sedan x64-fjärrfelsökaren som installeras med dessa verktyg. Detta finns under: Program Files (x86)\Microsoft Visual Studio<version>\Common7\IDE\Remote Debugger\x64.

Du kan köra fjärrfelsökaren genom att kopiera msvsmon.exe till fjärrdatorn i stället för att installera fjärrverktygen. Konfigurationsguiden för fjärrfelsökaren (rdbgwiz.exe) är dock endast tillgänglig när du installerar fjärrverktygen. Du kan behöva använda guiden för konfiguration om du vill köra fjärrfelsökaren som en tjänst. Mer information finns i (valfritt) Konfigurera fjärrfelsökaren som en tjänst.

Konfigurera fjärrfelsökaren

1. På fjärrdatorn letar du upp och startar Remote Debugger- från menyn Start.

   Om du inte har administratörsbehörighet på fjärrdatorn högerklickar du på appen Fjärrfelsökare och väljer Kör som administratör. Annars är det bara att starta det som vanligt.

   Om du planerar att ansluta till en process som körs som administratör eller körs under ett annat användarkonto (till exempel IIS) högerklickar du på fjärrfelsökaren app och väljer Kör som administratör. Mer information finns i Kör fjärrfelsökaren som administratör.

2. Första gången du startar fjärrfelsökaren (eller innan du har konfigurerat den) visas guiden Fjärrfelsökningskonfiguration.

   I de flesta scenarier väljer du Nästa tills du kommer till sidan Konfigurera Windows-brandväggen i guiden.

   

   

   Om Windows Web Services-API:et inte är installerat, vilket endast sker på Windows Server 2008 R2, väljer du knappen Installera.

3. Välj minst en nätverkstyp som du vill använda fjärrverktygen på. Om datorerna är anslutna via en domän måste du välja det första objektet. Om datorerna är anslutna via en arbetsgrupp eller hemgrupp väljer du det andra eller tredje objektet efter behov.

   Välj sedan Slutför för att starta fjärrfelsökaren.

   Välj sedan Konfigurera fjärrfelsökning för att starta fjärrfelsökaren.

4. När konfigurationen är klar visas fönstret Fjärrfelsökare.

   

   

   Fjärrfelsökaren väntar nu på en anslutning. Använd servernamnet och portnumret som visas för att ange fjärranslutningskonfigurationen i Visual Studio.

Om du vill stoppa fjärrfelsökaren väljer du Fil>Avsluta. Du kan starta om den från menyn Starta eller från kommandoraden:

<Remote debugger installation directory>\msvsmon.exe

Fjärrfelsöka ett C++-projekt

I följande procedur är sökvägen till projektet C:\remotetemp och namnet på fjärrdatorn är MySurface.

1. Skapa ett C++-konsolprogram med namnet CppConsoleApp

2. Ange en brytpunkt någonstans i programmet som enkelt nås, till exempel i CppConsoleApp.cppi funktionen main.

3. Högerklicka på projektet i Solution Explorer och välj Egenskaper. Öppna fliken Felsökning.

4. Ställ in -felsökaren för att starta till Remote Windows Debugger.

   

5. Gör följande ändringar i egenskaperna:

   Inställning	Värde
   Fjärrkommando	C:\remotetemp\CppConsoleApp.exe
   Arbetskatalog	C:\remotetemp
   Fjärrservernamn	MySurface:portnummer
   Anslutning	Fjärranslutning med Windows-autentisering
   Avlusartyp	Endast inhemskt
   Distributionskatalog	C:\remotetemp
   Ytterligare filer att distribuera	$(ProjectDir)\data

   Om du distribuerar ytterligare mappar och vill att alla filer i en mapp ska distribueras till samma mapp anger du ett mappnamn.

   Mer information om egenskaperna finns i Project-inställningar för en C++ felsökningskonfiguration.

6. Högerklicka på lösningen i Solution Explorer och välj Configuration Manager.

7. För konfigurationen Felsökning markerar du kryssrutan Distribuera.

   

8. Börja felsöka (Felsök > Starta felsökningeller F5).

9. Den körbara filen distribueras automatiskt till fjärrdatorn.

10. Om du uppmanas att göra det anger du autentiseringsuppgifter för nätverket för att ansluta till fjärrdatorn.

    De nödvändiga autentiseringsuppgifterna är specifika för nätverkets säkerhetskonfiguration. På en domändator kan du till exempel välja ett säkerhetscertifikat eller ange ditt domännamn och lösenord. På en dator som inte är domän kan du ange datornamnet och ett giltigt användarkontonamn, till exempel MySurface\name@something.com, tillsammans med rätt lösenord.

11. På Visual Studio-datorn bör du se att körningen har stoppats vid brytpunkten.

    Tips

    Du kan också distribuera filerna som ett separat steg. I Solution Explorer högerklicka på projektnoden och välj sedan Distribuera.

    Om du har icke-kodfiler som krävs av applikationen kan du ange dem i en semikolonavgränsad lista i Ytterligare filer för distribution på egenskapssidan för Felsökaren med Fjärr-Windows-felsökaren markerad.

    Du kan också inkludera filerna i projektet och ange egenskapen Content till Ja på sidan Egenskaper för varje fil. De här filerna kopieras till Deployment Directory som anges på egenskapssidan felsökningsprogrammet med Fjärrfelsökare för Windows markerat. Du kan också ändra objekttyp till Kopiera fil och ange ytterligare egenskaper där om du behöver kopiera filerna till en undermapp i Deployment Directory.

Konfigurera felsökning med fjärrsymboler

Du bör kunna felsöka koden med de symboler som du genererar på Visual Studio-datorn. Fjärrfelsökarens prestanda är mycket bättre när du använder lokala symboler.

Om du måste använda fjärrsymboler måste du ange fjärrsymbolerna i Visual Studio genom att lägga till en Windows-filresurs i sökvägen för symbolsökningen i Tools > Options > Debugging > Symbols.

Relaterat innehåll

• Felsökning i Visual Studio
• En första titt på felsökningsprogrammet
• Konfigurera Windows-brandväggen för fjärrfelsökning
• Porttilldelningar för fjärrfelsökare
• Fjärrfelsökning ASP.NET på en fjärr-IIS-dator
• Fel vid fjärrfelsökning och felsökning