Come avviare una sessione di debug (JavaScript)
Questo argomento descrive come avviare una sessione di debug per le app di Windows Store scritte in JavaScript e in HTML5. Puoi avviare il debug con una sola sequenza di tasti oppure configurare una sessione di debug per scenari specifici e scegliere quindi la modalità di avvio dell'app.
In questo argomento
In this topic
The easy way to start debugging
Configure the debugging session
Open the debugging property page for the project
Choose the build configuration options
Choose the deployment target
Choose the debugger to use
(Optional) Delay starting the app in the debug session
(Optional) Disable network loopbacks
Start the debugging session
Start debugging (F5)
Start debugging (F5) but delay the app start
Start an installed app in the debugger
Attach the debugger to a running app
Set the app to run in debug mode
Attach the debugger
Il modo più semplice per avviare il debug
Apri la soluzione dell'app in Visual Studio.
Premi F5.
Visual Studio compila e avvia l'app con il debugger collegato. L'esecuzione continua fino a raggiungere un punto di interruzione. Sospendi manualmente l'esecuzione e si verifica un'eccezione non gestita o l'app termina. Per ulteriori informazioni, vedi Guida rapida: Debug di app (JavaScript).
Configurare la sessione di debug
Poiché lo script non viene compilato, le impostazioni relative alla piattaforma e alla configurazione della compilazione non sono applicabili. Se esegui il debug di un componente gestito o C++, imposta Configurazione su Debug e seleziona la piattaforma di destinazione nella finestra di dialogo Configurazione.
Aprire la pagina delle proprietà di debug per il progetto
Seleziona il progetto in Esplora soluzioni. Scegli Proprietà dal menu di scelta rapida.
Espandi il nodo Proprietà di configurazione, quindi scegli Debug.
Scegliere le opzioni di configurazione della compilazione
Dall'elenco Configurazione scegli Debug o Debug (attivo).
Dall'elenco Piattaforma seleziona la piattaforma di destinazione per cui eseguire la compilazione. Nella maggior parte dei casi, Qualsiasi CPU è la scelta ottimale.
Scegliere la destinazione di distribuzione
Puoi distribuire ed eseguire il debug di un'app nel computer che esegue Visual Studio, nel simulatore di Visual Studio sul computer locale o in un computer remoto. Scegli la destinazione dall'elenco Debugger da avviare nella pagina delle proprietà Debug del progetto.
Scegli una di queste opzioni dall'elenco Debugger da avviare:
Computer locale |
Esegue il debug dell'app nella sessione corrente nel computer locale. Vedi Esecuzione di app di Windows Store in un computer locale. |
Simulatore |
Esegue il debug dell'app nel simulatore di Visual Studio per le app in Windows Store. Il simulatore è una finestra del desktop che consente di eseguire il debug delle funzionalità del dispositivo, ad esempio i movimenti tocco e la rotazione del dispositivo, che non sono disponibile nel computer locale. Vedi Esecuzione di app di Windows Store nel simulatore. |
Computer remoto |
Esegue il debug dell'app in un dispositivo connesso al computer locale su una rete Intranet o collegato direttamente tramite un cavo Ethernet. Per eseguire il debug in modalità remota, Visual Studio Remote Tools deve essere installato e in esecuzione sul dispositivo remoto. Vedi Esecuzione di app di Windows Store in un computer remoto. |
Se scegli Computer remoto, specifica il nome o l'indirizzo IP del computer remoto nei modi seguenti:
Nella casella Nome computer immetti il nome o l'indirizzo IP del computer remoto.
Fai clic sulla freccia in giù nella casella Nome computer e scegli <Trova...>. Scegli quindi il computer remoto nella finestra di dialogo Seleziona connessione debugger remoto.
Nota
Nella finestra di dialogo Seleziona connessione debugger remoto sono visualizzati i computer sulla subnet locale e i computer collegati direttamente al computer che esegue Visual Studio tramite un cavo Ethernet. Per specificare un altro computer, immetti il nome nella casella Nome computer.
Scegliere il debugger da utilizzare
Per impostazione predefinita, il debugger viene associato al codice JavaScript nell'app. Puoi scegliere di eseguire il debug del codice gestito e C++ nativo dei componenti dell'app anziché il codice JavaScript. Specifica il codice per cui eseguire il debug nell'elenco Tipo di debugger nella pagina delle proprietà Debug del progetto dell'app.
Scegli uno di questi debugger dall'elenco Tipo di debugger:
Solo script |
Esegue il debug del codice JavaScript nell'app. Il codice gestito e il codice nativo vengono ignorati. |
Solo nativo |
Esegue il debug del codice C/C++ nativo nell'app. Il codice gestito e il codice JavaScript vengono ignorati. |
Solo gestito |
Esegue il debug del codice gestito nell'app. Il codice JavaScript e il codice C/C++ nativo vengono ignorati. |
Misto (gestito e nativo) |
Esegue il debug sia del codice C++ nativo e del codice gestito nell'app. Il codice JavaScript viene ignorato. |
(Facoltativo) Ritardare l'avvio dell'app nella sessione di debug
Per impostazione predefinita, Visual Studio avvia immediatamente l'app quando avvii il debug. Puoi anche avviare una sessione di debug ma ritardare l'avvio dell'app. L'app viene aperta nel debugger quando viene avviata dal menu Start o tramite un contratto di attivazione oppure quando viene avviata da un altro processo o metodo. Puoi utilizzare l'avvio ritardato anche per eseguire il debug degli eventi in background nell'app che vuoi effettuare quando l'applicazione non è in esecuzione.
Specifica se ritardare l'avvio dell'app nell'elenco Avvia applicazione nella pagina delle proprietà Debug del progetto dell'app. Scegli una delle seguenti opzioni:
Scegli No per ritardare l'avvio dell'app.
Scegli Sì per avviare l'app immediatamente.
(Facoltativo) Disabilitare i loopback di rete
Per motivi di sicurezza, a un'app di Windows Store installata in modalità standard non è consentito effettuare chiamate di rete al dispositivo in cui è installata. Per impostazione predefinita, la distribuzione di Visual Studio crea una esenzione da questa regola per l'app distribuita. Questa esenzione ti consente di verificare le procedure di comunicazione in un singolo computer. Prima di inviare l'app a Windows Store, dovrai testare l'app senza l'esenzione.
Per rimuovere l'esenzione relativa al loopback della rete, scegli No dall'elenco Consenti loopback della rete locale nella pagina delle proprietà Debug.
Avviare la sessione di debug
Avviare i debug (F5)
Quando scegli Avvia debug dal menu Debug (tastiera: F5), Visual Studio avvia l'app con il debugger collegato. L'esecuzione continua fino a raggiungere un punto di interruzione. Sospendi manualmente l'esecuzione e si verifica un'eccezione non gestita o l'app termina.
Avviare il debug (F5) ma ritardare l'avvio dell'app
Puoi impostare l'app per l'esecuzione in modalità debug, ma avviarla con un metodo diverso dal debugger. Ad esempio, puoi decidere di eseguire il debug dell'avvio dell'app dal menu Start o di eseguire il debug di un processo in background nell'app senza avviare l'app. Per ritardare l'avvio dell'app, procedi come indicato di seguito:
Nella pagina Debug delle proprietà del progetto di app scegli No dall'elenco Avvia applicazione.
Scegli Avvia debug dal menu Debug (tastiera: F5).
Avvia l'app dal menu Start, da un contratto di esecuzione o da un'altra routine.
L'app viene avviata in modalità debug. L'esecuzione continua fino a raggiungere un punto di interruzione. Sospendi manualmente l'esecuzione e si verifica un'eccezione non gestita o l'app termina.
. Per ulteriori informazioni sul debug di attività in background, vedi Come attivare eventi di sospensione, ripresa e background nelle app di Windows Store.
Avviare un'app installata nel debugger
Quando avvii il debug utilizzando F5, Visual Studio compila e distribuisce l'app, la imposta per l'esecuzione in modalità debug, quindi la avvia. Per avviare un'app già installata in un dispositivo, utilizza la finestra di dialogo Debug pacchetto applicazione installato. Questa è una procedura utile per il debug di un'app installata da Windows Store o quando disponi dei file di origine dell'app, ma non di un progetto di Visual Studio per l'app. Ad esempio, potresti disporre di un sistema di compilazione personalizzato che non utilizza progetti o soluzioni di Visual Studio.
L'app può essere installata nel dispositivo locale oppure in un dispositivo remoto. Puoi avviare l'app immediatamente oppure impostarla per l'esecuzione nel debugger quando viene avviata da un altro processo o metodo, ad esempio dal menu Start o da un contratto di attivazione. Puoi anche impostarne l'esecuzione in modalità debug per eseguire il debug di un processo in background senza avviare l'app. Per ulteriori informazioni, vedi Come attivare eventi di sospensione, ripresa e background nelle app di Windows Store.
Per impostare l'esecuzione di un'app installata in modalità debug, procedi come indicato di seguito:
Nota
L'app non deve essere in esecuzione all'avvio della procedura.
Scegli Debug pacchetto applicazione installato dal menu Debug.
Scegli una delle opzioni seguenti dall'elenco:
Computer locale
Esegue il debug dell'app nella sessione corrente nel computer locale. Vedi Esecuzione di app di Windows Store in un computer locale.
Simulatore
Esegue il debug dell'app nel simulatore di Visual Studio per le app in Windows Store. Il simulatore è una finestra del desktop che consente di eseguire il debug delle funzionalità del dispositivo, ad esempio i movimenti tocco e la rotazione del dispositivo, che non sono disponibile nel computer locale. Vedi Esecuzione di app di Windows Store nel simulatore.
Computer remoto
Esegue il debug dell'app in un dispositivo connesso al computer locale su una rete Intranet o collegato direttamente tramite un cavo Ethernet. Per eseguire il debug in modalità remota, Visual Studio Remote Tools deve essere installato e in esecuzione sul dispositivo remoto. Vedi Esecuzione di app di Windows Store in un computer remoto.
Scegli l'app dall'elenco Pacchetti applicazione installati.
Scegli il motore di debug da utilizzare dall'elenco Esegui il debug di questi tipi di codice.
(Facoltativo) Scegli Non eseguire il codice utente, ma eseguine il debug all'avvio per il debug dell'app all'avvio tramite un altro metodo o per il debug di un processo in background.
Quando fai clic su Start l'app viene avviata o impostata per l'esecuzione in modalità debug.
Collegare il debugger a un'app in esecuzione
Per collegare il debugger a un'app in Windows Store, devi utilizzare Debuggable Package Manager per impostare l'esecuzione dell'app in modalità debug. Debuggable Package Manager viene installato con Visual Studio Remote Tools.
Il collegamento del debugger a un'app è utile quando devi eseguire il debug di un'app già installata, ad esempio un'app installata da Windows Store. Il collegamento è necessario quando disponi dei file di origine dell'app, ma non di un progetto di Visual Studio per l'app. Ad esempio, potresti disporre di un sistema di compilazione personalizzato che non utilizza progetti o soluzioni di Visual Studio.
Per connettersi a un'app:
Imposta l'esecuzione dell'app in modalità debug. Questa operazione deve essere effettuata quando l'app non è in esecuzione.
Avvia l'app. Puoi avviare l'app dal menu Start, da un contratto di esecuzione o tramite un altro metodo.
Collega il debugger all'app in esecuzione.
Impostare l'esecuzione dell'app in modalità debug
Installa Visual Studio Remote Tools sul dispositivo in cui è installata l'app. Vedi Installing the Remote Debugger.
Nel menu Start cerca Debuggable Package Manager e avvialo.
Viene visualizzata una finestra di PowerShell correttamente configurata per il cmdlet AppxDebug.
Per abilitare il debug di un'app, devi specificare l'identificatore PackageFullName dell'app. Per visualizzare un elenco di tutte le app che includono PackageFullName, digita Get-AppxPackage al prompt di PowerShell.
Al prompt di PowerShell immetti Enable-AppxDebug NomePacchettoCompleto dove NomePacchettoCompleto è l'identificatore PackageFullName dell'app.
Collegare il debugger
Suggerimento
Le app JavaScript vengono eseguite in un'istanza del processo wwahost.exe. Se sono in esecuzione altre applicazioni JavaScript quando ti connetti all'app, devi conoscere l'ID processo numerica (PID) di wwahost.exe in cui l'app è in esecuzione.
Il modo più semplice per gestire questa situazione è di chiudere tutte le altre app JavaScript. In caso contrario, puoi aprire Gestione attività Windows prima di avviare l'applicazione e prendere nota dell'ID dei processi wwahost.exe. Quando specifichi il processo a cui connettersi nella finestra di dialogo Processi disponibili , il processo wwahost.exe dell'app avrà un ID diverso da quelli che hai annotato.
Per collegare il debugger:
Scegli Connetti a processo dal menu Debug.
Viene visualizzata la finestra di dialogo Connetti a processo.
Per connetterti a un'app in un dispositivo remoto, specifica il dispositivo remoto nella casella Qualificatore. Puoi procedere come segue:
Immetti il nome nella casella Qualificatore.
Fai clic sulla freccia in giù nella casella Qualificatore e scegli il dispositivo da un elenco di dispositivi collegati precedentemente.
Scegli Trova per scegliere il dispositivo da un elenco di dispositivi sulla subnet locale.
Specifica il tipo di codice di cui vuoi eseguire il debug nella casella Connetti a.
Scegli Seleziona, quindi effettua una delle seguenti operazioni:
Scegli Determina automaticamente il tipo di codice di cui eseguire il debug.
Scegli Esegui il debug di questi tipi di codice, quindi scegli uno o più tipi dall'elenco.
Nell'elenco Processi disponibili scegli il processo wwahost.exe appropriato. Utilizzare la colonna Titolo per identificare l'app.
Scegli Connetti.
Visual Studio collega il debugger al processo. L'esecuzione continua fino a raggiungere un punto di interruzione. Sospendi manualmente l'esecuzione e si verifica un'eccezione non gestita o l'app termina.
Vedere anche
Concetti
Guida rapida: Navigazione nel debugger (JavaScript)
Guida rapida: Debug di app (JavaScript)
Come attivare eventi di sospensione, ripresa e background nelle app di Windows Store