Utilizzo delle versioni debugger dei runtime Flash

Flash Player 9 e versioni successive, Adobe AIR 1.0 e versioni successive

Adobe mette a disposizione degli sviluppatori edizioni speciali dei runtime Flash per il supporto delle attività di debug. Nel corso dell'installazione di Adobe Flash Professional o Adobe Flash Builder, otterrete una copia della versione debugger di Flash Player. Nel corso dell'istallazione di uno di questi strumenti o come componente di Adobe AIR SDK, riceverete anche una utility per il debug di applicazioni Adobe AIR chiamata ADL.

Esiste una sostanziale differenza tra le modalità di segnalazione degli errori tra le versioni debugger e le versioni standard di Flash Player e Adobe AIR. Le versioni debugger comunicano il tipo di errore (come GenericError, IOError o EOFError), il numero dell'errore e un messaggio di errore in formato leggibile dall'utente. Le versioni standard comunicano solo il tipo di errore e il numero. Consideriamo l'esempio del codice seguente:

try 
{ 
    tf.text = myByteArray.readBoolean(); 
} 
catch (error:EOFError) 
{ 
    tf.text = error.toString(); 
}

Se il metodo readBoolean() genera un errore EOFError nella versione debugger di Flash Player, nel campo di testo tf viene visualizzato il messaggio seguente “EOFError: Errore #2030: È stata rilevata la fine del file”.

Lo stesso codice in una versione standard di Flash Player o Adobe AIR visualizza il testo seguente: “EOFError: Errore #2030”.
Nota: poiché le versioni di debug dei lettori trasmettono un evento denominato "allComplete", evitate di creare eventi personalizzati denominati “allComplete”. In caso contrario, durante il debug si potrebbe verificare un comportamento imprevedibile.

Per limitare il più possibile la dimensione e le risorse utilizzate dalle versioni standard, le stringhe dei messaggi di errore non sono state incluse. È possibile, però, leggere una descrizione dell'errore cercandone il numero nella documentazione (le appendici della Guida di riferimento di Adobe ActionScript 3.0 per la piattaforma Adobe Flash. In alternativa, potete riprodurre l'errore utilizzando le versioni debugger di Flash Player e AIR allo scopo di leggere il messaggio completo.