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

ltima atualizao em 13/10/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 ............................................................................................... 5 ................................................................ 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

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 do AIR baseado em HTML com o Dreamweaver Criao do seu primeiro aplicativo do 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 do AIR para desktop Configurao de propriedades do aplicativo desktop Depurao de um aplicativo do AIR desktop Compactao de um instalador desktop nativo

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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Compactao de um arquivo de instalao AIR desktop.

Compactao de um conjunto de tempo de execuo cativo para computadores pessoais Distribuio de pacotes do AIR para computadores desktop

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94


CONSTRUINDO APLICATIVOS NO ADOBE AIRContedo

iv

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

Captulo 9: Como utilizar extenses nativas para Adobe AIR Arquivos de Extenso Nativa do AIR (ANE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Extenses nativas em contraste com a classe ActionScript NativeProcess Dispositivos suportados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Extenses nativas em contraste com as bibliotecas da classe ActionScript (arquivos SWC) Perfis de dispositivo suportados

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Lista de tarefas que utilizam uma extenso nativa

Indicao da extenso no arquivo de indexao do aplicativo Compactando um aplicativo que utiliza extenses nativas

Incluso do arquivo ANE no caminho da biblioteca do aplicativo

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

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 11: AIR Debug Launcher (ADL) Uso do ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Exemplos de ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Cdigos de erro e sada do ADL

Captulo 12: AIR Developer Tool (ADT) Comandos do ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 Conjuntos de opes do ADT Mensagens de erro do ADT Variveis de ambiente ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

Captulo 13: Assinatura de aplicativos AIR Assinatura digital de um arquivo AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 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 autoassinado com o ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185


CONSTRUINDO APLICATIVOS NO ADOBE AIRContedo

v

Captulo 14: Arquivos descritores do aplicativo do AIR Mudanas no descritor do aplicativo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 A estrutura do arquivo do descritor do aplicativo Elementos descritores do aplicativo do AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

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

Captulo 17: Atualizao de aplicativos AIR Sobre atualizao de aplicativos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Captulo 19: Depurao com o AIR HTML Introspector Sobre o AIR Introspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 Carregamento do cdigo do AIR Introspector Inspeo de um objeto na guia Console Configurao do AIR Introspector Interface do AIR Introspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282


1

Captulo 1: Sobre o Adobe AIRO Adobe AIR um de tempo de execuo de vrias telas e sistema multioperacional que permite potencializar suas habilidades de desenvolvimento para a Web a fim de criar e implantar aplicativos avanados da Internet (RIAs - rich Internet applications) para computadores desktop e 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 do 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 As extenses nativas do Adobe AIR fornecem APIs do ActionScript que permitem o acesso funcionalidadeespecfica da plataforma programada no cdigo nativo. As extenses nativas tambm podero permitir o acesso ao cdigo nativo legado e ao cdigo nativo que possibilita um melhor desempenho.


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 tempo de execuo do 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 do AIR) Ao instalar um aplicativo do AIR por meio de um badge de instalao de uma pgina web (tambm ser solicitadaa instalao do tempo de execuo)

Ao criar um instalador customizado que instale tanto o aplicativo quanto o tempo de execuo. necessrio obteruma aprovao do Adobe para distribuir o tempo de execuo do AIR dessa maneira. Voc poder solicitar uma aprovao na pgina Licena do tempo de execuo do Adobe. Observe que o Adobe no fornece ferramentas para criar tal instalador. No entanto, muitos kits de ferramenta de instalador terceirizado esto disponveis.

Ao instalar um aplicativo do AIR que cria um conjunto do AIR como um tempo de execuo cativo. Um tempo deexecuo cativo usado somente pelo aplicativo que cria o conjunto. Ele no usado para executar outros aplicativos do AIR. Criar um conjunto do tempo de execuo uma opo no Android, no Mac e no Windows. No iOS, todos os aplicativos incluem um tempo de execuo em conjunto.

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.

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.


CONSTRUINDO APLICATIVOS NO ADOBE AIRInstalao do Adobe AIR

4

Instalao do tempo de execuo em um computador com Linux Nota: Atualmente, o AIR 2.7 e verses posteriores no so compatveis com Linux. Os aplicativos do AIR implementados para Linux devero continuar usando o AIR 2.6 SDK. Utilizando o instalador binrio:1 Localize o arquivo binrio de instalao em http://kb2.adobe.com/cps/853/cpsid_85304.html e faa o download. 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

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 Localize o arquivo de pacote do AIR em http://kb2.adobe.com/cps/853/cpsid_85304.html. Faa download do

