Air Building Apps

Construindo aplicativos no ADOBE AIR

Avisos legais

Avisos legaisPara ver os avisos legais, consulte http://help.adobe.com/pt_BR/legalnotices/index.html.

Last updated 27/4/2011

iii

ContedoCaptulo 1: Sobre o Adobe AIR Captulo 2: Instalao do Adobe AIR Instalao do Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Remoo do Adobe AIR Atualizaes do Adobe AIR ............................................................................................... 4 ................................................................ 5 ............................................................................................ 6 Instalao e execuo de aplicativos de amostra do AIR

Captulo 3: Trabalhando com APIs do AIR Classes do ActionScript 3.0 especficas do AIR Componentes Flex especficos do AIR

.......................................................................... 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Classes do Flash Player com funcionalidade especfica do AIR

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Captulo 4: Ferramentas da Plataforma Adobe Flash para desenvolvimento do AIR Instalao do SDK do AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Definio do SDK do Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Configurao de SDKs externos

Captulo 5: Criando seu primeiro aplicativo do AIR Criando seu primeiro aplicativo desktop Flex AIR no Flash Builder

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Criao do seu primeiro aplicativo do AIR desktop usando o Flash Professional Crie seu primeiro aplicativo do AIR para Android no Flash Professional Criao de seu primeiro aplicativo do AIR para iOS

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Criao do primeiro aplicativo AIR baseado em HTML com o Dreamweaver Criao do seu primeiro aplicativo AIR baseado em HTML com o SDK do AIR Criando seu primeiro aplicativo desktop do AIR com o Flex SDK Criando seu primeiro aplicativo do AIR para Android com o Flex SDK Captulo 6: Desenvolvendo aplicativos AIR para desktop Fluxo de trabalho para desenvolver um aplicativo AIR para desktop Configurao de propriedades do aplicativo desktop Depurao de um aplicativo AIR desktop

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Compactao de um arquivo de instalao AIR desktop. Compactao de um instalador desktop nativo

Distribuio de pacotes do AIR para computadores desktop

Captulo 7: Desenvolvendo aplicativos AIR para dispositivos mveis Configurao do ambiente de desenvolvimento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Consideraes a respeito do design do aplicativo mvel Configurao de propriedades do aplicativo mvel Compactao de um aplicativo AIR mvel Depurao de um aplicativo AIR mvel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Fluxo de trabalho para a criao de aplicativos AIR para dispositivos mveis

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86


CONSTRUINDO APLICATIVOS NO ADOBE AIRContedo

iv

Instalao de aplicativos AIR AIRI nos dispositivos mveis Atualizando aplicativos AIR mveis

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Captulo 8: Desenvolvendo aplicativos AIR para aparelhos de televiso Capacidades do dispositivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Consideraes a respeito do design do aplicativo para AIR para TV Fluxo de trabalho para desenvolver um aplicativo AIR para TV Definio de propriedades do aplicativo AIR para TV Compactao de um aplicativo AIR para TV Depurao de aplicativos AIR para TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Captulo 9: Compiladores ActionScript Sobre as ferramentas de linha de comando do AIR no Flex SDK Configurao do compilador

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Compilao de arquivos de origem do MXML e ActionScript para AIR

Compilao de um componente ou de uma biblioteca de cdigos do AIR (Flex)

Captulo 10: AIR Debug Launcher (ADL) Uso do ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Exemplos de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Cdigos de erro e sada do ADL

Captulo 11: AIR Developer Tool (ADT) Comandos do ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Conjuntos de opes do ADT Mensagens de erro do ADT Variveis de ambiente ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Captulo 12: Assinatura de aplicativos AIR Assinatura digital de um arquivo AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 Criao de um arquivo intermedirio do AIR no assinado com o ADT Assinatura de um arquivo intermedirio do AIR com o ADT Assinatura de uma verso atualizada de um aplicativo do AIR Criao de um certificado auto-assinado com o ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Captulo 13: Arquivos descritores do aplicativo do AIR Mudanas no descritor do aplicativo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 A estrutura do arquivo do descritor do aplicativo Elementos descritores do aplicativo AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Captulo 14: Perfis de dispositivo Como restringir perfis de destino no arquivo de descrio do aplicativo Capacidades de perfis diferentes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Captulo 15: API no navegador AIR.SWF Personalizao da instalao contnua badge.swf Carregar o arquivo air.swf

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

Usando o arquivo badge.swf para instalar um aplicativo do AIR Verificar se o tempo de execuo est instalado

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210


CONSTRUINDO APLICATIVOS NO ADOBE AIRContedo

v

Verificar por uma pgina da Web se um aplicativo do AIR est instalado Instalao de um aplicativo do AIR do navegador Inicializao de um aplicativo do AIR instalado do navegador

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Captulo 16: Atualizao de aplicativos do AIR Sobre atualizao de aplicativos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 Apresentao de uma interface de usurio de atualizao do aplicativo personalizado Download de um arquivo AIR no computador do usurio Uso da estrutura de atualizao Verificar se um aplicativo est sendo executado pela primeira vez . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Captulo 17: Visualizao do cdigo-fonte Carregamento, configurao e abertura do Visualizador de Cdigo-Fonte Interface do usurio do Visualizador do Cdigo-Fonte

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

Captulo 18: Depurao com o AIR HTML Introspector Sobre o AIR Introspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Carregamento do cdigo do AIR Introspector Inspeo de um objeto na guia Console Configurao do AIR Introspector Interface do AIR Introspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Uso do AIR Introspector com contedo em uma caixa de proteo no do aplicativo Captulo 19: Localizao de aplicativos AIR Localizao do nome e da descrio do aplicativo no instalador do aplicativo AIR Localizao de contedo HTML com a estrutura de localizao de HTML do AIR Captulo 20: Variveis de ambiente do caminho Configurao do PATH no Linux e Mac OS usando o shell Bash Configurao do caminho no Windows

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262


1

