Use este artigo para trabalhar com as configurações de publicação do ActionScript no Adobe Animate CC.

Modificar as configurações de publicação do ActionScript

Quando você cria um novo documento FLA, o Animate CC (antigo Flash Professional CC) pergunta qual versão do ActionScript você deseja usar. Você pode alterar essa configuração se, posteriormente, optar por gravar seus scripts em uma versão diferente do ActionScript.

Observação:

O ActionScript 3.0 não é compatível com o ActionScript 2.0. O compilador do ActionScript 2.0 é capaz de compilar todo o código do Action Script 1.0, com exceção da sintaxe de barra (/) usada para indicar caminhos de clipes de filme (por exemplo, parentClip/testMC:varName= "hello world"). Para evitar esse problema, grave novamente seu código usando a notação de ponto (.) ou selecione o compilador do ActionScript 1.0.

  1. Selecione Arquivo > Configurações de publicação.
  2. Selecione a versão do ActionScript no menu Script.

Arquivos de classes e arquivos de configurações

Quando você instala o Animate, várias pastas e arquivos de configuração relacionados ao ActionScript são colocados em seu sistema. Se você modificar esses arquivos para personalizar o ambiente de autoria, faça backup dos arquivos originais.

Pasta de classes do ActionScript

Contém todas as classes incorporadas do ActionScript 2.0 (arquivos AS). Os caminhos típicos para essa pasta são os seguintes:

  • Windows 7 e 8: Hard Disk\Program Files\Adobe\Adobe Animate CC\Common\Configuration\ActionScript 3.0\Configuration\Classes

  • Macintosh: Hard Disk/Users/user/Library/Application Support/Adobe/Animate CC/language/Configuration/Classes

    A pasta Classes é organizada por classes para Flash Player 10 e classes para Flash Player 11. Para obter mais informações sobre a organização desse diretório, consulte o arquivo Read Me (Leia-me) na pasta Classes.

Pasta de classe Include

Contém todos os arquivos globais de inclusão do ActionScript. Os locais são os seguintes:

  • Windows 7 e 8: Hard Disk\Program Files\Adobe\Adobe Animate CC\Common\Configuration\ActionScript 3.0\libs\

  • Macintosh: Hard Disk/Users/user/Library/Application Support/Adobe/Animate CC/language/Configuration/Include

Arquivo de configuração ActionsPanel.xml

Inclui o arquivo de configuração para a referência do código ActionScript. Os arquivos separados contêm a configuração para cada versão do ActionScript e Flash Lite, e para o JavaScript. Os locais são os seguintes:

  • Windows 7 e 8: Hard Disk\Program Files\Adobe\Adobe Animate CC\Common\Configuration\ActionScript 3.0\libs\

  • Macintosh: Hard Disk/Users/user/Library/Application Support/Adobe/Animate CC/language/Configuration/ActionsPanel

Arquivo de configuração AsColorSyntax.xml

O arquivo de configuração para o destaque da sintaxe de cores do código ActionScript. Os locais são os seguintes:

  • Windows 7 e 8: Hard Disk\Program Files\Adobe\Adobe Animate CC\Common\Configuration\ActionScript 3.0\libs\

  • Macintosh: Hard Disk/Users/user/Library/Application Support/Adobe/Animate CC/language/Configuration/ActionsPanel

Declarar classe do documento do ActionScript 3.0

Quando você usa o ActionScript 3.0, um arquivo SWF pode ter uma classe de nível superior associada a ele. Essa classe é chamada de classe do documento. Quando o SWF é carregado pelo Flash Player, uma ocorrência dessa classe é criada para ser o objeto de nível superior do arquivo SWF. Esse objeto de um arquivo SWF pode ser uma ocorrência de uma classe personalizada de sua escolha.

