Selezionate Debug > Debug
(Versioni CS6 e versioni precedenti) Selezionate Debug > Debug filmato > Debug.
Animate include un debugger separato per ActionScript 3.0, che presenta alcune differenze di funzionamento rispetto al debugger di ActionScript 2.0. Il debugger di ActionScript 3.0 funziona solo con file FLA di ActionScript 3.0 e con file AS. Le impostazioni di pubblicazione dei file FLA devono essere configurate su Flash Player 9. Quando avviate una sessione di debug di ActionScript 3.0, Animate avvia la versione autonoma di Flash Player per riprodurre il file SWF. Il lettore di debug riproduce il file SWF in una finestra separata da quella dell’applicazione di creazione di Animate.
Il debugger di ActionScript 3.0 converte l’area di lavoro di Animate in un’area di lavoro di debug in cui vengono visualizzati i pannelli utilizzati per il debug. Quest’area include anche il pannello Azioni e/o la finestra Script, la console Debug e il pannello Variabili. La Console di debug visualizza lo stack di chiamata e contiene gli strumenti necessari per scorrere gli script. Il pannello Variabili visualizza le variabili nell'area di validità corrente con i relativi valori e consente all'utente di aggiornarli.
Altro materiale di riferimento
Le seguenti risorse (in inglese) forniscono ulteriori informazioni dettagliate sulle operazioni di debug con ActionScript 3.0:
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
Selezionate Debug > Debug
(Versioni CS6 e versioni precedenti) Selezionate Debug > Debug filmato > Debug.
Avviare il debug da un file AS ActionScript 3.0
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
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
Dopo aver aperto il file FLA, selezionate File > Impostazioni pubblicazione.
Nella finestra di dialogo Impostazioni pubblicazione, fate clic sulla scheda (CS5) o sulla categoria (CS5.5).
Selezionate Consenti debug.
Uscire dalla modalità di debug
Fate clic sul pulsante Termina sessione di debug nella Console di debug.
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.
Non è possibile aggiungere punti di interruzione a file ASC (ActionScript for Communication) o JSFL (Flash JavaScript).
Impostare un punto di interruzione
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
Nel pannello Azioni o nella finestra Script, fate clic sul punto di interruzione da rimuovere.
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
Fate clic sul pulsante Verifica esecuzione della Console di debug.
Verificare internamente una chiamata di funzione
Fate clic sul pulsante Verifica internamente della Console di debug.
Verificare l'uscita di una chiamata di funzione
Fate clic sul pulsante Verifica uscita della Console di debug.
Riprendere la normale esecuzione del codice
Fate clic sul pulsante Continua della Console di debug.
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.
Visualizzare e modificare i valori delle variabili e delle proprietà nel pannello Variabili.
Visualizzare il valore di una variabile
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.
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
Nel pannello Variabili, fate doppio clic sul valore della variabile.
Immettete il nuovo valore per la variabile e premete Invio. Il nuovo valore viene utilizzato durante la successiva esecuzione del codice.
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.
Fate clic su Animate.
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.
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.
Aprite il file FLA.
Selezionate File > Impostazioni pubblicazione.
Nella finestra di dialogo Impostazioni pubblicazione, fate clic sulla scheda (CS5) o sulla categoria (CS5.5), quindi selezionate Consenti debug.
Chiudete la finestra di dialogo Impostazioni pubblicazione e selezionate uno dei comandi seguenti:
File > Esporta > Esporta filmato
File > Pubblica
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.
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.
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
Il debug remoto non funziona se selezionate l’interfaccia di rete predefinita per AIR 3.4. Selezionate invece le opzioni che consentono di specificare il nome dell’interfaccia di rete e l’indirizzo IP del sistema.
Attivare il debugger da una postazione remota
Aprite l'applicazione di creazione Animate, se non è già aperta.
Selezionate Debug > Inizia sessione di debug remota > ActionScript 3.0.
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.
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.