Captulo 1: Sobre o Adobe AIRO Adobe AIR um tempo de execuo cruzado de sistema operacional com vrias telas que permite que voc potencialize suas habilidades de desenvolvimento Web para criar e implantar aplicativos avanados da Internet (RIAs) para rea de trabalho de dispositivos mveis. Aplicativos para desktop, televiso e AIR mveis podem ser desenvolvidos com ActionScript 3.0 usando Adobe Flex e Adobe Flash (com base SWF). Os aplicativos de desktop AIR tambm podem ser desenvolvidos com HTML, JavaScript e Ajax (com base HTML). Voc pode encontrar mais informaes sobre introduo e uso do Adobe AIR na Conexo de desenvolvedores do Adobe AIR em (http://www.adobe.com/devnet/air/). O AIR permite que voc trabalhe em ambientes domsticos para potencializar as ferramentas e abordagens que julgar mais confortveis. Ao suportar Flash, Flex, HTML, JavaScript e Ajax, voc pode criar a melhor experincia possvel que atenda s suas necessidades. Por exemplo, os aplicativos podem ser desenvolvidos usando uma das seguintes tecnologias ou uma combinao delas:

Flash / Flex / ActionScript HTML / JavaScript / CSS / AjaxUsurios interagem com aplicativos AIR da mesma forma que interagem com aplicativos nativos. O tempo de execuo instalado uma vez no dispositivo ou computador do usurio e, em seguida, os aplicativos AIR so instalados e executados exatamente como qualquer outro aplicativo da rea de trabalho. (No iOS o tempo de execuo de um AIR separado no instalado; cada aplicativo AIR iOS um aplicativo independente). O tempo de execuo oferece uma plataforma cruzada de sistema operacional e estrutura para implantao de aplicativos e, portanto, elimina os testes entre navegadores, assegurando funcionalidade e interaes consistentes entre reas de trabalho. Em vez de desenvolver para um sistema operacional especfico, voc direciona o tempo de execuo, o que oferece seguintes benefcios:

Aplicativos desenvolvidos para execuo do AIR atravs de vrios sistemas operacionais sem nenhum trabalhoadicional feito por voc. O tempo de execuo assegura apresentaes e interaes previsveis e consistentes entre todos os sistemas operacionais com suporte do AIR.

Os aplicativos podem ser criados mais rapidamente, permitindo que voc potencialize tecnologias da Web epadres de projeto existentes. Voc pode estender aplicativos com base na Web para a rea de trabalho sem aprender tecnologias tradicionais para desenvolvimento de rea de trabalho nem a complexidade do cdigo nativo.

O desenvolvimento do aplicativo mais fcil do que o uso de linguagens de nvel inferior, como C e C++. Voc noprecisa gerenciar APIs complexas de nvel inferior, especficas de cada sistema operacional. Ao desenvolver aplicativos para o AIR, voc pode potencializar um enorme conjunto de estruturas e APIs:

APIs especficas do AIR fornecidas pelo tempo de execuo e pela estrutura AIR APIs do ActionScript usadas em arquivos SWF e na estrutura Flex (bem como outras bibliotecas e estruturasbaseadas no ActionScript)

HTML, CSS e JavaScript Maioria das estruturas Ajax


CONSTRUINDO APLICATIVOS NO ADOBE AIRSobre o Adobe AIR

2

O AIR altera significativamente o modo como os aplicativos podem ser criados, implantados e experimentados. Voc obtm mais controle criativo e pode estender os aplicativos baseados em Flash, Flex, HTML e Ajax para a rea de trabalho, dispositivos mveis e televises. Para obter mais informaes sobre o que est includo em cada nova verso do AIR, consulte as Notas de verso do Adobe AIR (http://www.adobe.com/go/learn_air_relnotes_br).


3

Captulo 2: Instalao do Adobe AIRO Adobe AIR permite executar aplicativos AIR. possvel instalar o tempo de execuo das seguintes formas:

Instalando o tempo de execuo separadamente (sem instalar tambm um aplicativo AIR) Ao instalar um aplicativo AIR por meio de um badge de instalao de uma pgina web (tambm ser solicitada ainstalao do tempo de execuo)

Configurando um ambiente de desenvolvimento AIR como o AIR SDK, Adobe Flash Builder, ou o Adobe FlexSDK (que inclui as ferramentas de desenvolvimento de linha de comando do AIR). O tempo de execuo includo no SDK somente utilizado para a depurao de aplicativos no utilizado para executar aplicativos AIR instalados. Os requisitos do sistema para instalar o AIR e executar aplicativos do AIR so detalhados aqui: Adobe AIR: Requisitos do sistema (http://www.adobe.com/br/products/air/systemreqs/). Tanto o programa de instalao do tempo de execuo quanto o programa de instalao do aplicativo do AIR criam arquivos de registro quando instalam, atualizam ou removem aplicativos AIR ou o prprio tempo de execuo do AIR. Voc pode consultar estes arquivos de registro para ajudar a determinar a causa de problemas de instalao. Consulte Registros de instalao. Nota: No iOS, o tempo de execuo do AIR no instalado separadamente. Cada aplicativo AIR um aplicativo autnomo.

Instalao do Adobe AIRPara instalar ou atualizar o tempo de execuo, o usurio deve ter privilgios administrativos no computador. Instalao do tempo de execuo em um computador com Windows 1 Faa download do arquivo de instalao do tempo de execuo em http://get.adobe.com/air.2 Clique duas vezes no arquivo de instalao do tempo de execuo. 3 Na janela de instalao, siga os avisos para concluir a instalao.

Instalao do tempo de execuo em um computador com Mac 1 Faa download do arquivo de instalao do tempo de execuo em http://get.adobe.com/air.2 Clique duas vezes no arquivo de instalao do tempo de execuo. 3 Na janela de instalao, siga os avisos para concluir a instalao. 4 Se o instalador exibir a janela Autenticao, insira seu nome de usurio e sua senha do Mac OS.

Instalao do tempo de execuo em um computador com Linux Utilizando o instalador binrio:1 Faa download do arquivo de instalao binrio em http://get.adobe.com/air. 2 Defina as permisses de arquivo para que seja possvel executar o aplicativo instalador. A partir da linha de

comando, possvel definir as permisses de arquivo com:chmod +x AdobeAIRInstaller.bin


CONSTRUINDO APLICATIVOS NO ADOBE AIRInstalao do Adobe AIR

4

Algumas verses do Linux permitem definir as permisses de arquivo na caixa de dilogo Propriedades aberta por meio de um menu de contexto.3 Execute o instalador da linha de comando ou clicando duas vezes no arquivo de instalao do tempo de execuo. 4 Na janela de instalao, siga os avisos para concluir a instalao.

O Adobe AIR est instalado como pacote nativo. Ou seja, como rpm e uma distribuio com base em rpm e deb em uma distribuio Debian. Atualmente o AIR no possui suporte a outro tipo de formato de pacote. Utilizando os instaladores de pacote:1 Faa download do arquivo de instalao AIR a partir de http://get.adobe.com/air. Selecione o pacote rpm ou

Debian, dependendo de qual formato de pacote for suportado pelo seu sistema.2 Caso necessrio, clique duas vezes no arquivo do pacote AIR para instalar o aplicativo.

Opcionalmente, possvel instalar o pacote a partir da linha de comando:a Em um sistema Debian:sudo dpkg -i /adobeair-2.0.0.xxxxx.deb

b Em um sistema com base em rpm:sudo rpm -i /adobeair-2.0.0-xxxxx.i386.rpm

Ou, caso esteja atualizando uma verso existente (AIR 1.5.3 ou posterior):sudo rpm -U /adobeair-2.0.0-xxxxx.i386.rpm

A instalao de aplicativos AIR 2 e AIR necessitam que voc possua privilgios administrativos em seu computador. O Adobe AIR instalado no caminho a seguir: /opt/Adobe AIR/Versions/1.0 O AIR registra o mime-type "application/vnd.adobe.air-application-installer-package+zip", significando que arquivos .air pertencem a esse mime-type e so registraddos com o tempo de execuo AIR. Instale o tempo de execuo em um dispositivo Android Voc pode instalar a verso mais recente do tempo de execuo AIR a partir do Android Market. Voc pode instalar verses de desenvolvimento do tempo de execuo AIR a partir de um link em um site ou usando o comando ADT -installRuntime. Somente uma verso do tempo de execuo AIR pode ser instalado em um tempo; voc no pode ter uma nova verso e uma verso de desenvolvimento instaladas. Consulte Comando installRuntime do ADT na pgina 143 para obter mais informaes. Instale o tempo de execuo em um dispositivo iOS O cdigo do tempo de execuo AIR necessrio fornecido com cada aplicativo criado para os dispositivos iPhone, iTouch e iPad. Voc no precisa instalar um componente de tempo de execuo separado.

Mais tpicos da AjudaAIR para iOS na pgina 65

Remoo do Adobe AIRAps instalar o tempo de execuo, voc poder remov-lo usando os seguintes procedimentos.



5

Remoo do tempo de execuo em um computador com Windows 1 No menu Iniciar do Windows, selecione Configuraes > Painel de controle.2 Abra o painel de controle Programas, Programas e Recursos ou Adicionar ou Remover Programas (dependendo de

qual verso do Windows que estiver em uso).3 Selecione Adobe AIR para remover o tempo de execuo. 4 Clique no boto Alterar/remover.

Remoo do tempo de execuo em um computador com Mac Clique duas vezes em Desinstalador do Adobe AIR, localizado na pasta /Aplicativos/Utilitrios. Remoo do tempo de execuo em um computador com Linux Execute um dos seguintes procedimentos:

Selecione o comando Adobe AIR Uninstaller no menu Aplicativos. Execute o binrio instalador do AIR com a opo -uninstall. Remova os pacotes do AIR (adobeair e adobecerts) com o gerenciador de pacotes.Remova o tempo de execuo de um dispositivo Android 1 Abra o aplicativo Configuraes do dispositivo.2 Toque a entrada do Adobe AIR em Aplicativos > Gerenciar aplicativos. 3 Toque o boto Desinstalar.

Voc tambm pode usar o comando ADT -uninstallRuntime. Consulte Comando uninstallRuntime do ADT na pgina 144 para obter mais informaes.

Instalao e execuo de aplicativos de amostra do AIRPara instalar ou atualizar um aplicativo AIR, o usurio deve ter privilgios administrativos no computador. Alguns aplicativos de amostra esto disponveis para demonstrar recursos do AIR Voc pode acess-los e desinstallos usando as seguintes instrues:1 Faa download e execute os aplicativos de amostra do AIR. Os aplicativos compilados, bem como o cdigo fonte,

esto disponveis.2 Para fazer download e executar o aplicativo de amostra, clique no boto Instalar agora do aplicativo de amostra.

Voc solicitado a instalar e executar o aplicativo.3 Se voc optar por fazer download de aplicativos de amostra e execut-los mais tarde, selecione os links de download.

Voc pode executar aplicativos AIR a qualquer momento:

No Windows, clicando duas vezes no cone do aplicativo na rea de trabalho, ou selecionando-o no menu Iniciardo Windows.

No Mac OS, clicando duas vezes no cone do aplicativo, que est instalado na pasta Aplicativos do diretrio dousurio (por exemplo, no Macintosh, HD/Users/JoeUser/Applications/), por padro.

No Linux, clicando duas vezes no cone do aplicativo na rea de trabalho, ou selecionando-o no menuAplicativos. Os aplicativos do AIR so instalados em sua prpria pasta no diretrio /opt.



6

Nota: Verifique as notas de verso do AIR para atualizaes dessas instrues, que esto localizadas aqui: http://www.adobe.com/go/learn_air_relnotes_br.

Atualizaes do Adobe AIRPeriodicamente, a Adobe atualiza o Adobe AIR com novos recursos ou o corrige para diminuir problemas. Os recursos Notificao Automtica e Atualizar permitem Adobe notificar automaticamente os usurios quando um verso atualizada do Adobe AIR est disponvel. As atualizaes do Adobe AIR garantem que o Adobe AIR funcione adequadamente e possam conter modificaes importantes na segurana. A Adobe recomenda que os usurios atualizem para a verso mais recente do Adobe AIR sempre que uma nova verso estiver disponvel, especialmente quando uma atualizao de segurana for indicada. Por padro, quando um aplicativo AIR lanado, o tempo de execuo verifica se uma atualizao est disponvel. Ele realiza esta verificao sempre que decorrem mais de duas semanas da ltima verificao de atualizao. Se uma atualizao estiver disponvel, o AIR baixar a atualizao em segundo plano. Os usurios podem desativar a capacidade de atualizao automtica usando o aplicativo AIR SettingsManager. O aplicativo AIR SettingsManager est disponvel para download em http://airdownload.adobe.com/air/applications/SettingsManager/SettingsManager.air. O processo de instalao normal do Adobe AIR inclui a conexo com http://airinstall.adobe.com para enviar informaes bsicas sobre o ambiente de instalao, tais como verso e idioma do sistema operacional. Esta informao s transmitida uma vez em cada instalao e permite que o Adobe confirme se a instalao foi concluda com xito. Nenhuma informao que possa identificar o usurio coletada ou transmitida.


7

Captulo 3: Trabalhando com APIs do AIRO Adobe AIR inclui funcionalidade que no est disponvel para contedo do SWF em execuo no Adobe Flash Player. Desenvolvedores de ActionScript 3.0 As APIs do Adobe AIR so documentadas nos seguintes livros:

Guia do desenvolvedor ActionScript 3.0 Referncia do ActionScript 3.0 para Adobe Flash PlatformDesenvolvedores de HTML Se voc estiver criando aplicativos AIR com base em HTML, as APIs disponveis em JavaScript via arquivo AIRAliases.js (consulte Acessando classes de API do AIR a partir do JavaScript) esto documentadas nos seguintes livros:

HTML Developer's Guide for Adobe AIR Adobe AIR API Reference for HTML Developers

Classes do ActionScript 3.0 especficas do AIRA tabela a seguir contm classes de tempos de execuo especficas do Adobe AIR. Elas no esto disponveis no contedo SWF executado no Adobe Flash Player em um navegador. Desenvolvedores de HTML As classes disponveis no JavaScript via arquivo AIRAliases.js esto indicadas em Referncia de API do Adobe AIR para desenvolvedores de HTML.

Classe AAAARecord ApplicationUpdater ApplicationUpdaterUI ARecord BrowserInvokeEvent CameraRoll CameraUI CertificateStatus CompressionAlgorithm DatagramSocket

Pacote ActionScript 3.0 flash.net.dns air.update air.update flash.net.dns flash.events flash.media flash.media flash.security flash.utils flash.net

Includo na verso AIR 2.0 1.5 1.5 2.0 1.0 2.0 2.5 2.0 1.0 2.0


CONSTRUINDO APLICATIVOS NO ADOBE AIRTrabalhando com APIs do AIR

8

Classe DatagramSocketDataEvent DNSResolver DatagramSocketDataEvent DockIcon DownloadErrorEvent DRMAuthenticateEvent DRMManagerError EncryptedLocalStore ExtensionContext File FileListEvent FileMode FileStream FocusDirection Geolocation DatagramSocketDataEvent HTMLHistoryItem HTMLHost HTMLLoader HTMLPDFCapability HTMLSWFCapabiltiy HTMLUncaughtScriptExceptionEvent HTMLWindowCreateOptions Icon IFilePromise ImageDecodingPolicy InteractiveIcon InterfaceAddress InvokeEvent InvokeEventReason IPVersion IURIDereferencer LocationChangeEvent MediaEvent

Pacote ActionScript 3.0 flash.events flash.net.dns flash.events flash.desktop air.update.events flash.events flash.errors flash.data flash.external flash.filesystem flash.events flash.filesystem flash.filesystem flash.display flash.sensors flash.events flash.html flash.html flash.html flash.html flash.html flash.events flash.html flash.desktop flash.desktop flash.system flash.desktop flash.net flash.events flash.desktop flash.net flash.security flash.events flash.events

Includo na verso AIR 2.0 2.0 2.0 1.0 1.5 1.0 1.5 1.0 2.5 1.0 1.0 1.0 1.0 1.0 2.0 2.0 1.0 1.0 1.0 1.0 2.0 1.0 1.0 1.0 2.0 2.6 1.0 2.0 1.0 1.5.1 2.0 1.0 2.5 2.5



9

Classe MediaPromise MediaType MXRecord NativeApplication NativeDragActions NativeDragEvent NativeDragManager NativeDragOptions NativeMenu NativeMenuItem NativeProcess NativeProcessExitEvent NativeProcessStartupInfo NativeWindow NativeWindowBoundsEvent NativeWindowDisplayState NativeWindowDisplayStateEvent NativeWindowInitOptions NativeWindowResize NativeWindowSystemChrome NativeWindowType NetworkInfo NetworkInterface NotificationType OutputProgressEvent PaperSize PrintMethod PrintUIOptions MXRecord ReferencesValidationSetting ResourceRecord RevocationCheckSettings Screen ScreenMouseEvent

Pacote ActionScript 3.0 flash.media flash.media flash.net.dns flash.desktop flash.desktop flash.events flash.desktop flash.desktop flash.display flash.display flash.desktop flash.events flash.desktop flash.display flash.events flash.display flash.events flash.display flash.display flash.display flash.display flash.net flash.net flash.desktop flash.events flash.printing flash.printing flash.printing flash.net.dns flash.security flash.net.dns flash.security flash.display flash.events

Includo na verso AIR 2.5 2.5 2.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 2.0 2.0 2.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 2.0 2.0 1.0 1.0 2.0 2.0 2.0 2.0 1.0 2.0 1.0 1.0 1.0



10

Classe SecureSocket SecureSocketMonitor ServerSocket ServerSocketConnectEvent ServiceMonitor SignatureStatus SignerTrustSettings SocketMonitor SQLCollationType SQLColumnNameStyle SQLColumnSchema SQLConnection SQLError SQLErrorEvent SQLErrorOperation SQLEvent SQLIndexSchema SQLMode SQLResult SQLSchema SQLSchemaResult SQLStatement SQLTableSchema SQLTransactionLockType SQLTriggerSchema SQLUpdateEvent SQLViewSchema SRVRecord StageAspectRatio StageOrientation StageOrientationEvent StageWebView StatusFileUpdateErrorEvent StatusFileUpdateEvent

Pacote ActionScript 3.0 flash.net air.net flash.net flash.events air.net flash.security flash.security air.net flash.data flash.data flash.data flash.data flash.errors flash.events flash.errors flash.events flash.data flash.data flash.data flash.data flash.data flash.data flash.data flash.data flash.data flash.events flash.data flash.net.dns flash.display flash.display flash.events flash.media air.update.events air.update.events

Includo na verso AIR 2.0 2.0 2.0 2.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 2.0 2.0 2.0 2.0 2.5 1.5 1.5



11

Classe StatusUpdateErrorEvent StatusUpdateEvent StorageVolume StorageVolumeChangeEvent StorageVolumeInfo SystemIdleMode SystemTrayIcon UpdateEvent Updater URLFilePromise URLMonitor URLRequestDefaults XMLSignatureValidator

Pacote ActionScript 3.0 air.update.events air.update.events flash.filesystem flash.events flash.filesystem flash.desktop flash.desktop air.update.events flash.desktop air.desktop air.net flash.net flash.security

Includo na verso AIR 1.5 1.5 2.0 2.0 2.0 2.0 1.0 1.5 1.0 2.0 1.0 1.0 1.0

Classes do Flash Player com funcionalidade especfica do AIRAs classes a seguir esto disponveis para contedo do SWF em execuo no navegador, mas o AIR fornece mtodos ou propriedades adicionais:Pacote flash.desktop Classe Clipboard ClipboardFormats Propriedade, mtodo ou eventosupportsFilePromise

Includo na verso AIR 2.0 1.0 1.0 2.0 1.0

BITMAP_FORMAT FILE_LIST_FORMATFILE_PROMISE_LIST_FORMAT URL_FORMAT



12

Pacote flash.display

Classe LoaderInfo

Propriedade, mtodo ou eventochildSandboxBridge parentSandboxBridge

Includo na verso AIR 1.0 1.0 1.0 2.0 2.0 1.0 2.0 2.0 2.0 2.0 2.0 2.6 2.6 2.0 2.6 2.6 2.6

Stage

assignFocus() autoOrients deviceOrientationnativeWindow

orientation Evento orientationChange Evento orientationChanging setAspectRatiosetOrientation

softKeyboardRect supportedOrientations supportsOrientationChange NativeWindow owner listOwnedWindows NativeWindowInitOptions owner



13

Pacote flash.events

Classe Event

Propriedade, mtodo ou eventoCLOSING DISPLAYING PREPARING EXITING HTML_BOUNDS_CHANGE HTML_DOM_INITIALIZE HTML_RENDER LOCATION_CHANGE NETWORK_CHANGE STANDARD_ERROR_CLOSE STANDARD_INPUT_CLOSE STANDARD_OUTPUT_CLOSE USER_IDLE USER_PRESENT

Includo na verso AIR 1.0 1.0 2.6 1.0 1.0 1.0 1.0 1.0 1.0 2.0 2.0 2.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0

HTTPStatusEvent

HTTP_RESPONSE_STATUS responseHeaders responseURL

KeyboardEvent

commandKey controlKey



14

Pacote flash.net

Classe FileReference

Propriedade, mtodo ou eventoextension

Includo na verso AIR 1.0 1.0 1.0 1.0 1.5 1.5 1.0 1.0

Evento httpResponseStatusuploadUnencoded()

NetStream

Evento drmAuthenticate Evento onDRMContentDatapreloadEmbeddedData() resetDRMVouchers() setDRMAuthenticationCredent ials()

URLRequest

authenticate cacheResponse followRedirects idleTimeout manageCookies useCache userAgent

1.0 1.0 1.0 2.0 1.0 1.0 1.0 1.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0 2.0

URLStream flash.printing PrintJob

Evento httpResponseStatusactive copies firstPage isColor jobName lastPage maxPixelsPerInch paperArea printableArea printer printers selectPaperSize() showPageSetupDialog() start2() supportsPageSetupDialog terminate()

PrintJobOptions

pixelsPerInch printMethod



15

Pacote flash.system

Classe Capabilities LoaderContext Security

Propriedade, mtodo ou eventoidiomas allowLoadBytesCodeExecution APPLICATION

Includo na verso AIR 1.1 1.0 1.0 2.5

flash.ui

KeyLocation

D_PAD

A maioria dessas novas propriedades e mtodos esto disponveis apenas para contedo na caixa de proteo de segurana de aplicativos do AIR. No entanto, os novos membros nas classes URLRequest tambm esto disponveis para contedo em execuo em outras caixas de proteo. Os mtodos ByteArray.compress() e ByteArray.uncompress() incluem, cada um, um novo parmetro algorithm, permitindo que voc escolha entre a compactao deflate e zlib. Esse parmetro s est disponvel para contedo em execuo no AIR.

Componentes Flex especficos do AIROs seguintes componentes MX do Adobe Flex esto disponveis ao desenvolver contedo para o Adobe AIR:

FileEvent FileSystemComboBox FileSystemDataGrid FileSystemEnumerationMode FileSystemHistoryButton FileSystemList FileSystemSizeDisplayMode FileSystemTree FlexNativeMenu HTML Window WindowedApplication WindowedSystemManagerAlm disso, o Flex 4 inclui os seguintes componentes spark do AIR:

Window WindowedApplicationPara mais informaes sobre os componentes AIR Flex, consulte Using the Flex AIR components.


16

Captulo 4: Ferramentas da Plataforma Adobe Flash para desenvolvimento do AIRVoc pode desenvolver aplicativos AIR com as seguintes ferramentas de desenvolvimento da plataforma Adobe Flash. Para desenvolvedores em ActionScript 3.0 (Flash e Flex):

Adobe Flash Professional (consulte Publicaes para o AIR) Adobe Flex 3.x e 4 SDKs (consulte, Definio do SDK do Flex na pgina 18 e AIR Developer Tool (ADT) napgina 133)

Adobe Flash Builder (consulte, Desenvolvimento de Aplicativos AIR com o Flash Builder)Para desenvolvedores em HTML e Ajax:

Adobe AIR SDK (consulte, Instalao do SDK do AIR na pgina 16 e AIR Developer Tool (ADT) napgina 133)

Adobe Dreamweaver CS3, CS4, CS5 (consulte AIR Extension para Dreamweaver)

Instalao do SDK do AIRO Adobe AIR SDK contm as seguintes ferramentas de linha de comando usadas para lanar e empacotar aplicativos:AIR Debug Launcher (ADL) Permite executar aplicativos AIR sem ter que os instalar primeiro. AIR Debug Launcher

(ADL) na pgina 129AIR Development Tool (ADT) Empacota aplicativos AIR em pacotes de instalao prontos para distribuio. Consulte

AIR Developer Tool (ADT) na pgina 133. As ferramentas de linha de comando do AIR requerem Java para ser instaladas em seu computador. Voc pode usar a mquina virtual Java a partir do JRE ou do JDK (verso 1.5 ou superior). O Java JRE e o Java JDK esto disponveis em http://java.sun.com/. necessrio pelo menos 2GB de memria de computador para executar a ferramenta ADT. Nota: O Java no necessrio para os usurios finais executarem aplicativos AIR. Para obter uma viso geral sobre a criao de um aplicativo AIR com o AIR SDK, consulte Criao do seu primeiro aplicativo AIR baseado em HTML com o SDK do AIR na pgina 32.

Download e instalao do SDK do AIRVoc pode fazer download do AIR SDK e instal-lo seguindo estas instrues: Como instalar o AIR SDK no Windows Faa download do arquivo de instalao do AIR SDK

O AIR SDK distribudo como um arquivo morto de arquivos padro. Para instalar o AIR, extraia o contedo doSDK para uma pasta no seu computador (por exemplo: C:\Program Files\Adobe\AIRSDK ou C:\AIRSDK).


CONSTRUINDO APLICATIVOS NO ADOBE AIRFerramentas da Plataforma Adobe Flash para desenvolvimento do AIR

17

As ferramentas ADL e ADT esto contidas na pasta bin no AIR SDK; adicione o caminho para esta pasta a suavarivel de ambiente PATH. Como instalar o AIR SDK no Mac OS X Faa download do arquivo de instalao do AIR SDK.

O AIR SDK distribudo como um arquivo morto de arquivos padro. Para instalar o AIR, extraia o contedo doSDK para uma pasta no seu computador (por exemplo: Users//Aplicativos/AIRSDK).

As ferramentas ADL e ADT esto contidas na pasta bin no AIR SDK; adicione o caminho para esta pasta a suavarivel de ambiente PATH. Como instalar o AIR SDK no Linux O SDK est disponvel no formato tbz2.

Para instalar o SDK, crie uma pasta na qual voc deseja descompactar o SDK e, em seguida, use o seguinte comando:tar -jxvf Para obter informaes sobre como comear a utilizao das ferramentas AIR SDK, consulte Como criar um aplicativo AIR usando ferramentas de linha de comando.

O que est includo no SDK do AIRA tabela a seguir descreve o objetivo dos arquivos contidos no AIR SDK:Pasta SDK bin Descrio dos arquivos/ferramentas O AIR Debug Launcher (ADL) permite executar um aplicativo AIR sem empacot-lo e instal-lo primeiro. Para obter informaes sobre como usar esta ferramenta, consulte AIR Debug Launcher (ADL) na pgina 129. O AIR Developer Tool (ADT) empacota seu aplicativo como um arquivo AIR para distribuio. Para obter informaes sobre como usar esta ferramenta, consulte AIR Developer Tool (ADT) na pgina 133. frameworks O diretrio libs contm bibliotecas de cdigo para uso em aplicaes AIR. O diretrio projects contm o cdigo para as bibliotecas compiladas SWF e SWC. incluir O diretrio include contm o arquivo de cabealho da linguagem C para escrever extenses ActionScript (compatvel com AIR para TV). O diretrio install contm os drivers USB do Windows para dispositivos Android. (Estes so os drivers fornecidos pelo Google no Android SDK). Contm o cdigo de suporte para as ferramentas do AIR SDK.

Instalao

lib



18

Pasta SDK tempos de execuo

Descrio dos arquivos/ferramentas Os tempos de execuo AIR para desktop e para dispositivos mveis. O tempo de execuo usado pelo ADL para ativar seus aplicativos AIR antes de serem compactados ou instalados. Os tempos de execuo AIR para o Android (pacotes APK) podem ser instalados em aparelhos com Android ou emuladores para desenvolvimento e testes. Pacotes APL separados so usados para dispositivos e emuladores. (O tempo de execuo AIR pblico para o Android est disponvel no Android Market.)

amostras

Esta pasta contm uma amostra de arquivo de descrio de aplicativo, uma amostra do recurso de instalao direta (badge.swf) e os cones padro do aplicativo AIR. descriptor-template.xml - Um modelo do arquivo de descrio do aplicativo, necessrio para cada aplicativo AIR. Para obter uma descrio detalhada do arquivo de descrio do aplicativo, consulte Arquivos descritores do aplicativo do AIR na pgina 169. Os arquivos de esquema para a estrutura XML do descritor do aplicativo para cada verso do AIR tambm so encontrados nesta pasta.

modelos

Definio do SDK do FlexPara desenvolver aplicativos Adobe AIR com o Adobe Flex, voc tem as seguintes opes:

Voc pode baixar e instalar o Adobe Flash Builder, que fornece ferramentas integradas para criar projetos AdobeAIR e testar, depurar e empacotar seus aplicativos AIR. Consulte Criando seu primeiro aplicativo desktop Flex AIR no Flash Builder na pgina 20.

Voc pode baixar o Adobe Flex SDK e desenvolver aplicativos Flex AIR usando seu editor de texto e asferramentas de linha de comando favoritas. Para obter uma viso geral sobre a criao de um aplicativo AIR com o Flex SDK, consulte Criando seu primeiro aplicativo desktop do AIR com o Flex SDK na pgina 36.

Instalao do SDK do FlexA criao de aplicativos AIR com ferramentas de linha de comando requer que o Java esteja instalado no seu computador. Voc pode usar a mquina virtual Java a partir do JRE ou do JDK (verso 1.5 ou superior). O Java JRE e o Java JDK esto disponveis em http://java.sun.com/. Nota: O Java no necessrio para os usurios finais executarem aplicativos AIR. O Flex SDK oferece ferramentas de linha de comando e API do AIR que voc pode usar para empacotar, compilar e depurar seus aplicativos AIR.1 Efetue o download do Flex SDK a partir de http://opensource.adobe.com/wiki/display/flexsdk/Downloads. 2 Salve o contedo do SDK em uma pasta (por exemplo, Flex SDK). 3 Copie o contedo do AIR SDK sobre os arquivos do Flex SDK.

Nota: Em computadores Mac, no se esquea de copiar ou substituir os arquivos individuais nas pastas individuais SDK - no diretrios inteiros. Por padro, a cpia de um diretrio no Mac para um diretrio de mesmo nome remove os arquivos existentes no diretrio de destino, sem mesclar o contedo das duas pastas.4 Os utilitrios de linha de comando esto situados na pasta bin.



19

Configurao de SDKs externosO desenvolvimento de aplicaes para o Android e iOS requer que voc baixe arquivos de aprovisionamento, SDKs ou outras ferramentas de desenvolvimento dos criadores da plataforma. Para obter informaes sobre como baixar e instalar o Android SDK, consulteDesenvolvedores do Android: instalao do SDK. A partir do AIR 2.6 voc no obrigado a baixar o Android SDK. O SDK do AIR agora inclui os componentes bsicos necessrios para instalar e lanar pacotes APK. Ainda assim, o Android SDK pode ser til para uma variedade de tarefas de desenvolvimento, incluindo criao e execuo de emuladores de software. No necessrio um SDK para o desenvolvimento do IOS. Todavia, os certificados especiais e perfis de aprovisionamento so necessrios. Para obter mais informaes, consulte Obteno dos arquivos de desenvolver da Apple.


20

Captulo 5: Criando seu primeiro aplicativo do AIRCriando seu primeiro aplicativo desktop Flex AIR no Flash BuilderPara ver uma ilustrao rpida e prtica de como funciona o Adobe AIR, use estas instrues para criar e empacotar um aplicativo simples "Hello World" do AIR baseado no arquivo SWF, usando o Adobe Flash Builder. Caso ainda no o tenha feito, efetue o download e instale o Flash Builder. Alm disso, baixe e instale a verso mais recente do Adobe AIR, que est localizada aqui: www.adobe.com/go/air_br.

Crie um projeto do AIRO Flex Builder inclui ferramentas para desenvolver e empacotar aplicativos AIR. Voc comea a criar aplicativos AIR no Flash Builder ou Flex Builder da mesma forma que cria projetos de aplicativo com base no Flex: definindo um novo projeto.1 Abra o Flash Builder. 2 Selecione Arquivo > Novo > Projeto Flex. 3 Insira o nome do projeto: AIRHelloWorld. 4 No Flex, os aplicativos AIR so considerados um tipo de aplicativo. Voc tem duas opes de tipos:

um aplicativo da web que executa no Adobe Flash Player um aplicativo de computador pessoal que executa no Adobe AIRSelecione Desktop como tipo de aplicativo.5 Clique em Concluir para criar o projeto.

Os projetos do AIR consistem inicialmente em dois arquivos: o arquivo MXML principal e o arquivo XML do aplicativo (conhecido como arquivo de descrio do aplicativo). O ltimo arquivo especifica as propriedades do aplicativo. Para obter mais informaes, consulte Desenvolvimento de aplicativos do AIR com Flash Builder.

Gravao do cdigo do aplicativo AIRPara gravar o cdigo do aplicativo "Hello World", voc edita o arquivo MXML do aplicativo (AIRHelloWorld.mxml), que aberto no editor. (Se o arquivo no estiver aberto, use o Navegador de Projeto para abri-lo.) Os aplicativos Flex AIR no desktop esto contidos na tag WindowedApplication de MXML. A tag WindowedApplication de MXML cria uma janela simples que inclui controles bsicos de janela, como barra de ttulo e o boto fechar.1 Acrescente um atributo title ao componente WindowedApplication e atribua-o ao valor "Hello World":


CONSTRUINDO APLICATIVOS NO ADOBE AIRCriando seu primeiro aplicativo do AIR

21

2 Acrescente um componente Label ao aplicativo (coloque-o dentro da tag WindowedApplication), ajuste a

propriedade text do componente Label como "Hello AIR" e ajuste as restries de layout para mant-lo centrado, como mostrado abaixo:

3 Acrescente o bloco do estilo a seguir imediatamente depois de abrir a tag WindowedApplication e antes da tag de

componente de rtulo que voc acabou de inserir: @namespace s "library://ns.adobe.com/flex/spark"; s|WindowedApplication { skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin"); background-color:#999999; background-alpha:"0.7"; }

Essas configuraes de estilo se aplicam a todo o aplicativo, garantindo um plano de fundo da janela um cinza levemente transparente. O cdigo do aplicativo agora se parece com o seguinte: @namespace s "library://ns.adobe.com/flex/spark"; s|WindowedApplication { skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin"); background-color:#999999; background-alpha:"0.7"; }



22

Em seguida, voc vai alterar algumas configuraes no descritor do aplicativo para permitir que o aplicativo seja transparente:1 No painel de navegao do Flex, localize o arquivo de descrio do aplicativo no diretrio de origem do projeto. Se

voc chamou o seu projeto de AIRHelloWorld, esse arquivo se chama AIRHelloWorld-app.xml.2 Clique duas vezes no arquivo de descrio do aplicativo para edit-lo no Flash Builder. 3 No cdigo XML, localize as linhas comentadas para as propriedades systemChrome e transparent (da

propriedade initialWindow). Retire os comentrios. (Retire os delimitadores de comentrio "" delimitadores de comentrio.)4 Defina o valor de texto da propriedade systemChrome como none, como aparece a seguir:none

5 Defina o valor de texto da propriedade transparent como true, como aparece a seguir:true

6 Salve o arquivo.

Teste do aplicativo AIRPara testar o cdigo do aplicativo que voc escreveu, execute-o no modo de depurao.1 Clique no boto Depurar

na barra de ferramentas principal do

Voc tambm pode selecionar o comando Executar > Depurar > AIRHelloWorld. O aplicativo AIR resultante deve ter a aparncia do exemplo a seguir:

2 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. Nota: Se o aplicativo no for compilado, conserte a sintaxe ou os erros de digitao que voc inseriu de forma inadvertida no cdigo. Os erros e advertncias so exibidos na visualizao Problemas no Flash Builder.



23

Empacotamento, assinatura e execuo do aplicativo AIRAgora voc est pronto para empacotar o aplicativo "Hello World" em um arquivo AIR para distribuio. O arquivo AIR um arquivo de compactao que contm os arquivos do aplicativo, os quais so todos arquivos contidos na pasta bin do projeto. Neste exemplo simples, esses arquivos so os arquivos SWF e XML do aplicativo. Voc distribui o pacote do AIR aos usurios, que ento o utilizam para instalar o aplicativo. Uma etapa necessria neste processo assin-lo digitalmente.1 Garanta que o aplicativo no contenha erros de compilao e seja executado como esperado. 2 Selecione Projeto > Exportar verso da compilao. 3 Verifique se o projeto AIRHelloWorld e o aplicativo AIRHelloWorld.mxml esto listados no projeto e no

aplicativo.4 Selecione a opo Exportar como pacote assinado do AIR. Em seguida, clique em Avanar. 5 Se voc j tiver um certificado digital, clique em Procurar para localiz-lo e selecion-lo. 6 Se precisar criar um novo certificado digital autoassinado, selecione Criar. 7 Insira as informaes necessrias e clique em OK. 8 Clique em Concluir para gerar o pacote do AIR, que se chama AIRHelloWorld.air.

Agora voc pode instalar e executar o aplicativo do Navegador de Projeto no Flash Builder ou no sistema de arquivos clicando duas vezes no arquivo AIR.

Criao do seu primeiro aplicativo do AIR desktop usando o Flash ProfessionalPara ver uma demonstrao rpida e prtica de como o Adobe AIR funciona, siga as instrues neste tpico para criar e empacotar um aplicativo AIR Hello World simples utilizando o Adobe Flash Professional. www.adobe.com/go/air_br.

Criar aplicativo Hello World no FlashA criao de um aplicativo Adobe AIR no Flash semelhante criao de qualquer outro arquivo FLA. O procedimento a seguir orienta-o no processo de criao de um aplicativo Hello World simples usando o Flash Professional. Para criar o aplicativo Hello World 1 Inicie o Flash.2 Na tela de boas-vindas, clique em AIR para criar um arquivo FLA vazio com as configuraes de publicao do

Adobe AIR.3 Selecione a ferramenta Texto no painel Ferramentas e crie um campo de texto esttico (o padro) no centro do

Palco. Faa-o grande o suficiente para conter de 15 a 20 caracteres.4 Digite o texto "Hello World" no campo de texto. 5 Salve o arquivo, nomeando-o (por exemplo, HelloAIR).



24

Testar o aplicativo1 Pressione Ctrl + Enter ou selecione Controlar -> Testar filme -> Testar para testar o aplicativo no Adobe AIR. 2 Para utilizar o recurso Depurar filme, primeiro adicione o cdigo ActionScript ao aplicativo. Voc pode fazer isso

rapidamente adicionando uma instruo trace como esta:trace("Running AIR application using Debug Movie");

3 Pressione Ctrl + Shift + Enter ou selecione Depurar -> Depurar filme -> Depurar para executar o aplicativo com

Depurar filme. O aplicativo Hello World semelhante a esta ilustrao:

Empacotar o aplicativo1 Selecione Arquivo > Publicar. 2 Assine o pacote Adobe AIR com um certificado digital existentes ou cria um certificado autoassinado passando

pelas seguintes etapas:a Clique no boto Novo prximo ao campo Certificado. b Preencha as entradas para Nome do editor, Unidade organizacional, Nome da organizao, E-mail, Pas, Senha

e Confirmar senha.c Especifique o tipo de certificado. A opo Tipo de certificado refere-se ao nvel de segurana: 1024-RSA usa uma

chave de 1024 bits (menos segura) e 2048-RSA usa uma chave de 2048 bits (mais segura).d Salve as informaes em um arquivo de certificado preenchendo a entrada Salvar como ou clicando no boto

Procurar... para procurar o local da pasta. (Por exemplo, C:/Temp/mycert.pfx). Quando terminar, clique em OK.e O Flash retorna para o dilogo Assinatura digital. O caminho e o nome de arquivo do certificado auto-assinado

que voc criou so exibidos na caixa de texto Certificado. Se isso no ocorrer, digite o caminho e o nome de arquivo ou clique no boto Procurar para localiz-lo e selecion-lo.f

Insira a mesma senha do campo de texto Senha da caixa de dilogo Assinatura Digital como a senha que voc assinou na etapa "b". Para mais informaes sobre assinatura dos aplicativos Adobe AIR, consulte Assinatura digital de um arquivo AIR na pgina 155.



25

3 Para criar o arquivo do aplicativo e do programa de instalao, clique no boto Publicar. (No Flash CS4 e CS5,

clique no boto Ok.) Execute Testar filme ou Depurar filme para criar os arquivos SWF e application.xml antes de criar o arquivo AIR.4 Para instalar o aplicativo, clique duas vezes no arquivo AIR (application.air) na mesma pasta em que salvou seu

aplicativo.5 Clique no boto Instalar no dilogo Instalao do aplicativo. 6 Revise as Preferncias da instalao e as Configuraes locais e verifique se a caixa de seleo 'Iniciar aplicativo aps

a instalao' est marcada. Em seguida, clique em Continuar.7 Clique em Concluir quando a mensagem Instalao concluda for exibida.

Crie seu primeiro aplicativo do AIR para Android no Flash ProfessionalPara desenvolver aplicativos do AIR para Android, voc deve baixar a extenso do Flash Professional CS5 para o Android a partir de Adobe Labs. Voc tambm deve baixar e instalar o Android SDK no site do Android, conforme descrito em: Desenvolvedores para Android: Instalao do SDK. Criar um projeto 1 Abra o Flash Professional CS52 Crie um novo projeto do AIR para Android.

A tela inicial do Flash Professional inclui um link para criar um aplicativo do AIR para Android. Voc tambm pode selecionar Arquivo > Novo e, em seguida, selecionar o modelo AIR para Android.3 Salve o documento como HelloWorld.fla

Escreva o cdigo Como este tutorial no realmente sobre como escrever cdigo, basta usar a ferramenta de texto para escrever, "Hello, World!" no palco. Defina as propriedades do aplicativo 1 Selecione as configuraes Arquivo > AIR para Android.2 Na guia Geral, especifique as seguintes configuraes:

Arquivo de sada: HelloWorld.apk Nome do aplicativo: HelloWorld ID do aplicativo: HelloWorld Nmero da verso: 0.0.1 Proporo do aspecto: retrato3 Na guia Implantao, especifique as seguintes configuraes:

Certificado: Aponte para um certificado de assinatura por cdigo do AIR. Voc pode clicar no boto Criar paracriar um novo certificado. (Os aplicativos Android implementados atravs do Android Marketplace devem ter certificados vlidos pelo menos at o ano 2033.) Digite a senha do certificado no campo Senha.



26

Tipo de implementao do Android: depurao Aps publicao: selecione ambas as opes Digite o caminho para a ferramenta do ADB no subdiretrio de ferramentas do Android SDK.4 Fechar a caixa de dilogo das configuraes do Android clicando em OK.

O aplicativo no precisa de cones ou permisses nesta fase do desenvolvimento. A maioria dos aplicativos AIR para Android exige algumas permisses para acessar recursos protegidos. Voc s deve definir as permisses que seu aplicativo realmente exige, pois os usurios podem rejeitar seu aplicativo se ele pedir permisses demais.5 Salve o arquivo.

Compactar e instalar o aplicativo no dispositivo do Android. 1 Confira se a depurao por USB est ativada no dispositivo. Voc pode ativar a depurao por USB nas Configuraes do aplicativo em Aplicativos > Desenvolvimento.2 Conecte seu dispositivo ao computador com um cabo USB. 3 Instale o tempo de execuo do AIR. Se voc no tiver feito isso, v para o Android Market e baixe o Adobe AIR.

(Voc tambm pode instalar o AIR localmente usando o comando Comando installRuntime do ADT na pgina 143. Pacotes do Android para uso em emuladores e dispositivos Android so includos no AIR SDK).4 Selecione Arquivo > Publicar.

O Flash Professional cria o arquivo APK, instala o aplicativo no dispositivo Android conectado, e ativa-o.

Criao de seu primeiro aplicativo do AIR para iOSAIR 2.6 ou posterior, iOS 4.2 ou posterior Voc pode codificar, compilar e testar os recursos bsicos de um aplicativo do IOS usando apenas ferramentas Adobe. Contudo, para instalar um aplicativo iOS em um dispositivo e distribu-lo voc deve aderir ao programa Apple iOS Developer (que um servio pago). Depois de entrar no programa de desenvolvedor do iOS voc pode acessar o Portal de aprovisionamento do iOS onde poder obter os itens a seguir e arquivos da Apple que so necessrios para instalar um aplicativo em um dispositivo para testes e para posterior distribuio. Estes itens e arquivos incluem:

Certificados de distribuio e desenvolvimento IDs do aplicativo Arquivos de aprovisionamento de desenvolvimento e distribuioPara mais informaes, consulte Configurao do iOS na pgina 61.

Crie o contedo do aplicativoCrie um arquivo SWF que exibe o texto Hello world! Voc pode executar essa tarefa usando o Flash Professional, Flash Builder ou outro IDE. Este exemplo simplesmente usa um editor de texto e o compilador SWF de linha de comando includo no Flex SDK.1 Crie um diretrio em um local conveniente para armazenar seus arquivos de aplicativo. Crie um arquivo chamado

HelloWorld.as e edite-o no seu editor de cdigo favorito.2 Adicione o cdigo a seguir:



27

package{ import import import import flash.display.Sprite; flash.text.TextField; flash.text.TextFormat; flash.text.TextFieldAutoSize;

public class HelloWorld extends Sprite { public function HelloWorld():void { var textField:TextField = new TextField(); textField.text = "Hello World!"; textField.autoSize = TextFieldAutoSize.LEFT; var format:TextFormat = new TextFormat(); format.size = 48; textField.setTextFormat ( format ); this.addChild( textField ); } } }

3 Compile a classe usando o compilador amxmlc:amxmlc HelloWorld.as

Um arquivo SWF HelloWorld.swf criado na mesma pasta. Nota: Este exemplo assume que voc configurou a varivel de caminho do ambiente para incluir o diretrio que contm amxmlc. Para obter mais informaes sobre definio de caminho, consulte Variveis de ambiente do caminho na pgina 261. Alternativamente, voc pode digitar o caminho completo para amxmlc e para as outras ferramentas de linha de comando usadas neste exemplo.

Criar cone arte e tela inicial arte do aplicativoTodos os aplicativos para iOS tm cones que aparecem na interface de usurio do aplicativo iTunes e na tela do dispositivo.1 Crie um diretrio no diretrio de seu projeto e nomeie-o "cones". 2 Crie trs arquivos PNG no diretrio "cones". Nomeie os arquivos Icon_29.png, Icon_57.png e Icon_512.png. 3 Edite os arquivos PNG para criar a arte adequada ao seu aplicativo. Os arquivos devem ter 29 por 29 pixels, 57 por

57 pixels e 512 por 512 pixels. Neste teste, use simplesmente quadrados de cor slida como arte. Nota: Ao submeter um aplicativo Apple App Store, use a verso JPG (no a verso PNG) do arquivo com 512 pixels. Use a verso PNG ao testar as verses de desenvolvimento de um aplicativo. Todos os aplicativos para iPhone exibem uma imagem inicial quando o aplicativo carrega no iPhone. Defina a imagem inicial em um arquivo PNG:1 No diretrio principal de desenvolvimento, crie um arquivo PNG com o nome Default.png. (No coloque esse

arquivo no subdiretrio "cones": Certifique-se de nomear o arquivo Default.png com D maisculo).2 Edite o arquivo para 320 pixels de largura e 480 pixels de altura. Por enquanto, o contedo pode ser retngulo

branco liso. (Voc mudar isso mais tarde). Para informaes detalhadas sobre estes grficos, consulte cones de aplicativos na pgina 78.



28

Crie o arquivo descritor do aplicativoCrie um arquivo de descritor do aplicativo que especifique as propriedades bsicas para a aplicao. Voc pode concluir esta tarefa utilizando um IDE como o Flash Builder ou um editor de texto.1 Na pasta do projeto que contm HelloWorld.as, crie um arquivo XML chamado HelloWorld-app.xml. Edite este

arquivo no seu editor de XML favorito.2 Adicione o XML a seguir: change_to_your_id Hello World iOS 0.0.1 HelloWorld mobileDevice HelloWorld.swf Hello World! icons/AIRApp_29.png icons/AIRApp_57.png icons/AIRApp_512.png

Por razes de simplicidade, este exemplo define apenas algumas das propriedades disponveis.3 Altere a ID do aplicativo para coincidir com a ID do aplicativo especificado no Portal de Aprovisionamento do iOS.

(No inclua a parte da distribuio do conjunto aleatrio no incio da ID).4 Teste o aplicativo usando o ADL:adl HelloWorld-app.xml -screensize iPhone

O ADL deve abrir uma janela no seu desktop que exibe o texto: Hello World!Se isto no acontecer, procure por erros no cdigo-fonte e no descritor do aplicativo.

Compile o arquivo IPAAgora possvel compilar o arquivo do instalador do IPA usando o ADT. Voc deve ter o certificado de desenvolvedor da Apple e a chave privada em formato de arquivo P12, alm do perfil de aprovisionamento de desenvolvimento da Apple. Execute o utilitrio do ADT com as opes a seguir, substituindo o armazenamento de chaves, a senha do armazenamento, e os valores de perfil por aprovisionamento pelos seus prprios:adt -package -target ipa-debug -keystore iosPrivateKey.p12 -storetype pkcs12 -storepass qwerty12 -provisioning-profile ios.mobileprovision HelloWorld.ipa HelloWorld-app.xml HelloWorld.swf icons Default.png

(Utilize uma nica linha de comando; as quebras de linha neste exemplo so apenas para torn-lo mais fcil de ler.) ADT gera o arquivo de instalao do aplicativo do iOS, HelloWorld.ipa, no diretrio do projeto. A compilao do arquivo IPA pode demorar alguns minutos.



29

Instale o aplicativo em um dispositivoPara instalar o aplicativo do iOS para testes:1 Abra o aplicativo iTunes. 2 Se voc ainda no fez isso, adicione o perfil de aprovisionamento desse aplicativo ao iTunes. No iTunes, selecione

Arquivo > Adicionar Biblioteca. Selecione o arquivo de perfil de aprovisionamento (que tem mobileprovision como tipo de arquivo). Por enquanto, para testar o aplicativo em seu dispositivo de desenvolvedor, use o perfil de aprovisionamento de desenvolvimento. Mais tarde, ao distribuir o aplicativo para a iTunes Store, use o perfil de distribuio. Para distribuir o aplicativo ad-hoc (para mltiplos dispositivos sem passar pela iTunes Store), use o arquivo de aprovisionamento ad-hoc. Para obter mais informaes sobre perfis de aprovisionamento, consulte Configurao do iOS na pgina 61.3 Algumas verses do iTunes no substituem o aplicativo, se a mesma verso do aplicativo estiver instalada. Nesse

caso, exclua o aplicativo do seu dispositivo e da lista de aplicativos no iTunes.4 Clique duas vezes no arquivo IPA do aplicativo. O arquivo deve aparecer na lista de aplicativos no iTunes. 5 Conecte seu dispositivo porta USB em seu computador. 6 No iTunes, selecione a guia Aplicativos do dispositivo e certifique-se de que o aplicativo est selecionado na lista de

aplicativos para instalao.7 Selecione o dispositivo na lista esquerda do aplicativo iTunes. Em seguida, clique no boto Sync. Quando a

sincronizao terminar, o aplicativo Hello World aparecer em seu iPhone. Se a nova verso no estiver instalada, exclua-a do dispositivo e da lista de aplicativos no iTunes e, em seguida, execute novamente esse procedimento. Talvez esse seja o caso, se a verso instalada atualmente usa o mesmo ID do aplicativo e verso.

Editar o grfico da tela inicialAntes de compilar o aplicativo, voc criou o arquivo Default.png (consulte Criar cone arte e tela inicial arte do aplicativo na pgina 27). Esse arquivo PNG atua como a imagem de inicializao quando o aplicativo carregado. Quando voc testou o aplicativo em seu iPhone, talvez tenha observado a tela branca na inicializao. Altere essa imagem para coincidir com a tela de inicializao de seu aplicativo (Hello World!):1 Abra o aplicativo em seu dispositivo. Quando o primeiro texto Hello World aparecer, pressione e mantenha

pressionado o boto Incio (abaixo da tela). Mantendo pressionado o boto Incio, pressione o boto Despertar/Repousar na parte superior do iPhone). Isso executa uma captura de tela e envia-a para o rolo da cmera.2 Transfira a imagem para seu computador de desenvolvimento, transferindo as fotos do iPhoto ou de outro

aplicativo de transferncia de fotos. (No Mac OS, possvel tambm usar o aplicativo Captura de Imagem). possvel tambm enviar a foto por e-mail para seu computador de desenvolvimento:

Abra o aplicativo Fotos. Abra Rolo da cmera. Abra a imagem da captura de tela que capturou. Pressione a imagem e, em seguida, pressione o boto (seta) Avanar no canto inferior esquerdo. Em seguida,clique no boto Enviar foto por e-mail e envie a imagem para voc mesmo.3 Substitua o arquivo Default.png (no seu diretrio de desenvolvimento) pela verso PNG da imagem da captura de tela.



30

4 Compile novamente o aplicativo (consulte Compile o arquivo IPA na pgina 28) e reinstale-o em seu dispositivo.

O aplicativo usa a nova tela de inicializao ao carregar. Nota: possvel criar qualquer arte que deseja para o arquivo Default.png, desde que tenha as dimenses corretas (320 x 480 pixels). No entanto, frequentemente melhor que a imagem do arquivo Default.png coincida com o estado inicial do aplicativo.

Criao do primeiro aplicativo AIR baseado em HTML com o DreamweaverPara uma ver uma ilustrao rpida e prtica de como funciona o Adobe AIR, use essas instrues para criar e empacotar um aplicativo simples "Hello World" do AIR baseado em HTML usando o Adobe AIR Extension for Dreamweaver. www.adobe.com/go/air_br. Para obter instrues sobre a instalao do Adobe AIR Extension para Dreamweaver, consulte Instale o Adobe AIR Extension para Dreamweaver. Para obter uma viso geral da extenso, incluindo os requisitos do sistema, consulte AIR Extension para Dreamweaver. Nota: Os aplicativos do AIR baseados em HTML s podem ser desenvolvidos para os perfis desktop e extendedDesktop. Perfis tv e mvel no esto disponveis.

Preparao dos arquivos do aplicativoSeu aplicativo do AIR deve ter uma pgina inicial e todas as suas pginas relacionadas definidas em um site do Dreamweaver:1 Inicie o Dreamweaver e certifique-se de ter um site definido. 2 Abra uma nova pgina HTML selecionando Arquivo > Novo, depois HTML na coluna Tipo de pgina, em seguida

Nenhum na coluna Layout e clicando em Criar.3 Na nova pgina, digite Hello World!

Este exemplo extremamente simples, mas, se desejar, voc pode aplicar estilo ao texto ao seu gosto, adicionar mais contedo pgina, vincular outras pginas a essas pgina inicial e assim por diante.4 Salve a pgina (Arquivo > Salvar) como hello_world.html. Certifique-se de salvar o arquivo em um site

Dreamweaver. Para obter mais informaes sobre os sites Dreamweaver, consulte a Ajuda do Dreamweaver.

Criao do aplicativo Adobe AIR1 No se esquea de abrir a pgina hello_world.html na janela do documento do Dreamweaver. (Consulte a seo

anterior para obter instrues sobre sua criao.)2 Selecione Site > Configuraes do Aplicativo Air.

A maioria das configuraes exigidas na caixa de dilogo Configuraes e Aplicativo AIR so preenchidas automaticamente para voc. Voc deve, no entanto, selecionar o contedo inicial (ou a pgina inicial) do seu aplicativo.



31

3 Clique no boto Procurar perto da opo Contedo inicial, v at sua pgina hello_world.html e selecione-a. 4 Perto da opo Assinatura digital, clique no boto Definir.

A assinatura digital fornece a garantia de que o cdigo para um aplicativo no foi alterado nem est corrompido desde sua criao pelo autor do software, sendo exigido em todos os aplicativos Adobe AIR.5 Na caixa de dilogo Assinatura digital, selecione Assinar o pacote AIR com um certificado digital, e clique no boto

Criar. (Se voc j tiver acesso a um certificado digital, poder clicar no boto Procurar para selecion-lo.)6 Preencha os campos necessrios na caixa de dilogo Certificado digital autoassinado. Voc vai precisar inserir seu

nome e uma senha e depois confirm-la, e inserir um nome para o arquivo de certificado digital. O Dreamweaver salva o certificado digital na raiz do site.7 Clique em OK para voltar para a caixa de dilogo Assinatura digital. 8 Na caixa de dilogo Assinatura digital, insira a senha especificada para seu certificado digital e clique em OK.

A caixa de dilogo completa do aplicativo AIR e das configuraes do instalador talvez se paream com o seguinte:

Para obter mais informaes sobre todas as opes de caixa de dilogo e como edit-as, consulte Criao de um aplicativo AIR no Dreamweaver.9 Clique no boto Criar arquivo AIR.



32

O Dreamweaver cria o arquivo do aplicativo Adobe AIR e salva-o na pasta raiz do seu site. O Dreamweaver tambm cria um arquivo application.xml e o salva no mesmo lugar. Este arquivo serve como manifesto, definido vrias propriedades do aplicativo.

Instalao do aplicativo em um computadorAgora que voc criou o arquivo de aplicativo, poder instal-lo em qualquer computador.1 Retire o arquivo do aplicativo AIR do seu site Dreamweaver e para dentro do seu computador, ou para outro

computador. Essa etapa opcional. Voc pode, na verdade, instalar o novo aplicativo no seu computador direto do diretrio do site do Dreamweaver, se preferir.2 Clique duas vezes no arquivo executvel do aplicativo (arquivo .air) para instalar o aplicativo.

Pr-visualizao do aplicativo Adobe AIRVoc pode pr-visualizar as pginas que faro parte dos aplicativos do AIR a qualquer momento. Ou seja, voc no precisa necessariamente empacotar o aplicativo antes de ver como ele ficar depois de instalado.1 Certifique-se de que sua pgina hello_world.html est aberta na janela de documentos do Dreamweaver. 2 Na barra de ferramentas do documento, clique no boto Visualizar/depurar no navegador, e depois selecione

Visualizar no AIR. Voc tambm pode pressionar Ctrl+Shift+F12 (Windows) ou Cmd+Shift+F12 (Macintosh). Ao visualizar essa pgina, voc est vendo essencialmente o que um usurio veria como pgina inicial do aplicativo depois de ter instalado o aplicativo em um computador.

Criao do seu primeiro aplicativo AIR baseado em HTML com o SDK do AIRPara uma ver uma ilustrao rpida e prtica de como funciona o Adobe AIR, use essas instrues para criar e empacotar um aplicativo simples "Hello World" do AIR baseado em HTML. Para comear, voc deve ter instalado o tempo de execuo e configurar o SDK do AIR. Voc via usar o AIR Debug Launcher (ADL) e a AIR Developer Tool (ADT) neste tutorial. O ADL e o ADT so programas utilitrios de linha de comando e podem ser encontrados no diretrio bin do SDK do AIR (consulte Instalao do SDK do AIR na pgina 16). Este tutorial parte do princpio de que voc j est familiarizado com os programas em execuo da linha de comando e sabe como configurar as variveis do ambiente do caminho necessrio para o seu sistema operacional. Nota: Se voc for um usurio do Adobe Dreamweaver, leia Criao do primeiro aplicativo AIR baseado em HTML com o Dreamweaver na pgina 30. Nota: Os aplicativos do AIR baseados em HTML s podem ser desenvolvidos para os perfis desktop e extendedDesktop. Perfis tv e mvel no esto disponveis.



33

Criar os arquivos do projetoCada projeto do AIR baseado em HTML deve conter os dois arquivos a seguir: um arquivo descritor do aplicativo, que especifica os metadados do aplicativo, e uma pgina HTML de nvel superior. Alm disses arquivos necessrios, este projeto inclui um arquivo de cdigo em JavaScript, AIRAliases.js, que define as variveis alias para as classes API do AIR.1 Crie um diretrio chamado HelloWorld para conter os arquivos de projeto. 2 Crie um arquivo XML, chamado HelloWorld-app.xml. 3 Crie um arquivo HTML chamado HelloWorld.html. 4 Copie AIRAliases.js da pasta de estruturas do SDK do AIR no diretrio do projeto.

Criar o arquivo descritor do aplicativo AIRPara comear a desenvolver seu aplicativo AIR, crie um arquivo descritor do aplicativo XML com a seguinte estrutura:

1 Abra HelloWorld-app.xml para edio. 2 Acrescente o elemento raiz , incluindo o atributo de espao de nome do AIR:

O ltimo segmento do namespace, 2.7, especifica a verso do tempo de execuo requerida pelo aplicativo.3 Acrescente o elemento :

examples.html.HelloWorld 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 ID de aplicativo usada para instalao, acesso ao diretrio privado de armazenamento do sistema de arquivos, acesso ao armazenamento criptografado privado e comunicao entre aplicativos.4 Acrescente o elemento :

0.1 Ajuda os usurios a determinar qual verso do aplicativo eles esto instalando.5 Acrescente o elemento :

HelloWorld O nome dusado para o executvel do aplicativo, diretrio de instalao e outras referncias ao aplicativo no sistema operacional.6 Acrescente o elemento que contm os seguintes elementos filho para especificar as

propriedades da janela inicial do seu aplicativo: HelloWorld.html Identifica o arquivo HTML raiz que o AIR deve carregar. true Torna a janela visvel imediatamente.



34

400 Ajusta a largura da janela (em pixels). 200 Ajusta a altura da janela.7 Salve o arquivo. O arquivo descritor completo do aplicativo deve se parecer com o seguinte: examples.html.HelloWorld 0.1 HelloWorld HelloWorld.html true 400 200

Este exemplo s define algumas propriedades possveis do aplicativo. Para ver o conjunto completo de propriedades do aplicativo, que lhe permitem especificar coisas como cromo e tamanho da janela, transparncia, diretrio padro de instalao, tipos de arquivo associados e cones do aplicativo, consulte Arquivos descritores do aplicativo do AIR na pgina 169.

Criar a pgina HTML do aplicativoAgora voc precisa criar uma pgina HTML simples que serve como arquivo principal para o aplicativo AIR.1 Abra o arquivo HelloWorld.html para edio. Acrescente o seguinte cdigo HTML: Hello World Hello World

2 Na seo do HTML, importe o arquivo AIRAliases.js:

O AIR define uma propriedade chamada runtime no objeto da janela HTML. A propriedade de tempo de execuo fornece acesso s classes incorporadas do AIR, usando o nome do pacote totalmente qualificado da classe. Por exemplo, para criar um objeto File do AIR, voc poderia acrescentar a instruo seguinte em JavaScript:var textFile = new runtime.flash.filesystem.File("app:/textfile.txt");

O arquivo AIRAliases.js define os aliases convenientes para as APIs mais teis do AIR. Usando o AIRAliases.js, voc poderia encurtar a referncia ao arquivo File para o seguinte:var textFile = new air.File("app:/textfile.txt");

3 Abaixo da tag de script AIRAliases, acrescente outra tag de script contendo uma funo de JavaScript para lidar com

o evento onLoad:



35

function appLoad(){ air.trace("Hello World"); }

A funo appLoad() simplesmente chama a funo air.trace(). A mensagem do traado impressa no console de comando quando voc executa o aplicativo usando o ADL. As instrues de traado podem ser muito teis para depurao.4 Salve o arquivo.

Seu arquivo HelloWorld.html deve se parecer com o seguinte: Hello World function appLoad(){ air.trace("Hello World"); } Hello World

Testar o aplicativoPara executar e testar o aplicativo da linha de comando, use o utilitrio AIR Debug Launcher (ADL). O executvel ADL pode ser encontrado no diretrio bin do SDK do AIR. Se voc ainda no configurou o SDK do AIR, consulte Instalao do SDK do AIR na pgina 16.1 Abra um console ou shell de comando. Troque para o diretrio que voc criou para este projeto. 2 Execute o seguinte comando:adl HelloWorld-app.xml

aberta uma janela do AIR, exibindo seu aplicativo. Alm disso, a janela de console exibe a mensagem que resulta da chamada air.trace(). Para mais informaes, consulte Arquivos descritores do aplicativo do AIR na pgina 169.

Criar o arquivo de instalao do AIRQuando seu aplicativo executado com sucesso, voc pode usar o utilitrio ADT para empacotar o aplicativo em um arquivo de instalao do AIR. Um arquivo de instalao do AIR um arquivo de compactao que contm todos os arquivos do aplicativo, que voc pode distribuir para seus usurios. Voc deve instalar o Adobe AIR antes de instalar um arquivo AIR empacotado. Para garantir a segurana do aplicativo, todos os arquivos de instalao do AIR devem ser digitalmente assinados. Para fins de desenvolvimento, voc pode gerar um certificado bsico autoassinado com o ADT ou outra ferramenta de gerao de certificados. Tambm possvel comprar um certificado comercial com assinatura de cdigo de uma autoridade de certificado comercial como a VeriSign ou a Thawte. Quando os usurios instalam um arquivo AIR autoassinado, o editor exibido como "desconhecido" durante o processo de instalao. Isso ocorre porque um



36

certificado autoassinado s garante que o arquivo AIR no tenha sido alterado desde sua criao. No h nada que impea algum de autoassinar um arquivo AIR disfarado e apresent-lo como seu aplicativo. Para os arquivos AIR liberados ao pblico, um certificado comercial verificvel altamente recomendado. Para uma viso geral de questes de segurana do AIR, consulte Segurana 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 executvel ADT est no diretrio bin do SDK do AIR):adt certificate -cn SelfSigned 1024-RSA sampleCert.pfx samplePassword

O ADT gera um arquivo de keystore chamado sampleCert.pfx que contm um certificado e uma chave privada relacionada. Este exemplo usa o nmero mnimo de atributos que podem ser definidos para um certificado. Voc pode usar quaisquer valores para os parmetros em itlico. O tipo de chave deve ser 1024-RSA ou 2048-RSA (consulte Assinatura de aplicativos AIR na pgina 155). Criar o arquivo de instalao 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.html AIRAliases.js

Voc ter que fornecer a senha do arquivo do keystore. O argumento HelloWorld.air o arquivo AIR que o ADT produz. HelloWorld-app.xml o arquivo descritor do aplicativo. Os argumentos subsequentes so os arquivos usados pelo seu aplicativo. Esse exemplo s usa dois arquivos, mas voc pode incluir qualquer nmero de arquivos e diretrios. O ADT verifica se o principal arquivo de contedo (HelloWorld.html) est includo no pacote, mas se voc esquecer de incluir AIRAliases.js, seu aplicativo simplesmente no funcionar. Depois da criao do pacote AIR, voc pode instalar e executar o aplicativo clicando duas vezes no arquivo de pacote Voc tambm pode digitar o nome do arquivo AIR como comando em um shell ou janela de comando.

Prximas etapasNo AIR, o cdigo de HTML e JavaScript geralmente se comporta da mesma forma que se comportaria em um navegador tpico. (Na verdade, o AIR usa o mesmo mecanismo de renderizao WebKit usado pelo navegador da Web Safari.) No entanto, h algumas diferenas importantes que voc deve entender ao desenvolver aplicativos HTML no AIR. Para mais informaes sobre estas diferenas e outros tpicos importantes, consulte Programming HTML and JavaScript.

Criando seu primeiro aplicativo desktop do AIR com o Flex SDKPara obter ilustraes prticas e rpidas sobre o funcionamento do Adobe AIR, use estas instrues 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).



37

Para comear, voc deve ter instalado o tempo de execuo 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 diretrio bin do Flex SDK (consulte Definio do SDK do Flex na pgina 18).

Criar o arquivo descritor do aplicativo AIREsta seo descreve como criar o descritor do aplicativo, que um arquivo XML com a estrutura a seguir: ... ...

1 Crie um arquivo XML com o nome HelloWorld-app.xml e salve-o no diretrio do projeto. 2 Acrescente o elemento , incluindo o atributo de espao de nome do AIR:

O ltimo segmento do espao de nome, 2.7, especifica a verso do tempo de execuo de que o aplicativo necessita.3 Acrescente o elemento :

samples.flex.HelloWorld 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 seqncia de caractere separados por pontos, do tipo DNS reverso, como, por exemplo, "com.company.AppName". A ID de aplicativo usada para instalao, acesso ao diretrio privado de armazenamento do sistema de arquivos, acesso ao armazenamento criptografado privado e comunicao entre aplicativos.4 Acrescente o elemento :

1.0 Ajuda os usurios a determinar qual verso do aplicativo eles esto instalando.5 Acrescente o elemento :

HelloWorld O nome dusado para o executvel do aplicativo, diretrio de instalao e outras referncias ao aplicativo no sistema operacional.6 Acrescente o elemento que contm os seguintes elementos filho para especificar as

propriedades da janela inicial do seu aplicativo: HelloWorld.swf Identifica o arquivo HTML raiz que o AIR deve carregar. true Torna a janela visvel imediatamente. 400 Ajusta a largura da janela (em pixels). 200 Ajusta a altura da janela.7 Salve o arquivo. O arquivo descritor de aplicativo completo deve assemelhar-se ao seguinte:



38

samples.flex.HelloWorld 0.1 HelloWorld HelloWorld.swf true 400 200

Este exemplo s define algumas propriedades possveis do aplicativo. Para ver o conjunto completo de propriedades do aplicativo, que lhe permitem especificar coisas como cromo e tamanho da janela, transparncia, diretrio padro de instalao, tipos de arquivo associados e cones do aplicativo, consulte Arquivos descritores do aplicativo do AIR na pgina 169.

Gravao do cdigo do aplicativoNota: 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 criao 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 contm o arquivo principal MXML. Aplicativos desktop do AIR usam o componente WindowedApplication como elemento raiz, em vez do componente App

Air Building Apps

Documents

Transcript of Air Building Apps