Configuração de propriedades do aplicativo desktop

Especifique a versão do runtime do AIR exigido pelo seu aplicativo usando o namespace do arquivo do descritor do aplicativo.

O namespace, atribuído no elemento do aplicativo , determina, em grande parte, que recursos seu aplicativo pode usar. Por exemplo, se seu aplicativo usa o namespace AIR 1.5, e o usuário tem o AIR 3.0 instalado, seu aplicativo vê o comportamento do AIR 1.5 (mesmo que o comportamento tenha sido alterado no AIR 3.0). Somente quando mudar o namespace e publicar uma atualização sua aplicação terá acesso ao novo comportamento e recursos. Alterações de segurança e WebKit são as principais exceções a esta política.

Especifique o namespace usando o atributo xmlns do elemento do application raiz:

<application xmlns="http://ns.adobe.com/air/application/3.0">

Diversas configurações devem ser exclusivas para cada aplicativo que você publicar. As configurações exclusivas incluem o ID, o nome e o nome do arquivo.

<id>com.example.MyApplication</id> 
<name>My Application</name> 
<filename>MyApplication</filename>

Nas versões AIR anteriores ao AIR 2.5, especifique o aplicativo no elemento version . Você pode usar qualquer sequência de caracteres. O runtime do AIR não interpreta a sequência de caracteres; "2.0" não é tratado como uma versão maior de "1.0".

<!-- AIR 2 or earlier --> 
<version>1.23 Beta 7</version>

No AIR 2.5 e posterior, especifique a versão do aplicativo no elemento versionNumber . O elemento version não pode mais ser usado. Ao especificar um valor para versionNumber, você deve usar uma sequência de até três números separados por pontos, como: "0.1.2". Cada segmento do número de versão pode ter até três dígitos. (Em outras palavras, "999.999.999" é o maior número de versão autorizada.) Você não precisa incluir todos os três segmentos do número; "1" e "1.0" são números de versão legal.

Você também pode especificar um rótulo para a versão com o elemento versionLabel . Ao adicionar um rótulo de versão, este é exibido em vez do número da versão em lugares como as caixas de diálogo do instalador dos aplicativos do AIR.

<!-- AIR 2.5 and later --> 
<versionNumber>1.23.7<versionNumber> 
<versionLabel>1.23 Beta 7</versionLabel>

Quando o AIR inicia um aplicativo no desktop, cria uma janela e carrega o arquivo SWF principal ou a página HTML neste. O AIR usa os elementos filho do elemento initialWindow que controla a aparência inicial e comportamento da janela inicial do aplicativo.

• content - O arquivo SWF do aplicativo principal no filho content do elemento initalWindow . Ao direcionar dispositivos no perfil de desktop, você pode usar um arquivo SWF ou HTML.

  <initialWindow> 
      <content>MyApplication.swf</content> 
  </initialWindow>

  Você deve incluir o arquivo no pacote AIR (usando ADT ou sua IDE). Simplesmente fazer referência do nome no descritor do aplicativo não faz com que o arquivo seja incluído no pacote de maneira automática.

• depthAndStencil — Especifica o uso do buffer de profundidade ou de estêncil. Normalmente, você usa esses buffers ao trabalhar com conteúdo 3D.

  <depthAndStencil>true</depthAndStencil>

• height — A altura da janela inicial.

• maximizable — Se o cromo do sistema para maximizar a janela for exibido.

• maxSize — O tamanho máximo permitido.

• minimizable — Se o cromo do sistema para minimizar a janela for exibido.

• minSize — O tamanho mínimo permitido.

• renderMode — No AIR 3 ou posterior, o modo de renderização deverá ser definido como auto , cpu , direct ou gpu para os aplicativos de desktop. Em versões anteriores do AIR, essa configuração é ignorada nas plataformas de desktop. A configuração renderMode não pode ser alterada no runtime.

  • auto — basicamente o mesmo que o modo da cpu.

  • cpu — exibe objetos que são renderizados e copiados para exibir a memória no software. StageVideo está disponível somente quando uma janela está no modo tela cheia. Stage3D utiliza o renderizador de software.

  • direct — exibe objetos que são renderizados pelo software do runtime, mas a cópia de quadro renderizado para exibir a memória (blitting) é acelerada pelo hardware. StageVideo está disponível. Stage3D utiliza a aceleração de hardware, caso seja possível. Caso uma transparência de janela seja definida como true, então a janela "retrocederá" a renderização e o blitting do software.

    Nota: Para aproveitar a aceleração GPU do conteúdo Flash com o AIR para plataformas móveis, o Adobe recomenda que você use renderMode="direct", o Stage3D e não o renderMode="gpu". A Adobe oferece suporte e recomenda oficialmente as seguintes estruturas baseadas em Stage3D: Starling (2D) e Away3D (3D). Para obter mais detalhes do Stage3D e do Starling/Away3D (3D), consulte http://gaming.adobe.com/getstarted .

  • gpu — a aceleração por hardware é usada, se disponível.

