Debug remoto di un progetto C++ in Visual Studio

Per eseguire il debug di un'applicazione di Visual Studio in un computer diverso, installare ed eseguire gli strumenti remoti nel computer in cui si distribuirà l'app, configurare il progetto per connettersi al computer remoto da Visual Studio e quindi distribuire ed eseguire l'app.

Per informazioni sul debug remoto di app UWP (Universal Windows Apps), vedi Eseguire il debug di un pacchetto di app installato.

Requisiti

Il debugger remoto è supportato in Windows 7 e versioni successive e di Windows Server a partire da Windows Server 2008 Service Pack 2. Per un elenco completo dei requisiti, vedere Requisiti.

Scaricare e installare Remote Tools

Nel dispositivo remoto o nel server in cui si vuole eseguire il debug, anziché nel computer di Visual Studio, scaricare e installare la versione corretta degli strumenti remoti dai collegamenti nella tabella seguente.

• Scaricare gli strumenti remoti più recenti per la versione di Visual Studio. La versione più recente degli strumenti remoti è compatibile con le versioni precedenti di Visual Studio, ma le versioni precedenti degli strumenti remoti non sono compatibili con le versioni successive di Visual Studio. Ad esempio, se si usa Visual Studio 2019, scaricare l'aggiornamento più recente degli strumenti remoti per Visual Studio 2019. In questo scenario non scaricare gli strumenti remoti per Visual Studio 2022.
• Scaricare gli strumenti remoti con la stessa architettura del computer in cui si stanno installando. Ad esempio, se si vuole eseguire il debug di un'app a 32 bit in un computer remoto che esegue un sistema operativo a 64 bit, installare gli strumenti remoti a 64 bit.
• Se si esegue il debug remoto di un'applicazione ARM64EC in un dispositivo ARM64, installare gli strumenti remoti ARM64 e quindi avviare il debugger remoto x64 che viene installato con tali strumenti. Questa opzione è disponibile in: Programmi (x86)\Microsoft Visual Studio<version>\Common7\IDE\Remote Debugger\x64.

È possibile eseguire il debugger remoto copiando msvsmon.exe nel computer remoto, anziché installando gli strumenti remoti. Tuttavia, la Configurazione guidata debugger remoto (rdbgwiz.exe) è disponibile solo quando si installano gli strumenti remoti. Potrebbe essere necessario usare la procedura guidata per la configurazione se si vuole eseguire il debugger remoto come servizio. Per altre informazioni, vedere (Facoltativo) Configurare il debugger remoto come servizio.

Configurare il debugger remoto

1. Nel computer remoto trovare e avviare Remote Debugger dal menu Start .

   Se non si dispone delle autorizzazioni amministrative nel computer remoto, fare clic con il pulsante destro del mouse sull'app Debugger remoto e scegliere Esegui come amministratore. In caso contrario, inizialo normalmente.

   Se si prevede di connettersi a un processo in esecuzione come amministratore o in esecuzione con un account utente diverso,ad esempio IIS, fare clic con il pulsante destro del mouse sull'app Debugger remoto e selezionare Esegui come amministratore. Per altre informazioni, vedere Eseguire il debugger remoto come amministratore.

2. La prima volta che si avvia il debugger remoto (o prima di averla configurata), viene visualizzata la configurazione guidata debug remoto.

   Nella maggior parte degli scenari scegliere Avanti fino a visualizzare la pagina Configura Windows Firewall della procedura guidata.

   

   

   Se l'API di Servizi Web Windows non è installata, che si verifica solo in Windows Server 2008 R2, selezionare il pulsante Installa .

3. Selezionare almeno un tipo di rete su cui si vogliono usare gli strumenti remoti. Se i computer sono connessi tramite un dominio, è necessario scegliere il primo elemento. Se i computer sono connessi tramite un gruppo di lavoro o un gruppo home, scegliere il secondo o il terzo elemento in base alle esigenze.

   Selezionare quindi Fine per avviare il debugger remoto.

   Selezionare quindi Configura debug remoto per avviare il debugger remoto.