Por exemplo, um arquivo SWF que implementa um componente de calendário pode associar seu nível superior a uma classe Calendar, com métodos e propriedades apropriadas a um componente de calendário. Quando o SWF é carregado, o Flash Player cria uma ocorrência dessa classe Calendar.

  1. Desmarque todos os objetos no Palco e na Linha do tempo clicando em uma área vazia do Palco. Isso faz com que as Propriedades do documento sejam exibidas no Inspetor de propriedades.
  2. Informe o nome do arquivo ActionScript para a classe na caixa de diálogo Classe do documento, no Inspetor de propriedades. Não inclua a extensão de nome de arquivo .as.

Observação:

Você também pode especificar as informações sobre Classe do documento na caixa de diálogo Configurações de publicação.

Observação:

Como opção, você pode digitar o nome da classe em um arquivo SWC, vinculado ao Caminho da biblioteca que deseja definir como a classe do documento

Definir o local dos arquivos ActionScript

Para usar a classe ActionScript que você definiu, o Animate deverá localizar os arquivos ActionScript externos que contêm a definição da classe. A lista de pastas em que o Animate procura definições de classe é denominada caminho de classe para o ActionScript 2.0 e caminho de origem para o ActionScript 3.0. Existem caminhos de classe e origem no nível do aplicativo (global) e de documento. Para obter mais informações sobre caminhos de classe, consulte Classes em Uso do ActionScript 2.0 no Adobe Animate ou "Pacotes" em Uso do ActionScript 3.0.

É possível definir os seguintes locais do ActionScript no Animate:

  • ActionScript 2.0

    • Nível do aplicativo (disponível para todos os arquivos AS2 FLA):

      • Caminho da classe (definido nas preferências do ActionScript)

    • Nível do documento (disponível somente para o arquivo FLA que especifica esse caminho):

      • Caminho da classe (definido em Configurações de publicação)

  • ActionScript 3.0

    • Nível do aplicativo (disponível para todos os arquivos AS3 FLA):

      • Caminho de origem (definido nas preferências do ActionScript)

      • Caminho da biblioteca (definido nas preferências do ActionScript)

      • Caminho da biblioteca externa (definido nas preferências do ActionScript)

    • Nível do documento (disponível somente para o arquivo FLA que especifica esses caminhos):

      • Caminho de origem (definido em Configurações de publicação)

      • Caminho da biblioteca (definido em Configurações de publicação)

      • Classe do documento (definida no Inspetor de propriedades do documento)

O Caminho da biblioteca especifica o local do código ActionScript pré-compilado que reside nos arquivos SWC criados. O arquivo FLA que especifica esse caminho carrega todos os arquivos SWC no nível superior desse caminho e qualquer outro recurso do código especificado nos próprios arquivos SWC. Se você utilizar o Caminho da biblioteca, certifique-se de que nenhum código compilado nos arquivos SWC seja duplicado nos arquivos AS não compilados no Caminho de origem. O código redundante desacelera a compilação do arquivo SWF.

É possível especificar mais de um caminho onde o Animate pode fazer a busca. Os recursos encontrados em qualquer um dos caminhos especificados serão utilizados. Ao adicionar ou modificar um caminho, você pode adicionar caminhos de diretório absolutos (por exemplo, C:/my_classes) e caminhos de diretório relativos (por exemplo, ../my_classes ou ".").

Definir o caminho da classe para o ActionScript 2.0

 

Observação: o ActionScript 2.0 é desaprovado com o Animate CC. Para obter mais informações, consulte este artigo

.Para definir o caminho de classe no nível do documento:

 

  1. Selecione Arquivo > Configurações de publicação e clique em Flash.

  2. Verifique se o ActionScript 2.0 está selecionado no menu pop-up Versão do ActionScript e clique em Configurações.
  3. Especifique o quadro no qual a definição de classe deve residir no campo de texto Exportar quadro para classes.
  4. Para adicionar caminhos à lista de caminhos de classe, siga um destes procedimentos:
    • Para adicionar uma pasta ao caminho de classes, clique no botão Navegar até o caminho , navegue até a pasta a ser adicionada e clique em OK.

    • Para adicionar uma nova linha à lista Caminho da classe, clique no botão Adicionar novo caminho . Clique duas vezes na nova linha, digite um caminho relativo ou absoluto e clique em OK.

    • Para editar uma pasta de caminho da classe existente, selecione o caminho na lista Caminho da classe, clique no botão Navegar até o caminho, navegue para a pasta a ser adicionada e clique em OK. Como alternativa, clique duas vezes no caminho na lista Caminho da classe, digite o caminho desejado e clique em OK.

    • Para excluir uma pasta do caminho da classe, selecione o caminho na lista Caminho da classe e clique no botão Remover caminho selecionado .