pacote rpm ou Debian, dependendo do formato de pacote suportado pelo 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 159 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.



5

Mais tpicos da AjudaAIR para iOS na pgina 69

Remoo do Adobe AIRAps instalar o tempo de execuo, voc poder remov-lo usando os seguintes procedimentos. 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 160 para obter mais informaes. Remoo de um tempo de execuo em conjunto Para remover um tempo de execuo em conjunto, necessrio remover o aplicativo com o qual ele est instalado. Observe que os tempos de execuo cativos so usados so mente para executar o aplicativo de instalao.

Instalao e execuo de aplicativos de amostra do AIRPara instalar ou atualizar um aplicativo do 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.



6

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. 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 do 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 do AIR SettingsManager. O aplicativo do 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. Atualizao dos tempos de execuo cativos Se voc distribuir o aplicativo com um conjunto de tempo de execuo cativo, o tempo de execuo cativo no ser atualizado automaticamente. Para a segurana dos usurios, necessrio monitorar as atualizaes publicadas pela Adobe e atualizar o aplicativo com a nova verso do tempo de execuo quando uma alterao de segurana importante for publicada.


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 do 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 ARecord AAAARecord ApplicationUpdater ApplicationUpdaterUI AudioPlaybackMode AutoCapitalize BrowserInvokeEvent CameraPosition CameraRoll CameraRollBrowseOptions

Pacote ActionScript 3.0 flash.net.dns flash.net.dns air.update air.update flash.media flash.text flash.events flash.media flash.media flash.media

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


CONSTRUINDO APLICATIVOS NO ADOBE AIRTrabalhando com APIs do AIR

8

Classe CameraUI CertificateStatus CompressionAlgorithm DatagramSocket DatagramSocketDataEvent DNSResolver DatagramSocketDataEvent DockIcon DownloadErrorEvent DRMAuthenticateEvent DRMDeviceGroup DRMDeviceGroupErrorEvent DRMDeviceGroupEvent DRMManagerError EncryptedLocalStore ExtensionContext File FileListEvent FileMode FileStream FocusDirection GameInput GameInputControl GameInputControlType GameInputDevice GameInputEvent GameInputFinger GameInputHand Geolocation DatagramSocketDataEvent HTMLHistoryItem HTMLHost HTMLLoader HTMLPDFCapability

Pacote ActionScript 3.0 flash.media flash.security flash.utils flash.net flash.events flash.net.dns flash.events flash.desktop air.update.events flash.events flash.net.drm flash.net.drm flash.net.drm flash.errors flash.data flash.external flash.filesystem flash.events flash.filesystem flash.filesystem flash.display flash.ui flash.ui flash.ui flash.ui flash.ui flash.ui flash.ui flash.sensors flash.events flash.html flash.html flash.html flash.html

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



9

Classe HTMLSWFCapabiltiy HTMLUncaughtScriptExceptionEvent HTMLWindowCreateOptions Icon IFilePromise ImageDecodingPolicy InteractiveIcon InterfaceAddress InvokeEvent InvokeEventReason IPVersion IURIDereferencer LocationChangeEvent MediaEvent MediaPromise MediaType MXRecord NativeApplication NativeDragActions NativeDragEvent NativeDragManager NativeDragOptions NativeMenu NativeMenuItem NativeProcess NativeProcessExitEvent NativeProcessStartupInfo NativeWindow NativeWindowBoundsEvent NativeWindowDisplayState NativeWindowDisplayStateEvent NativeWindowInitOptions NativeWindowRenderMode NativeWindowResize

Pacote ActionScript 3.0 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 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

Includo na verso AIR 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 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 3.0 1.0



10

Classe NativeWindowSystemChrome NativeWindowType NetworkInfo NetworkInterface NotificationType OutputProgressEvent PaperSize PrintMethod PrintUIOptions MXRecord ReferencesValidationSetting ResourceRecord RevocationCheckSettings Screen ScreenMouseEvent SecureSocket SecureSocketMonitor ServerSocket ServerSocketConnectEvent ServiceMonitor SignatureStatus SignerTrustSettings SocketMonitor SoftKeyboardType SQLCollationType SQLColumnNameStyle SQLColumnSchema SQLConnection SQLError SQLErrorEvent SQLErrorOperation SQLEvent SQLIndexSchema SQLMode

Pacote ActionScript 3.0 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 flash.net air.net flash.net flash.events air.net flash.security flash.security air.net flash.text flash.data flash.data flash.data flash.data flash.errors flash.events flash.errors flash.events flash.data flash.data

