Informazioni sul debugger di ActionScript 3.0

Altro materiale di riferimento

Le seguenti risorse (in inglese) forniscono ulteriori informazioni dettagliate sulle operazioni di debug con ActionScript 3.0:

Attivare la modalità di debug

L'avvio di una sessione di debug dipende dal tipo di file utilizzato. Durante una sessione di debug, Animate interrompe l'esecuzione di ActionScript quando rileva un punto di interruzione o un errore di runtime.

Quando Animate inizia una sessione di debug, aggiunge al file SWF esportato per la sessione alcune informazioni speciali. Queste informazioni consentono al debugger di fornire i numeri di riga specifici nel codice, nel punto in cui sono stati rilevati errori.

Potete includere questa informazione speciale di debug in tutti i file SWF creati da uno specifico file FLA nelle impostazioni di pubblicazione. Questo consente il debug del file SWF anche quando non viene avviata una sessione di debug in modo esplicito. Queste informazioni di debug comportano un leggero aumento delle dimensioni del file SWF.

Scegliere un ambiente di debug predefinito

  • Scegliete Debug > Debug filmato, quindi effettuate una delle seguenti selezioni:

    • Animate

    • AIR Debug Launcher (Desktop)

    • AIR Debug Launcher (Mobile)

    • su dispositivo via USB (solo in CS5.5)

    Tutte le sessioni di debug avranno luogo nell'ambiente selezionato. Potete cambiare l'ambiente predefinito in qualsiasi momento.

Avviare il debug da un file FLA

  1. Selezionate Debug > Debug

    (Versioni CS6 e versioni precedenti) Selezionate Debug > Debug filmato > Debug.

Avviare il debug da un file AS ActionScript 3.0

  1. Con il file ActionScript aperto nella finestra Script, selezionate il file FLA con cui il file ActionScript deve essere compilato dal menu Target nella parte superiore della finestra Script. Per essere visualizzato in questo menu, anche il file FLA deve essere aperto

  2. Selezionate Debug > Debug

    (Versione CS6 e versioni precedenti) Selezionate Debug > Debug filmato > Debug.

Aggiungere le informazioni di debug a tutti i file SWF creati da un file FLA

  1. Dopo aver aperto il file FLA, selezionate File > Impostazioni pubblicazione.

  2. Nella finestra di dialogo Impostazioni pubblicazione, fate clic sulla scheda (CS5) o sulla categoria (CS5.5).

  3. Selezionate Consenti debug.

Uscire dalla modalità di debug

  1. Fate clic sul pulsante Termina sessione di debug nella Console di debug.

Impostare e rimuovere i punti di interruzione

Aggiungete i punti di interruzione al codice ActionScript per interrompere l'esecuzione del codice. Dopo l'interruzione dell'esecuzione, potete scorrere ed eseguire il codice riga per riga, visualizzare le diverse sezioni del codice ActionScript, visualizzare i valori di variabili ed espressioni e modificare i valori delle variabili.

Nota:

non è possibile aggiungere punti di interruzione a file ASC (ActionScript for Communication) o JSFL (Flash JavaScript).

Impostare un punto di interruzione

  1. Nel pannello Azioni o nella finestra Script, fate clic sul margine sinistro accanto alla riga del codice in cui desiderate venga visualizzato il punto di interruzione.

Rimuovere un punto di interruzione

  1. Nel pannello Azioni o nella finestra Script, fate clic sul punto di interruzione da rimuovere.

Scorrere le righe di codice

Quando l'esecuzione del codice ActionScript viene interrotta in corrispondenza di un punto di interruzione o a seguito di un errore runtime, potete scorrere il codice riga per riga. Potete scegliere di verificare l'esecuzione delle chiamate di funzione oppure di verificarle internamente. È inoltre possibile scegliere di continuare a eseguire il codice senza scorrerlo.

Scorrere il codice riga per riga

  1. Fate clic sul pulsante Verifica esecuzione della Console di debug.

