Sobre o depurador do ActionScript 3.0

Recursos adicionais

Os recursos a seguir fornecem informações detalhadas adicionais sobre a depuração do ActionScript 3.0:

Informar modo de depuração

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

  1. 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.

  2. 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

  1. Com o arquivo FLA aberto, selecione Arquivo > Configurações de publicação.

  2. Na caixa de diálogo Configurações de Publicação, clique na aba (CS5) ou na categoria (CS5.5).

  3. 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.

Definir e remover pontos de interrupçã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.

Observação:

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.

Avançar pelas linhas do código

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.

Exibir e examinar scripts na pilha de chamadas

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.

  • No painel Console de depurador, clique duas vezes no nome do script na pilha de chamadas.

Exibir e modificar valores de variáveis

Exiba e edite os valores de variáveis e propriedades no painel Variáveis.

Exibir o valor de uma variável

  1. 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.

  2. 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

  1. No painel Variáveis, clique duas vezes no valor da variável.

  2. Informe o novo valor para a variável e pressione Enter. O novo valor é usado durante a execução do código subsequente.

Controlar avisos do compilador

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.

  1. Selecione Arquivo > Configurações de publicação.
  2. Clique no Animate.

  3. Clique no botão Configurações do ActionScript.
  4. Selecione entre as seguintes opções de Erros:
    • O Modo estrito reporta avisos como erros, o que significa que a compilação não terá êxito se esses erros existirem.
    • O Modo de avisos reporta avisos adicionais úteis para descobrir incompatibilidades durante a atualização do código do ActionScript 2.0 para ActionScript 3.0.

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.

  • Clique duas vezes no erro no painel Erros do compilador.

Depurar um arquivo SWF remoto do ActionScript 3.0

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.

  1. Abra o arquivo FLA.

  2. Selecione Arquivo > Configurações de publicação.

  3. 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.

  4. Feche a caixa de diálogo Configurações de publicação e selecione um dos comandos a seguir:

    • Arquivo > Exportar > Exportar filme

    • Arquivo > Publicar

  5. 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.

  6. 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.

  7. 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.

    Observação:

    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

  1. Abra o aplicativo de autoria do Animate caso já não esteja aberto.

  2. Selecione Depurar > Iniciar sessão de depuração remota > ActionScript 3.0.

  3. 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.

  4. 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.

Esta obra está licenciada sob uma licença não adaptada da Creative Commons Attribution-Noncommercial-Share Alike 3.0  As publicações do Twitter™ e do Facebook não são cobertas pelos termos do Creative Commons.

Avisos legais   |   Política de privacidade online