Para definir o caminho de classe no nível do aplicativo:

  1. Selecione Editar > Preferências (Windows) ou Flash > Preferências (Macintosh) e clique na categoria ActionScript.

  2. Clique no botão Configurações do ActionScript 2.0 e adicione o(s) caminho(s) à lista Caminho da classe.

Definir o caminho de origem para o ActionScript 3.0

Para definir o caminho de origem no nível do documento:

  1. Selecione Arquivo > Configurações de publicação e clique em Flash.

  2. Verifique se o ActionScript 3,0 está selecionado no menu pop-up Versão do ActionScript e clique em Configurações. Sua versão do Flash Player deve ser definida para Flash Player 9 ou posterior para usar o ActionScript 3.0.
  3. Especifique o quadro no qual a definição de classe deve residir no campo de texto Exportar classes no campo de texto Quadro.
  4. Especifique as configurações de Erro. Você pode selecionar o Modo estrito e o Modo de avisos. O Modo estrito reporta avisos do compilador 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.
  5. (Opcional) Selecione Palco para declarar automaticamente ocorrências do palco.
  6. Especifique ActionScript 3.0 ou ECMAScript como o dialeto a ser usado. Recomenda-se usar ActionScript 3.0.
  7. Para adicionar caminhos à lista de caminhos de origem, siga um destes procedimentos:
    • Para adicionar uma pasta ao caminho de origem, clique na aba Caminho de origem e, depois, clique no botão Navegar até o caminho , navegue até a pasta a ser adicionada e clique em OK.

    • Para adicionar uma nova linha à lista Caminho de origem, clique no botão Adicionar novo caminho . Clique duas vezes na nova linha, digite um caminho relativo ou absoluto e clique em OK.

    • Para editar uma pasta Caminho de origem existente, selecione o caminho na lista Caminho de origem, clique no botão Navegar até o caminho, navegue para a pasta a ser adicionada e clique em OK. Como alternativa, clique duas vezes no caminho na lista Caminho de origem, digite o caminho desejado e clique em OK.

    • Para excluir uma pasta do caminho de origem, selecione o caminho na lista Caminho de origem e clique no botão Remover do caminho .

Para definir o caminho de origem no nível do aplicativo:

  1. Selecione Editar > Preferências (Windows) ou Animate > Preferências (Macintosh) e clique na categoria ActionScript.

  2. Clique no botão Configurações do ActionScript 3.0 e adicione o(s) caminho(s) à lista Caminho de origem.

Definir o caminho da biblioteca para os arquivos do ActionScript 3.0

Para definir o caminho da biblioteca no nível do documento, o procedimento é similar ao da definição do caminho de origem:

  1. Escolha Configurações de Publicação de Arquivo.
  2. Verifique se o ActionScript 3.0 está especificado no menu Script e clique no botão Configurações do ActionScript.
  3. Na caixa de diálogo Configurações avançadas do ActionScript 3.0, clique na aba Caminho da biblioteca.
  4. Adicione o caminho da biblioteca à lista Caminho da biblioteca. É possível adicionar pastas ou arquivos SWC individuais à lista de caminhos.
  5. Para definir a propriedade Tipo de link, clique duas vezes em Tipo de link na árvore de propriedades do caminho. As opções de Tipo de link são:
    • Mesclado no código: os recursos de código encontrados no caminho são mesclados no arquivo SWF publicado.

    • Externo: os recursos de código encontrados no caminho não são adicionados ao arquivo SWF, mas o compilador verifica se eles estão nos locais especificados.

    • RSL (biblioteca compartilhada de tempo de execução): o Flash Player baixa os recursos no tempo de execução.