Verificare internamente una chiamata di funzione

  1. Fate clic sul pulsante Verifica internamente della Console di debug.

Verificare l'uscita di una chiamata di funzione

  1. Fate clic sul pulsante Verifica uscita della Console di debug.

Riprendere la normale esecuzione del codice

  1. Fate clic sul pulsante Continua della Console di debug.

Visualizzare e analizzare gli script nello stack di chiamata

Quando viene arrestata l'esecuzione del codice nel debugger, potete visualizzare lo stack di chiamata nella Console di debug e vedere gli script contenenti le funzioni nello stack di chiamata. Nello stack di chiamata viene visualizzato l'elenco corrente delle chiamate di funzione nidificate in attesa di esecuzione.

Potete anche visualizzare i singoli script contenenti ogni funzione.

  1. Nel pannello Console di debug, fate doppio clic sul nome dello script nello stack di chiamata.

Visualizzare e modificare i valori delle variabili

Visualizzare e modificare i valori delle variabili e delle proprietà nel pannello Variabili.

Visualizzare il valore di una variabile

  1. Nel pannello Variabili selezionate il tipo di variabili da visualizzare nel menu Pannello.

    • Mostra costanti consente di visualizzare le costanti dei valori (variabili che hanno un valore fisso).

    • Mostra proprietà statiche consente di visualizzare le variabili appartenenti alla classe anziché a istanze della classe.

    • Mostra variabili membro inaccessibili visualizza le variabili non accessibili ad altre classi o spazi dei nomi. Ciò include variabili protette, private o interne allo spazio del nome.

    • Mostra vista esadecimale aggiuntiva aggiunge valori esadecimali ovunque vengano visualizzati valori decimali. Ciò è principalmente utile per i valori di colore. I valori esadecimali non vengono visualizzati per i valori decimali da 0 a 9.

    • Mostra nomi completi visualizza tipi di variabili sia con il nome di pacchetto che di classe.

  2. Espandete la struttura ad albero della struttura oggetto del file FLA fino a che non compare la variabile da visualizzare.

Modificare il valore di una variabile

  1. Nel pannello Variabili, fate doppio clic sul valore della variabile.

  2. Immettete il nuovo valore per la variabile e premete Invio. Il nuovo valore viene utilizzato durante la successiva esecuzione del codice.

Controllare le avvertenze del compilatore

Controllate il tipo di avvertenze generate nel pannello Errori del compilatore. Quando il compilatore segnala un errore, fate doppio clic su di esso per spostarvi sulla riga di codice che lo ha provocato.

  1. Selezionate File > Impostazioni pubblicazione.
  2. Fate clic su Animate.

  3. Fate clic sul pulsante Impostazioni di ActionScript.
  4. Selezionate le opzioni desiderate per Errori:
    • Con Modalità rigorosa le avvertenze vengono riportate come errori, il che significa che la compilazione non riesce in presenza di questi errori.
    • Con Modalità avvertenze vengono riportate ulteriori avvertenze, utili per rilevare le incompatibilità nell'aggiornamento di codice ActionScript 2.0 ad ActionScript 3.0.

Quando Animate rileva un errore nel codice ActionScript, durante la compilazione o l'esecuzione, riporta l'errore nel pannello Errori del compilatore. Potete spostarvi sulla riga di codice che ha provocato l'errore dal pannello Errori del compilatore.

  1. Fate doppio clic sull'errore nel pannello Errori del compilatore.

Debug di un file SWF remoto di ActionScript 3.0

Con ActionScript 3.0 potete eseguire il debug di un file SWF remoto utilizzando la versione autonoma, ActiveX o Plug-In di Flash Player, presente in Directory di installazione di Animate/Players/Debug/ directory. Tuttavia nel debugger di ActionScript 3.0 il debug remoto è limitato a file situati nello stesso host locale dell'applicazione di creazione Animate, riprodotti nel lettore autonomo di debug, nel controllo ActiveX o nel plug-in.

