Criando seu primeiro aplicativo desktop do AIR com o Flex SDK

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.7"> O último segmento do espaço de nome, “2.7”, especifica a versão do runtime 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 o ID de editor (que o AIR cria do certificado usado para assinar o pacote do aplicativo). A forma recomendado é uma sequência de caractere separados por pontos, do tipo DNS reverso, como, por exemplo, "com.company.AppName" . O 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.

   Nota: Se você estiver utilizando o AIR 2 ou anterior, deverá utilizar o elemento <version> em vez do elemento <versionNumber> .

5. Acrescente o elemento <filename> :

   <filename>HelloWorld</filename> O nome usado 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 SWF de raiz para o AIR 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.7"> 
       <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 .

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

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

2. Digite o seguinte comando:

   amxmlc HelloWorld.mxml 

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

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

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 do AIR resultante é similar à 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) .

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

Este exemplo usa o número mínimo de atributos que podem ser definidos para um certificado. 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. .