• requestedDisplayResolution — Se o seu aplicativo tiver que usar o modo de resolução standard ou high em computadores MacBook Pro com telas de alta resolução. Em todas as outras plataformas o valor é ignorado. Se o valor é standard , cada pixel do palco é renderizado como quatro pixels na tela. Se o valor é high , cada pixel do palco corresponde a um único pixel físico na tela. O valor especificado é usado para todas as janelas do aplicativo. O uso do elemento requestedDisplayResolution para aplicativos de desktop AIR (como um filho do elemento intialWindow ) está disponível no AIR 3.6 e posterior.

• resizable — Se o cromo do sistema para redimensionar a janela for exibido.

• systemChrome — Se o adorno da janela do sistema operacional padrão for usado. A configuração do systemChrome de uma janela não pode ser alterada em runtime.

• title — O título da janela.

• transparent — Se a janela for de mesclagem de alfa em relação ao plano de fundo. A janela não pode usar o cromo do sistema se a transparência estiver ativada. A configuração transparent de uma janela não pode ser alterada em runtime.

• visible - Se a janela fica visível assim que é criada. A janela não fica visível por padrão inicialmente para que o aplicativo possa chamar seu conteúdo antes de se tornar visível.

• width — A largura da janela.

• x — A posição horizontal da janela.

• y — A posição vertical da janela.

Os elementos a seguir controlam os recursos de instalação e atualização do desktop.

• customUpdateUI — Permite que você forneça suas próprias caixas de diálogo para atualizar um aplicativo. Se configurado para false o padrão, as caixas de diálogo padrão do AIR são usadas.

• fileTypes — Especifica os tipos de arquivos que seu aplicativo gostaria de registrar como o aplicativo de abertura padrão. Se outro aplicativo já for o padrão para abertura de um tipo de arquivo, o AIR não substitui o registro existente. Contudo, seu aplicativo pode substituir o registro em runtime usando o método setAsDefaultApplication() do objeto NativeApplication. É uma boa forma de pedir a permissão do usuário antes de substituir suas associações do tipo de arquivo existente.

  Nota: O registro do tipo de arquivo é ignorado ao fazer a compactação de um aplicativo como um conjunto de runtime cativo (usando o destino -bundle ). Para registrar um determinado tipo de arquivo, é necessário criar um programa de instalador que realize o registro.

• installFolder — Especifica um caminho relativo para a pasta padrão de instalação de aplicativos em que o aplicativo é instalado. Você pode usar esta configuração para fornecer um nome de pasta personalizada, bem como agrupar vários aplicativos dentro de uma pasta comum.

• programMenuFolder — Especifica a hierarquia do menu para o menu Todos os programas do Windows. Você pode usar esta definição para agrupar vários aplicativos em um menu comum. Se nenhuma pasta do menu for especificada o atalho do aplicativo é adicionado diretamente ao menu principal.

Se seu aplicativo só faz sentido no desktop, você pode evitar que ele seja instalado em dispositivos em outro perfil, excluindo esse perfil da lista de perfis disponíveis. Caso o aplicativo utilize a classe NativeProcess ou extensões nativas, então será necessário suportar o perfil extendedDesktop .

Se você deixar o elemento supportedProfile fora do descritor do aplicativo, este presume que seu aplicativo dá suporte para todos os perfis definidos. Para restringir seu aplicativo a uma lista específica de perfis, liste os perfis, separados por espaços em branco:

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

Para uma lista de classes ActionScript disponíveis nos perfis desktop e extendedDesktop , consulte Capacidades de perfis diferentes .

Os aplicativos compatíveis com o perfil extendedDesktop podem usar extensões nativas.

Indique todas as extensões nativas que o aplicativo do AIR utiliza no descritor do aplicativo. O seguinte exemplo ilustra a sintaxe para especificar duas extensões nativas necessárias:

<extensions> 
     <extensionID>com.example.extendedFeature</extensionID> 
    <extensionID>com.example.anotherFeature</extensionID> 
</extensions>

O elemento extensionID tem o mesmo valor que o elemento id no arquivo descritor de extensão. O arquivo descritor da extensão é um arquivo XML chamado extension.xml. Ela está compactada no arquivo ANE recebido do desenvolvedor da extensão nativa.

No desktop, os ícones especificados no descritor do aplicativo são usados como ícones do menu do programa, atalhos e arquivo do aplicativo. O ícone do aplicativo deve ser fornecido como um conjunto de imagens PNG de 16x16, 32x32, 48x48 e 128x128 pixels. Especifique o caminho para os arquivos de ícone no elemento ícone do arquivo descritor do aplicativo:

<icon> 
    <image16x16>assets/icon16.png</image16x16> 
    <image32x32>assets/icon32.png</image32x32> 
    <image48x48>assets/icon48.png</image48x48> 
    <image128x128>assets/icon128.png</image128x128> 
</icon> 

Se você não fornecer um ícone de determinado tamanho, o maior tamanho seguinte é utilizado e adaptado para se ajustar. Se você não fornecer nenhum ícone, um ícone do sistema padrão será usado.

Aplicativos no desktop ignoram as configurações do aplicativo que se aplicam a recursos de perfil móvel. As configurações ignoradas são:

• android

• aspectRatio

• autoOrients

• fullScreen

• iPhone

• renderMode (anterior ao AIR 3)

• requestedDisplayResolution

• softKeyboardBehavior