Selecione Depurar > Depurar
(Versões CS6 e anteriores) Selecione Depurar > Depurar filme > Depurar.
O Animate inclui um depurador em separado para o ActionScript 3.0, que opera de modo diferente do depurador do ActionScript 2.0. O depurador do ActionScript 3.0 só funciona com arquivos FLA e AS do ActionScript 3.0. Os arquivos FLA devem ter as configurações de publicação definidas para o Flash Player 9. Quando você inicia uma sessão de depuração do ActionScript 3.0, o Animate utiliza uma versão de depuração do Flash Player para reproduzir o arquivo SWF. O player Flash de depuração reproduz o SWF em uma janela separada da janela do aplicativo de autoria do Animate.
O depurador do ActionScript 3.0 converte o espaço de trabalho do Animate em um espaço de trabalho de depuração que exibe os painéis usados para depuração. Ele também inclui o painel Ações e/ou a janela Script, o console de Depuração e o painel Variáveis. O Console de depuração exibe a pilha de chamadas e contém ferramentas para avançar pelos scripts. O painel Variáveis exibe as variáveis no escopo atual com seus valores e permite que você mesmo atualize esses valores.
Recursos adicionais
Os recursos a seguir fornecem informações detalhadas adicionais sobre a depuração do ActionScript 3.0:
O modo como você iniciar uma sessão de depuração depende do tipo de arquivo em que você está trabalhando. Durante uma sessão de depuração, o Animate interrompe a execução do ActionScript quando ele encontra um ponto de interrupção ou um erro de tempo de execução.
Quando o Animate inicia uma sessão de depuração, ele adiciona informações especiais ao arquivo SWF que são exportadas para a sessão. Essas informações permitem que o depurador forneça os números de linha específicos no código, onde os erros foram encontrados.
Nas Configurações de publicação, você pode incluir essas informações especiais de depuração em todos os arquivos SWF criados a partir de um determinado arquivo FLA. Isso permite que você depure o arquivo SWF mesmo que não inicie explicitamente uma sessão de depuração. As informações de depuração tornam o arquivo SWF um pouco maior.
Escolha um ambiente de depuração padrão
Escolha Depurar > Depurar filme e, em seguida, escolha uma das opções a seguir:
Animate
AIR Debug Launcher (Desktop)
AIR Debug Launcher (Móvel)
no Dispositivo via USB (somente para o CS5.5)
Todas as sessões de depuração ocorrerão no ambiente que você escolher. Você pode alterar o ambiente padrão a qualquer momento.
Iniciar a depuração a partir de um arquivo FLA
Selecione Depurar > Depurar
(Versões CS6 e anteriores) Selecione Depurar > Depurar filme > Depurar.
Iniciar a depuração a partir de um arquivo AS do ActionScript 3.0
Com o arquivo FLA aberto no Flash e o arquivo do ActionScript aberto na janela Script, escolha o menu Destino na parte superior desta janela, e selecione o arquivo FLA com o qual o arquivo do ActionScript deverá ser compilado. O arquivo FLA também deve estar aberto para aparecer nesse menu.
Selecione Depurar > Depurar
( Versão CS6 e anteriores) Selecione Depurar > Depurar filme > Depurar.
Adicionar informações sobre depuração a todos os arquivos SWF criados a partir de um arquivo FLA
Com o arquivo FLA aberto, selecione Arquivo > Configurações de publicação.
Na caixa de diálogo Configurações de Publicação, clique na aba (CS5) ou na categoria (CS5.5).
Selecione Permitir depuração.
Sair do modo de depuração
Clique no botão Encerrar sessão de depuração no Console de depuração.
Adicione pontos de interrupção ao código ActionScript para interromper a execução do código. Após a execução ser interrompida, você pode avançar pelo código e executá-lo linha por linha, exibir seções diferentes de seu ActionScript, exibir os valores de variáveis e expressões, e editar valores de variáveis.
Os pontos de interrupção não podem ser adicionados a arquivos ASC (ActionScript for Communication) ou JSFL (Flash JavaScript).
Definir um ponto de interrupção
No painel Ações ou na janela Script, clique na margem esquerda próximo à linha do código onde você quer que apareça um ponto de interrupção.
Remover um ponto de interrupção
No painel Ações ou na janela Script, clique no ponto de interrupção a ser removido.
Após a execução do ActionScript ser interrompida em um ponto de interrupção ou erro de runtime, você pode percorrer o código linha por linha. Você pode optar por entrar em chamadas de função ou passar por elas. Você também pode optar por continuar executando o código sem avançar.
Entrar no código linha por linha
Clique no botão Entrar no Console de depuração.
Avançar uma chamada de função
Clique no botão Avançar no Console de depuração.
Sair de uma chamada de função
Clique no botão Sair no Console de depuração.
Retomar execução normal do código
Clique no botão Continuar no Console de depuração.
Quando a execução do código para no depurador, você pode exibir a pilha de chamadas no Console do depurador e exibir os scripts que contêm as funções na pilha de chamadas. A pilha de chamadas mostra a lista atual das chamadas de funções aninhadas que estão aguardando a conclusão da execução.
Você pode exibir os scripts individuais que contêm cada função.
Exiba e edite os valores de variáveis e propriedades no painel Variáveis.
Exibir o valor de uma variável
No painel Variáveis, selecione os tipos de variáveis a ser exibidos no menu do painel.
A opção Mostrar constantes exibe os valores constantes (variáveis que têm um valor fixo).
A opção Mostrar estáticos exibe as variáveis que pertencem à classe, em vez daquelas que pertencem a ocorrências da classe.
A opção Mostrar variáveis de membros inacessíveis exibe as variáveis que não estão acessíveis a outras classes ou namespaces. Isso inclui as variáveis que são protegidas, privadas ou internas ao namespace.
A opção Mostrar exibição adicional de hexadecimais adiciona valores hexadecimais onde quer que valores decimais sejam exibidos. Isso é principalmente útil com valores de cores. Os valores hexadecimais não são exibidos para valores decimais de 0 a 9.
A opção Mostrar nomes qualificados exibe os tipos de variáveis com o nome do pacote e o nome da classe.
Expanda a exibição em árvore da estrutura de objetos do FLA até que você veja a variável a ser exibida.
Editar o valor de um variável
No painel Variáveis, clique duas vezes no valor da variável.
Informe o novo valor para a variável e pressione Enter. O novo valor é usado durante a execução do código subsequente.
Você pode controlar os tipos de avisos que o compilador do ActionScript gera no painel Erros do compilador. Quando o compilador reporta um erro, você pode clicar duas vezes no erro para navegar para a linha do código que causou o erro.
Clique no Animate.
Quando o Animate encontra um erro no código ActionScript, durante a compilação ou a execução, ele reporta o erro no painel Erros do compilador. Navegue até a linha do código que causou o erro no painel Erros do compilador.
Com o ActionScript 3.0, você pode depurar um arquivo SWF remoto usando uma versão independente, ActiveX, ou a versão de plug-in do depurador do Flash Player, que você pode encontrar no diretório de instalação do Animate/Players/Debug/. No entanto, no Depurador do ActionScript 3.0, a depuração remota está limitada aos arquivos localizados no mesmo host local do aplicativo de autoria do Animate, e reproduzidos no player do depurador independente, no controle ActiveX ou no plug-in.
Para permitir a depuração remota do arquivo, ative a depuração nas Configurações de publicação. Você também pode publicar seu arquivo com uma senha de depuração para garantir que somente usuários de confiança possam depurá-lo.
Como nas linguagens JavaScript ou HTML, os usuários podem exibir as variáveis do lado do cliente no ActionScript. Para armazenar variáveis com segurança, envie-as para um aplicativo do lado do servidor, em vez de armazená-las no seu arquivo. No entanto, como um desenvolvedor, você pode ter outros segredos comerciais, como estruturas de clipes de filme, que você não deseja revelar. Então, você poderá usar uma senha de depuração para proteger o seu trabalho.
Ativar a depuração remota de um arquivo SWF e configurar uma senha de depuração
Nos arquivos FLA do ActionScript 3.0, o código nos scripts de quadros não pode ser depurado. Somente código em arquivos AS externos pode ser depurado com o Depurador do ActionScript 3.0.
Abra o arquivo FLA.
Selecione Arquivo > Configurações de publicação.
Na caixa de diálogo Configurações de Publicação, clique na aba (CS5) ou na categoria (CS5.5) e, em seguida, selecione Permitir Depuração.
Feche a caixa de diálogo Configurações de publicação e selecione um dos comandos a seguir:
Arquivo > Exportar > Exportar filme
Arquivo > Publicar
Deixe o arquivo SWF na máquina local para executar uma sessão de depuração remota no host local, ou carregue-o em seu servidor de rede.
O arquivo SWF não contém informações sobre pontos de interrupção; assim, se você carregar o arquivo de um servidor remoto, não poderá avançar pelo código. Use o host local para executar essa tarefa.
No Animate, selecione Depurar > Iniciar sessão de depuração remota > ActionScript 3.0.
O Animate abre o Depurador do ActionScript 3.0 e aguarda a conexão de um Flash Player de depuração. Você tem 2 minutos para iniciar o Flash Player de depuração. Se decorrem mais de 2 minutos, repita essa etapa.
Abra o arquivo SWF na versão de depuração do plug-in Flash Player, do controle ActiveX ou do player independente. O player independente de depuração está localizado no diretório de instalação do Animate/Players/Debug/. Não se conecte a um arquivo em outra máquina, uma vez que o depurador não poderá receber qualquer informação sobre pontos de interrupção.
A sessão de depuração inicia quando o player de depuração se conecta ao painel Depurador do ActionScript 3.0.
O depurador remoto não funciona se você selecionar a interface de rede Padrão do AIR 3.4. Em vez disso, selecione as opções para fornecer o nome da interface de rede e o endereço IP do sistema.
Ativar o Depurador de um local remoto
Abra o aplicativo de autoria do Animate caso já não esteja aberto.
Selecione Depurar > Iniciar sessão de depuração remota > ActionScript 3.0.
No local remoto, em um navegador ou na versão de depuração do player independente, abra o arquivo SWF publicado.
Se a caixa de diálogo Depuração remota não for exibida, clique com o botão direito do mouse (Windows) ou clique com a tecla Control pressionada (Macintosh) no arquivo SWF para exibir o menu de contexto e, em seguida, selecione Depurador.
Na caixa de diálogo Depuração remota, selecione Host local e, depois, selecione o arquivo a ser aberto.
A lista de exibição do arquivo SWF aparece no Depurador. Se o arquivo SWF não for reproduzido, o Depurador poderá estar pausado; sendo assim, clique em Continuar para iniciá-lo.