Para definir o caminho da biblioteca no nível do aplicativo:

  1. Selecione Editar > Preferências (Windows) ou Animate > Preferências (Macintosh) e clique na categoria ActionScript.

  2. Clique no botão Configurações do ActionScript 3.0 e adicione o(s) caminho(s) à lista Caminho da biblioteca.

Compilação condicional do ActionScript

Você pode usar a compilação condicional no ActionScript 3.0 da mesma forma que é usada em C++ e outras linguagens de programação. Por exemplo, você pode usar a compilação condicional para ativar ou desativar blocos de código em todo o projeto como, por exemplo, um código que implementa determinado recurso ou um código usado para depuração.

Usando as constantes de configuração definidas nas configurações de publicação, você pode especificar se determinadas linhas de código ActionScript serão compiladas ou não. Cada constante possui o seguinte formato:

CONFIG::SAMPLE_CONSTANT

Nesse formato, CONFIG corresponde ao espaço para nomes de configuração e SAMPLE_CONSTANT corresponde à constante que você irá definir como true ou false nas configurações de publicação. Quando o valor da constante for true, a linha de código que segue a constante no ActionScript será compilada. Quando o valor for false, a linha de código que segue a constante não será compilada.

Por exemplo, a função a seguir contém duas linhas de código que serão compiladas somente se o valor da constante precedente estiver definido como true nas configurações de publicação:

public function CondCompTest() { 
    CONFIG::COMPILE_FOR_AIR { 
        trace("This line of code will be compiled when COMPILE_FOR_AIR=true."); 
    } 
    CONFIG::COMPILE_FOR_BROWSERS { 
        trace("This line of code will be compiled when COMPILE_FOR BROWSERS=true."); 
    } 
}

Para definir uma constante de configuração usando a caixa de diálogo Configurações de publicação:

  1. Escolha Arquivo > Configurações de publicação.

  2. Certifique-se de que o valor do Script esteja definido como ActionScript 3.0 e clique no botão Configurações, ao lado do menu.

  3. Na caixa de diálogo Configurações avançadas do ActionScript 3.0, clique na aba Constantes de configuração.

  4. Para adicionar uma constante, clique no botão Adicionar.

  5. Digite o nome da constante que deseja adicionar. O espaço para nomes de configuração padrão é CONFIG e o nome da constante padrão é CONFIG_CONST.

    Observação:

    O espaço para nomes de configuração CONFIG será declarado pelo compilador do Animate automaticamente. Você pode adicionar seus próprios espaços para nomes de configuração especificando-os com um nome de constante nas configurações de publicação e adicionando-os ao seu código ActionScript usando a seguinte sintaxe:

    config namespace MY_CONFIG;
  6. Digite o valor desejado para a constante, que pode ser true ou false. É possível alterar esse valor para ativar ou desativar a compilação de linhas de código específicas.

Personalização de menus de contexto em documentos do (CS5.5)

Você pode personalizar o menu de contexto padrão e o menu de contexto de edição de texto que aparece com os arquivos SWF no Flash Player 7 e em versões posteriores.

  • O menu de contexto padrão aparece quando um usuário clica com o botão direito do mouse (Windows) ou clica com a tecla Control pressionada (Macintosh) em um arquivo SWF no Flash Player, em qualquer área, exceto em um campo de texto editável. Você pode adicionar itens personalizados ao menu e ocultar qualquer item incorporado no menu, exceto Configurações e Depurador.

  • O menu de contexto de edição aparece quando um usuário clica com o botão direito do mouse (Windows) ou clica com a tecla Control pressionada (Macintosh) em um campo de texto editável em um arquivo SWF no Flash Player. Você pode adicionar itens personalizados a esse menu. Você não pode ocultar qualquer item incorporado.

Observação:

O Flash Player também exibe um menu de contexto de erro quando um usuário clica com o botão direito do mouse (Windows) ou clica com a tecla Control pressionada (Macintosh) no Flash Player e nenhum arquivo SWF está carregado. Você não pode personalizar esse menu.