Includo na verso AIR 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 2.0 2.0 2.0 2.0 1.0 1.0 1.0 1.0 3.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0



11

Classe SQLResult SQLSchema SQLSchemaResult SQLStatement SQLTableSchema SQLTransactionLockType SQLTriggerSchema SQLUpdateEvent SQLViewSchema SRVRecord StageAspectRatio StageOrientation StageOrientationEvent StageText StageTextInitOptions StageWebView StatusFileUpdateErrorEvent StatusFileUpdateEvent StatusUpdateErrorEvent StatusUpdateEvent StorageVolume StorageVolumeChangeEvent StorageVolumeInfo SystemIdleMode SystemTrayIcon TouchEventIntent UpdateEvent Updater URLFilePromise URLMonitor URLRequestDefaults XMLSignatureValidator

Pacote ActionScript 3.0 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.text flash.text flash.media air.update.events air.update.events air.update.events air.update.events flash.filesystem flash.events flash.filesystem flash.desktop flash.desktop flash.events air.update.events flash.desktop air.desktop air.net flash.net flash.security

Includo na verso AIR 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 3.0 3.0 2.5 1.5 1.5 1.5 1.5 2.0 2.0 2.0 2.0 1.0 3.0 1.5 1.0 2.0 1.0 1.0 1.0



12

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

BITMAP_FORMAT FILE_LIST_FORMATFILE_PROMISE_LIST_FORMAT URL_FORMAT

flash.display

LoaderInfo

childSandboxBridge parentSandboxBridge

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 149)

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 149)

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 144AIR Development Tool (ADT) Empacota aplicativos AIR em pacotes de instalao prontos para distribuio. Consulte

AIR Developer Tool (ADT) na pgina 149. 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 do AIR com o AIR SDK, consulte Criao do seu primeiro aplicativo do 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 do 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 do AIR sem empacotlo e instal-lo primeiro. Para obter informaes sobre como usar esta ferramenta, consulte AIR Debug Launcher (ADL) na pgina 144. 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 149. 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 incluso contm o arquivo de cabealho da linguagem C- para escrever extenses nativas. 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 do AIR. descriptor-template.xml - Um modelo do arquivo de descrio do aplicativo, necessrio para cada aplicativo do AIR. Para obter uma descrio detalhada do arquivo de descrio do aplicativo, consulte Arquivos descritores do aplicativo do AIR na pgina 186. 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 do 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. Voc pode usar o comando ditto em uma janela de terminal para mesclar o AIR SDK no Flex SDK:ditto air_sdk_folderflex_sdk_folder



19

4 Os utilitrios de linha de comando do AIR esto localizados na pasta bin.

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. Alm disso, o Android SDK pode ser til para uma variedade de tarefas de desenvolvimento, incluindo a criao e a execuo de emuladores de software e de dispositivos para captura de tela. 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 do 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 do 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 do 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 do 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 do AIR Hello World simples utilizando o Adobe Flash Professional. Caso ainda no tenha feito isso, baixe e instale o Adobe AIR, que est localizado aqui: 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 autoassinado

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



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

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



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. Nota: Se voc estiver utilizando o AIR 2 ou anterior, dever utilizar o elemento em vez do elemento .3 Altere o ID do aplicativo para coincidir com o ID do aplicativo especificado no Portal de Aprovisionamento do iOS.

(No inclua a parte da distribuio do conjunto aleatrio no incio do 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.)



29

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.

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



30

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. 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 do 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. Caso ainda no tenha feito isso, baixe e instale o Adobe AIR, que est localizado aqui: 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 do AIR.



31

A maioria das configuraes exigidas na caixa de dilogo Configuraes e aplicativo do AIR so preenchidas automaticamente para voc. Voc deve, no entanto, selecionar o contedo inicial (ou a pgina inicial) do seu aplicativo.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 do AIR e das configuraes do instalador talvez se paream com o seguinte:



32

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

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 do 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 do 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 do 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 do AIRPara comear a desenvolver seu aplicativo do 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 o ID de editor (que o AIR cria do certificado usado para assinar o pacote do aplicativo). O 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. Nota: Se voc estiver utilizando o AIR 2 ou anterior, dever utilizar o elemento em vez do elemento.

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:



34

HelloWorld.html 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 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 186.

Criar a pgina HTML do aplicativoAgora voc precisa criar uma pgina HTML simples que serve como arquivo principal para o aplicativo do 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 186.

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. O tipo de chave deve ser 1024-RSA ou 2048-RSA (consulte Assinatura de aplicativos AIR na pgina 172). 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 arg

Download - Air Building Apps

Top Related