Per permettere il debug remoto del file, attivate il debug nelle impostazioni relative alla pubblicazione. Potete anche pubblicare il file con una password di debug per consentire soltanto ad alcuni utenti di eseguirne il debug.

Come JavaScript o HTML, anche ActionScript consente di visualizzare le variabili client-side. Per memorizzare variabili in modo sicuro, inviatele a un'applicazione su un server, anziché memorizzarle nel file. Tuttavia, come sviluppatore, potreste non desiderare rivelare determinate informazioni riservate, quali la struttura del clip filmato. Una password di debug vi permette di proteggere il vostro lavoro.

Attivare il debug remoto di un file SWF e impostare una password di debug

Nel file FLA di ActionScript 3.0, non è possibile eseguire il debug di codici negli script dei fotogrammi. Con il debugger di ActionScript 3.0 è possibile eseguire solo il debug di codici contenuti in file AS esterni.

  1. Aprite il file FLA.

  2. Selezionate File > Impostazioni pubblicazione.

  3. Nella finestra di dialogo Impostazioni pubblicazione, fate clic sulla scheda (CS5) o sulla categoria (CS5.5), quindi selezionate Consenti debug.

  4. Chiudete la finestra di dialogo Impostazioni pubblicazione e selezionate uno dei comandi seguenti:

    • File > Esporta > Esporta filmato

    • File > Pubblica

  5. Lasciate il file SWF nel computer locale in modo da eseguire una sessione di debug remota sull'host locale oppure caricatelo sul server Web.

    Il file SWF non contiene informazioni relative ai punti di interruzione, quindi se si carica il file su un server remoto non si potrà scorrere il codice. Per eseguire questa operazione, utilizzate l'host locale.

  6. In Animate, selezionate Debug > Inizia sessione di debug remota > ActionScript 3.0.

    Animate apre il debugger di ActionScript 3.0 e attende la connessione di un Flash Player di debug. Avete a disposizione 2 minuti per avviare il Flash Player di debug. Trascorsi i 2 minuti, ripetete il passaggio.

  7. Aprite il file SWF nella versione di debug del plugin di Flash Player, del controllo ActiveX o del lettore autonomo. Il lettore autonomo di debug si trova nella directory Directory di installazione di Animate/Players/Debug/. Non collegatevi a un file su un altro computer: il debugger non sarà in grado di ricevere informazioni relative ai punti di interruzione.

    La sessione di debug ha inizio quando il lettore di debug si collega al pannello del debugger di ActionScript 3,0 di

    Nota:

    il debug remoto non funziona se selezionate l'interfaccia di rete predefinita per AIR 3.4. Selezionate invece le opzioni che vi consentono di specificare il nome dell'interfaccia di rete e l'indirizzo IP del sistema.

Attivare il debugger da una postazione remota

  1. Aprite l'applicazione di creazione Animate, se non è già aperta.

  2. Selezionate Debug > Inizia sessione di debug remota > ActionScript 3.0.

  3. In un browser o nella versione debugger del lettore autonomo, aprite il file SWF pubblicato dalla postazione remota.

    Se la finestra di dialogo Debug remoto non viene visualizzata, fate clic con il pulsante destro del mouse (Windows) o fate clic tenendo premuto il tasto Ctrl (Macintosh) nel file SWF per visualizzare il menu di scelta rapida, quindi selezionate Debugger.

  4. Nella finestra di dialogo Debug remoto, selezionate il computer host locale e il file da aprire.

    Nel Debugger appare l'elenco di visualizzazione del file SWF. Se il file SWF non viene riprodotto, è possibile che l'esecuzione del Debugger sia stata sospesa. Fate clic su Continua per riavviarla.

Questo prodotto è concesso in licenza in base alla licenza di Attribuzione-Non commerciale-Condividi allo stesso modo 3.0 Unported di Creative Commons.  I post su Twitter™ e Facebook non sono coperti dai termini di Creative Commons.

Note legali   |   Informativa sulla privacy online