Personalize menus de contexto no Flash Player 7 usando os objetos ContextMenu e ContextMenuItem no ActionScript 2.0. Para obter mais informações sobre como usar esses objetos, consulte ContextMenu na Referência de linguagem do ActionScript 2.0.

Lembre-se das seguintes condições ao criar itens de menu de contexto personalizados para o Flash Player:

  • Os itens personalizados são adicionados a um menu de contexto na ordem na qual são criados. Você não pode modificar essa ordem após os itens terem sido criados.

  • Você pode especificar a visibilidade e a ativação de itens personalizados.

  • Os itens de menu de contexto personalizados são codificados automaticamente usando a codificação de texto Unicode UTF-8.

Pastas de configuração instaladas com o Flash (CS5.5)

O Flash coloca várias pastas de configuração em seu sistema quando você instala o aplicativo. As pastas de configuração organizam os arquivos associados ao aplicativo em níveis apropriados de acesso do usuário. Você pode querer exibir o conteúdo dessas pastas quando estiver trabalhando com o ActionScript® ou com componentes. As pastas de configuração para o Flash são as seguintes:

Pasta de configuração no nível do aplicativo

Por estar no nível do aplicativo, os usuários não administradores não têm acesso de gravação a esse diretório. Os caminhos típicos para essa pasta são os seguintes:

  • No Microsoft Windows XP ou no Microsoft Windows Vista, navegue até unidade de inicialização\Arquivos de programas\Adobe\Adobe Flash CS3\idioma\Configuration\.

  • No Macintosh, navegue até Disco rígido Macintosh/Applications/Adobe Flash CS3/Configuration/.

Pasta First Run

Esse irmão da pasta de configuração no nível do aplicativo facilita o compartilhamento de arquivos de configuração entre usuários do mesmo computador. As pastas e os arquivos na pasta First Run são automaticamente copiados para a pasta de configuração no nível do usuário. Qualquer arquivo novo colocado na pasta First Run é copiado para a pasta de configuração no nível do usuário quando você inicia o aplicativo.

Os caminhos típicos para a pasta First Run são os seguintes:

  • No Windows XP ou no Vista, navegue até unidade de inicialização\Arquivos de programas\Adobe\Adobe Flash CS3\idioma\First Run\.

  • No Macintosh, navegue até Disco rígido Macintosh/Applications/Adobe Flash CS3/First Run/.

Pasta de configuração no nível do usuário

Localizada na área de perfil do usuário, essa pasta é sempre gravável pelo usuário atual. Os caminhos típicos para essa pasta são os seguintes:

  • No Windows XP ou no Vista, navegue até unidade de inicialização\Documents and Settings\nome do usuário\Local Settings\Application Data\Adobe\Flash CS3\idioma\Configuration.

  • No Macintosh, navegue até Disco rígido Macintosh/Users/nome do usuário/Library/Application Support/Adobe/Flash CS3/idioma/Configuration/.

Pasta de configuração no nível de todos os usuários

Localizada na área comum de perfil do usuário, essa pasta faz parte das instalações-padrão dos sistemas operacionais Windows e Macintosh e é compartilhada por todos os usuários de um computador em particular. O sistema operacional disponibiliza a todos os usuários do computador qualquer arquivo colocado nessa pasta. Os caminhos típicos para essa pasta são os seguintes:

  • No Windows XP ou no Vista, navegue até unidade de inicialização\Documents and Settings\All Users\Application Data\Adobe\Flash CS3\idioma\Configuration\.

  • No Macintosh, navegue até Disco rígido Macintosh/Users/Shared/Application Support/Adobe/Flash CS3/idioma/Configuration/.

Pasta de configuração Restricted Users

Para usuários com privilégios restritos em uma estação de trabalho: geralmente, em um ambiente de rede, somente os administradores do sistema têm acesso administrativo às estações de trabalho. Todos os outros usuários recebem acesso restrito, o que, geralmente, significa que esses usuários não podem gravar arquivos no nível do aplicativo (como o diretório Arquivos de programas no Windows, ou a pasta Applications no Macintosh OS X).

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