Criando seu primeiro aplicativo desktop do AIR com o Flex SDK

Para obter ilustrações práticas e rápidas sobre o funcionamento do Adobe® AIR®, use estas instruções para criar um simples aplicativo AIR com base em SWF "Hello World" utilizando o Flex SDK. Este tutorial mostra como compilar, testar e empacotar um aplicativo do AIR com as ferramentas de linha de comando fornecidas com o Flex SDK (o Flex SDK inclui o AIR SDK).

Para começar, você deve ter instalado o tempo de execução e configurar o Adobe® Flex™. Este tutorial utiliza o compilador AMXMLC, o AIR Debug Launcher (ADL) e a AIR Developer Tool (ADT). Estes programas podem ser encontrados no diretório bin do Flex SDK (consulte Definição do SDK do Flex).

Criar o arquivo descritor do aplicativo AIR

Esta seção descreve como criar o descritor do aplicativo, que é um arquivo XML com a estrutura a seguir:

<application xmlns="..."> 
    <id>...</id> 
    <versionNumber>...</versionNumber> 
    <filename>…</filename> 
    <initialWindow> 
        <content>…</content> 
        <visible>…</visible> 
        <width>…</width> 
        <height>…</height> 
    </initialWindow> 
</application>
  1. Crie um arquivo XML com o nome HelloWorld-app.xml e salve-o no diretório do projeto.

  2. Acrescente o elemento <application>, incluindo o atributo de espaço de nome do AIR:

    <application xmlns="http://ns.adobe.com/air/application/2.6"> O último segmento do espaço de nome, “2.6”, especifica a versão do tempo de execução de que o aplicativo necessita.

  3. Acrescente o elemento <id>:

    <id>samples.flex.HelloWorld</id> O id do aplicativo identifica exclusivamente seu aplicativo junto com a ID de editor (que o AIR cria do certificado usado para assinar o pacote do aplicativo). A forma recomendado é uma seqüência de caractere separados por pontos, do tipo DNS reverso, como, por exemplo, "com.company.AppName". A ID de aplicativo é usada para instalação, acesso ao diretório privado de armazenamento do sistema de arquivos, acesso ao armazenamento criptografado privado e comunicação entre aplicativos.

  4. Acrescente o elemento <versionNumber>:

    <versionNumber>1.0</versionNumber> Ajuda os usuários a determinar qual versão do aplicativo eles estão instalando.

  5. Acrescente o elemento <filename>:

    <filename>HelloWorld</filename> O nome dusado para o executável do aplicativo, diretório de instalação e outras referências ao aplicativo no sistema operacional.

  6. Acrescente o elemento <initialWindow> que contém os seguintes elementos filho para especificar as propriedades da janela inicial do seu aplicativo:

    <content>HelloWorld.swf</content> Identifica o arquivo HTML raiz que o AIR deve carregar.

    <visible>true</visible> Torna a janela visível imediatamente.

    <width>400</width> Ajusta a largura da janela (em pixels).

    <height>200</height> Ajusta a altura da janela.

  7. Salve o arquivo. O arquivo descritor de aplicativo completo deve assemelhar-se ao seguinte:

    <?xml version="1.0" encoding="UTF-8"?> 
    <application xmlns="http://ns.adobe.com/air/application/2.6"> 
        <id>samples.flex.HelloWorld</id> 
        <versionNumber>0.1</versionNumber> 
        <filename>HelloWorld</filename> 
        <initialWindow> 
            <content>HelloWorld.swf</content> 
            <visible>true</visible> 
            <width>400</width> 
            <height>200</height> 
        </initialWindow> 
    </application>

Este exemplo só define algumas propriedades possíveis do aplicativo. Para ver o conjunto completo de propriedades do aplicativo, que lhe permitem especificar coisas como cromo e tamanho da janela, transparência, diretório padrão de instalação, tipos de arquivo associados e ícones do aplicativo, consulte Arquivos descritores do aplicativo do AIR.

Gravação do código do aplicativo

Nota: Aplicativos com SWF com base no AIR podem utilizar a classe principal definida no MXML ou com o Adobe® ActionScript® 3.0. Este exemplo utiliza o arquivo MXML para definir a classe principal. O processo de criação de um aplicativo AIR com a classe principal ActionScript é similar. Em vez de compilar um arquivo MXML em um arquivo SWF, compile o arquivo da classe ActionScript. Ao utilizar ActionScript, a classe principal deve estender-se a flash.display.Sprite.

Como todos os aplicativos com base em Flex, os aplicativos AIR criados com o Flex contém o arquivo principal MXML. Aplicativos desktop do AIR usam o componente WindowedApplication como elemento raiz, em vez do componente Application. O componente WindowedApplication fornece propriedades, métodos e eventos para controlar seu aplicativo e a janela inicial. Em plataformas e perfis para os quais o AIR não oferece suporte a várias janelas, continue a utilizar o componente Application. Nos aplicatos Flex móveis, você também pode usar o componente Visualização ou o componente TabbedViewNavigatorApplication.

