Debug di un'applicazione AIR desktop

Se sviluppate l'applicazione in un ambiente IDE come Flash Builder, Flash Professional o Dreamweaver, i tool di debug sono generalmente incorporati nell'ambiente stesso e potete eseguire il debug dell'applicazione semplicemente avviandola in modalità debug. Se invece non disponete di un IDE che supporta direttamente il debug, potete utilizzare i tool ADL (AIR Debug Launcher) e FDB (Flash Debugger) per facilitare l'attività di debug dell'applicazione.

Esecuzione di un'applicazione mediante ADL

Mediante ADL potrete eseguire un'applicazione AIR senza prima effettuare la creazione del pacchetto e installarla. Passate il file descrittore dell'applicazione ad ADL sotto forma di parametro, come indicato nell'esempio seguente (prima è necessario compilare il codice ActionScript dell'applicazione):

adl myApplication-app.xml

ADL stampa le istruzioni trace, le eccezioni runtime e gli errori di analisi sintattica HTML direttamente nella finestra di terminale. Se un processo FDB è in attesa di una connessione in entrata, ADL si connette al debugger.

Potete anche utilizzare ADL per eseguire il debug di un'applicazione AIR che usa estensioni native. Ad esempio:

adl -extdir extensionDirs myApplication-app.xml

Stampa di istruzioni trace

Per stampare istruzioni trace nella console utilizzata per l'esecuzione di ADL, aggiungete le istruzioni trace al codice mediante la funzione trace() .

Nota: Se le istruzioni trace() non vengono visualizzate sulla console, verificate di non aver specificato ErrorReportingEnable o TraceOutputFileEnable nel file mm.cfg. Per maggiori informazioni sulle posizione di questo file a seconda della piattaforma, vedete Editing the mm.cfg file .

Esempio ActionScript:

//ActionScript 
trace("debug message"); 

Esempio JavaScript:

//JavaScript 
air.trace("debug message");
In JavaScript, per visualizzare i messaggi di debug provenienti dall'applicazione, potete utilizzare le funzioni alert() e confirm() . Nella console vengono anche stampati i numeri di riga per gli errori di sintassi e le eccezioni JavaScript non rilevate.
Nota: per utilizzare il prefisso air mostrato nell'esempio JavaScript, dovete importare il file AIRAliases.js nella pagina. Il file si trova nella directory frameworks di AIR SDK.

Connessione a FDB (Flash Debugger)

Per eseguire il debug di un'applicazione AIR mediante il debugger Flash, avviate una sessione FDB, quindi avviate l'applicazione usando ADL.

Nota: nelle applicazioni AIR basate su SWF, i file di origine ActionScript devono essere compilati con il flag -debug . In Flash Professional selezionate l'opzione Consenti debug nella finestra di dialogo Impostazioni pubblicazione.
  1. Avviate FDB. Il programma FDB si trova nella directory bin di Flex SDK.

    Nella console viene visualizzato il prompt FDB: <fdb>

  2. Eseguite il comando run : <fdb>run [Invio]

  3. In un diverso comando o console della shell, avviate una versione di debug dell'applicazione:

    adl myApp.xml
  4. Utilizzando i comandi FDB, impostate i punti di interruzione come desiderato.

  5. Digitate: continue [Invio]

Se un'applicazione AIR è basata su SWF, il debugger controlla solamente l'esecuzione del codice ActionScript. Se l'applicazione AIR è basata su HTML, il debugger controlla solamente l'esecuzione del codice JavaScript.

Per eseguire ADL senza connettersi al debugger, includete l'opzione -nodebug :

adl myApp.xml -nodebug

Per informazioni di base sui comandi FDB, eseguite il comando help :

<fdb>help [Enter]

Per informazioni dettagliate sui comandi FDB, vedete Using the command-line debugger commands (Uso dei comandi del debugger della riga di comando) nella documentazione di Flex.