4. Al termine della configurazione, viene visualizzata la finestra Debugger remoto.

   

   

   Il debugger remoto è ora in attesa di una connessione. Usare il nome del server e il numero di porta visualizzati per impostare la configurazione della connessione remota in Visual Studio.

Per arrestare il debugger remoto, selezionare Uscita file>. È possibile riavviarlo dal menu Start o dalla riga di comando:

<Remote debugger installation directory>\msvsmon.exe

Eseguire il debug remoto di un progetto C++

Nella procedura seguente il percorso del progetto è C:\remotetemp e il nome del computer remoto è MySurface.

1. Creare un'applicazione console C++ denominata CppConsoleApp

2. Impostare un punto di interruzione in un punto qualsiasi dell'applicazione facilmente raggiungibile, ad esempio in CppConsoleApp.cpp, nella main funzione .

3. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e scegliere Proprietà. Aprire la scheda Debug.

4. Impostare Debugger da avviare su Debugger Windows remoto.

   

5. Apportare le seguenti modifiche alle proprietà:

   Impostazione	Valore
   Comando remoto	C:\remotetemp\CppConsoleApp.exe
   Directory di lavoro	C:\remotetemp
   Nome server remoto	MySurface:portnumber
   Connessione	Remoto con autenticazione di Windows
   Tipo di debugger	Solo nativo
   Directory di distribuzione	C:\remotetemp
   File aggiuntivi da distribuire	$(ProjectDir)\data

   Se si distribuiscono cartelle aggiuntive e si desidera che tutti i file in una cartella vengano distribuiti nella stessa cartella, specificare un nome di cartella.

   Per altre informazioni sulle proprietà, vedere Impostazioni del progetto per una configurazione di debug C++.

6. In Esplora soluzioni fare clic con il pulsante destro del mouse sulla soluzione e scegliere Configuration Manager.

7. Per la configurazione Debug, selezionare la casella di controllo Distribuisci.

   

8. Avviare il debug (Debug > Avvia debug o F5).

9. Il file eseguibile viene distribuito automaticamente al computer remoto.

10. Se richiesto, immettere le credenziali di rete per connettersi al computer remoto.

    Le credenziali necessarie sono specifiche della configurazione di sicurezza della rete. Ad esempio, in un computer di dominio, è possibile scegliere un certificato di sicurezza o immettere il nome di dominio e la password. In un computer non di dominio è possibile immettere il nome del computer e un nome di account utente valido, ad esempio MySurface\name@something.com, insieme alla password corretta.

11. Nel computer di Visual Studio l'esecuzione viene arrestata in corrispondenza del punto di interruzione.

    Suggerimento

    In alternativa, è possibile distribuire i file come passaggio separato. Nel Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto e quindi scegliere Distribuisci.

    Se sono presenti file non di codice richiesti dall'applicazione, è possibile specificarli in un elenco delimitato da punto e virgola in File aggiuntivi da distribuire nella pagina Debugger Windows remoto.

    In alternativa, è possibile includere i file nel progetto e impostare la proprietà Content su Sì nella pagina Proprietà per ogni file. Questi file vengono copiati nella directory di distribuzione specificata nella pagina Debugger Windows remoto. È anche possibile modificare il tipo di elemento in Copia file e specificare proprietà aggiuntive se è necessario copiare i file in una sottocartella della directory di distribuzione.

Configurare il debug con simboli remoti

Dovrebbe essere possibile eseguire il debug del codice con i simboli generati nel computer di Visual Studio. L'uso di simboli locali consente di migliorare notevolmente le prestazioni del debugger remoto.

Se è necessario usare simboli remoti, è necessario specificare i simboli remoti in Visual Studio aggiungendo una condivisione file di Windows al percorso di ricerca dei simboli in Strumenti > Opzioni > Debug > simboli.

Contenuto correlato

• Debug in Visual Studio
• Presentazione del debugger
• Configurare Windows Firewall per il debug remoto
• Assegnazioni di porta del debugger remoto
• Debug remoto di ASP.NET in un computer remoto con IIS
• Errori e risoluzione dei problemi relativi al debug remoto