O procedimento a seguir cria o aplicativo Hello World:

  1. Utilizando um editor de texto, crie um arquivo chamado HelloWorld.mxml e adicione o código MXML a seguir:

    <?xml version="1.0" encoding="utf-8"?> 
    <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                           xmlns:s="library://ns.adobe.com/flex/spark" 
                           xmlns:mx="library://ns.adobe.com/flex/mx" 
                           title="Hello World"> 
    </s:WindowedApplication>
  2. Em seguida, adicione um componente Label ao aplicativo (insira-o na tag WindowedApplication).

  3. Defina propriedade text do componente Label para "Hello AIR".

  4. Defina as restrições de layout para sempre manter centralizado.

    O exemplo a seguir mostra o código até agora:

    <?xml version="1.0" encoding="utf-8"?> 
    <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                           xmlns:s="library://ns.adobe.com/flex/spark" 
                           xmlns:mx="library://ns.adobe.com/flex/mx" 
                           title="Hello World"> 
         
        <s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/> 
    </s:WindowedApplication>

Compile o aplicativo

Antes de executar e depurar o aplicativo, compile o código MXML em um arquivo SWF utilizando o compilador amxmlc. O compilador amxmlc pode localizar o diretório bin do Flex SDK. Se preferir, você pode definir a variável de ambiente do caminho de seu computador para incluir o diretório bin o Flex SDK. A configuração do caminho facilita a execução dos utilitários na linha de comando.

  1. Abra um prompt de comando ou um terminal e navegue até a pasta de projeto do aplicativo AIR.

  2. Digite o seguinte comando:

    amxmlc HelloWorld.mxml 

O compilador amxmlc cria o arquivoHelloWorld.swf, que contém o código compilado do aplicativo.

Nota: Se o aplicativo não compilar, corrija erros de sintaxe ou ortografia. Erros e avisos serão exibidos na janela do console utilizado para executar o compilador amxmlc.

Para obter mais informações, consulte Compilação de arquivos de origem do MXML e ActionScript para AIR.

Testar o aplicativo

Para executar e testar o aplicativo a partir da linha de comando, utilize o AIR Debug Launcher (ADL) para executar o aplicativo utilizando o arquivo do descritor do aplicativo. (O ADL pode ser encontrado no diretório bin do Flex SDK.)

 No prompt de comando, insira o comando a seguir:
adl HelloWorld-app.xml 

O aplicativo AIR resultante é similiar à figura a seguir:

Usando as propriedades horizontalCenter e verrticalCenter do controle Label, o texto é colocado no centro da janela. Move ou redimensione a janela como você faria em qualquer outro aplicativo do computador.

Para obter mais informações, consulte AIR Debug Launcher (ADL).

Criar o arquivo de instalação do AIR

Quando seu aplicativo é executado com sucesso, você pode usar o utilitário ADT para empacotar o aplicativo em um arquivo de instalação do AIR. Um arquivo de instalação do AIR é um arquivo de compactação que contém todos os arquivos do aplicativo, que você pode distribuir para seus usuários. Você deve instalar o Adobe AIR antes de instalar um arquivo AIR empacotado.

Para garantir a segurança do aplicativo, todos os arquivos de instalação do AIR devem ser digitalmente assinados. Para fins de desenvolvimento, você pode gerar um certificado básico autoassinado com o ADT ou outra ferramenta de geração de certificados. Você também pode adquirir um certificado de assinatura de código comercial de uma autoridade de certificação. Quando os usuários instalam um arquivo AIR autoassinado, o editor é exibido como "desconhecido" durante o processo de instalação. Isso ocorre porque um certificado autoassinado só garante que o arquivo AIR não tenha sido alterado desde sua criação. Não há nada que impeça alguém de autoassinar um arquivo AIR disfarçado e apresentá-lo como seu aplicativo. Para os arquivos AIR liberados ao público, um certificado comercial verificável é altamente recomendado. Para uma visão geral de questões de segurança do AIR, consulte Segurança do AIR (para desenvolvedores em ActionScript) ou AIR security (para desenvolvedores em HTML).

Gerar um certificado autoassinado e par de chaves

 No prompt de comando, insira o comando a seguir (o executável ADT está no diretório bin do SDK do Flex):
adt –certificate -cn SelfSigned 1024-RSA sampleCert.pfxsamplePassword

Este exemplo usa o número mínimo de atributos que podem ser definidos para um certificado. Você pode usar quaisquer valores para os parâmetros em itálico. O tipo de chave deve ser 1024-RSA ou 2048-RSA (consulte Assinatura de aplicativos AIR).

Crie o pacote do AIR

 No prompt de comando, digite o seguinte comando (em uma única linha):
adt -package -storetype pkcs12 -keystore sampleCert.pfx HelloWorld.air 
HelloWorld-app.xml HelloWorld.swf

Você terá que fornecer a senha do arquivo do keystore. Digite a senha e pressione Enter. Os caracteres da senha não são exibidos por motivos de segurança.

O argumento HelloWorld.air é o arquivo AIR que o ADT produz. HelloWorld-app.xml é o arquivo descritor do aplicativo. Os argumentos subsequentes são os arquivos usados pelo seu aplicativo. Esse exemplo só usa três arquivos, mas você pode incluir qualquer número de arquivos e diretórios.

Depois da criação do pacote AIR, você pode instalar e executar o aplicativo clicando duas vezes no arquivo de pacote Você também pode digitar o nome do arquivo AIR como comando em um shell ou janela de comando.

Para obter mais informações, consulte Compactação de um arquivo de instalação AIR desktop..