Elementos descritores do aplicativo do AIR

Permite que a API no navegador AIR detecte e ative o aplicativo.

Se você definiu esse valor como true , certifique-se de considerar implicações de segurança. Elas são descritas em Invocação de um aplicativo do AIR do navegador (para desenvolvedores em ActionScript) ou em Invoking an AIR application from the browser (para desenvolvedores em HTML).

Para obter mais informações, consulte Inicialização de um aplicativo do AIR instalado do navegador .

Elemento pai: application

Elementos filho: nenhum

<allowBrowserInvocation>true</allowBrowserInvocation>

Permite adicionar elementos ao arquivo de manifesto do Android. O AIR cria o arquivo AndroidManifest.xml para cada pacote APK. Você pode usar o elemento android no descritor do aplicativo do AIR para adicionar outros itens adicionais a este. Ignorado em todas as plataformas, exceto no Android.

Elemento pai: application

Elementos filho:

• colorDepth

• manifestAdditions

<android> 
    <manifestAdditions> 
        ... 
    </manifestAdditions> 
</android>

O elemento raiz de um documento de descrição do aplicativo do AIR.

Elementos pai: nenhum

Elementos filho:

• allowBrowserInvocation

• android

• copyright

• customUpdateUI

• description

• extensions

• filename

• fileTypes

• icon

• id

• initialWindow

• installFolder

• iPhone

• name

• programMenuFolder

• publisherID

• supportedLanguages

• supportedProfiles

• version

• versionLabel

• versionNumber

xmlns="http://ns.adobe.com/air/application/1.0" 
xmlns="http://ns.adobe.com/air/application/1.1" 
xmlns="http://ns.adobe.com/air/application/1.5" 
xmlns="http://ns.adobe.com/air/application/1.5.2" 
xmlns="http://ns.adobe.com/air/application/1.5.3" 
xmlns="http://ns.adobe.com/air/application/2.0" 
xmlns="http://ns.adobe.com/air/application/2.5" 
xmlns="http://ns.adobe.com/air/application/2.6" 
xmlns="http://ns.adobe.com/air/application/2.7" 
xmlns="http://ns.adobe.com/air/application/3.0" 
xmlns="http://ns.adobe.com/air/application/3.1" 
xmlns="http://ns.adobe.com/air/application/3.2" 
xmlns="http://ns.adobe.com/air/application/3,3" 
xmlns="http://ns.adobe.com/air/application/3.4" 
xmlns="http://ns.adobe.com/air/application/3.5" 
xmlns="http://ns.adobe.com/air/application/3.6" 
xmlns="http://ns.adobe.com/air/application/3.7"

<?xml version="1.0" encoding="utf-8" ?> 
<application xmlns="http://ns.adobe.com/air/application/3.0"> 
    <id>HelloWorld</id> 
    <version>2.0</version> 
    <filename>Hello World</filename> 
    <name>Example Co. AIR Hello World</name> 
     <description> 
        <text xml:lang="en">This is an example.</text> 
        <text xml:lang="fr">C'est un exemple.</text> 
        <text xml:lang="es">Esto es un ejemplo.</text> 
    </description> 
    <copyright>Copyright (c) 2010 Example Co.</copyright> 
    <initialWindow> 
        <title>Hello World</title> 
        <content> 
            HelloWorld.swf 
        </content> 
        <systemChrome>none</systemChrome> 
        <transparent>true</transparent> 
        <visible>true</visible> 
        <minSize>320 240</minSize> 
    </initialWindow>  
    <installFolder>Example Co/Hello World</installFolder> 
    <programMenuFolder>Example Co</programMenuFolder> 
    <icon> 
        <image16x16>icons/smallIcon.png</image16x16> 
        <image32x32>icons/mediumIcon.png</image32x32> 
        <image48x48>icons/bigIcon.png</image48x48> 
        <image128x128>icons/biggestIcon.png</image128x128>  
    </icon> 
    <customUpdateUI>true</customUpdateUI> 
    <allowBrowserInvocation>false</allowBrowserInvocation> 
    <fileTypes> 
        <fileType> 
            <name>adobe.VideoFile</name> 
            <extension>avf</extension> 
            <description>Adobe Video File</description> 
            <contentType>application/vnd.adobe.video-file</contentType> 
            <icon> 
                <image16x16>icons/avfIcon_16.png</image16x16> 
                <image32x32>icons/avfIcon_32.png</image32x32> 
                <image48x48>icons/avfIcon_48.png</image48x48> 
                <image128x128>icons/avfIcon_128.png</image128x128> 
            </icon> 
        </fileType> 
    </fileTypes> 
</application>

Especifica a taxa de proporção do aplicativo.

Se não for especificado, o aplicativo abrirá com a proporção “natural” e com a orientação do dispositivo. A orientação natural varia de dispositivo para dispositivo. Geralmente, é a proporção retrato em dispositivos de tela pequena tais como telefones. Em alguns dispositivos, como o tablete iPad, o aplicativo se abre na orientação atual. No AIR 3.3 e superior, isso se aplica a todo o aplicativo, não apenas à exibição inicial.

Elemento pai: initialWindow

Elementos filho: nenhum

<aspectRatio>landscape</aspectRatio>

Especifica se a orientação do conteúdo no aplicativo reorienta automaticamente quando o próprio dispositivo altera a orientação física. Para obter mais informações, consulte Orientação do palco .

Ao usar auto-orientação, considere a configuração das propriedades align e scaleMode do Palco para o seguinte:

stage.align = StageAlign.TOP_LEFT; 
stage.scaleMode = StageScaleMode.NO_SCALE;

Essas configurações permitem que o aplicativo gire em torno dos cantos superior e esquerdo e impedem que o conteúdo do seu aplicativo seja escalado automaticamente. Embora os outros modos de escala façam ajustes no conteúdo para adaptarem-se às dimensões do palco submetido à rotação, eles também recortam, distorcem ou comprimem excessivamente esse conteúdo. Melhores resultados quase sempre podem ser obtidos quando você mesmo redesenha ou retransmite o conteúdo.

Elemento pai: initialWindow

Elementos filho: nenhum

<autoOrients>true</autoOrients>

Especifica a utilização da cor de 16 bits ou de 32 bits.

A utilização da cor de 16 bits pode aumentar o desempenho de renderização, mas em detrimento da fidelidade de cor. Antes do AIR 3, a cor de 16 bits foi sempre usada no Android. No AIR 3, a cor de 32 bits é usada por padrão.

Elemento pai: android

Elementos filho: nenhum

<android> 
    <colorDepth>16bit</colorDepth> 
    <manifestAdditions>...</manifestAdditions> 
</android>

Especifica se o aplicativo terá ou não um conteúdo de vídeo.

Elemento pai: android

Elementos filho: nenhum

<android> 
    <containsVideo>true</containsVideo> 
    <manifestAdditions>...</manifestAdditions> 
</android>

O valor especificado para o elemento content é o URL para o arquivo principal de conteúdo do aplicativo. Isso pode ser um arquivo SWF ou HTML. O URL é especificado em relação à raiz da pasta de instalação do aplicativo. (Ao executar um aplicativo do AIR com o ADL, o URL é relativo à pasta que contém o arquivo de descritor do aplicativo. Você pode usar o parâmetro root-dir do ADL para especificar um diretório de raiz diferente.)

Elemento pai: initialWindow

Elementos filho: nenhum

<content>TravelPlanner.swf</content>

O contentType é exigido no AIR 1.5 (ele era opcional no AIR 1.0 e 1.1). A propriedade ajuda alguns sistemas operacionais a localizarem o melhor aplicativo para abrir um arquivo. O valor deve ser o tipo MIME do conteúdo do arquivo. Observe que o valor será ignorado no Linux se o tipo de arquivo já estiver registrado e tiver um tipo MIME atribuído.

Elemento pai: fileType

Elementos filho: nenhum

<contentType>text/plain</contentType>

As informações de copyright para o aplicativo do AIR. No Mac OS, o texto de copyright é exibido na caixa de diálogo Sobre para o aplicativo instalado. No Mac OS, as informações de copyright também são usadas no campo NSHumanReadableCopyright no arquivo Info.plist para o aplicativo.

Elemento pai: application

Elementos filho: nenhum

<copyright>© 2010, Examples, Inc.All rights reserved.</copyright>

Indica se um aplicativo fornecerá seus próprios diálogos de atualização. Se definido como false , o AIR apresenta os diálogos de atualização padrão para o usuário. Somente os aplicativos distribuídos como arquivos AIR podem usar o sistema incorporado de atualização do AIR.

Quando a versão instalada do aplicativo tiver o elemento customUpdateUI configurado para true e, em seguida, o usuário clicar duas vezes no arquivo AIR para obter uma nova versão ou instalar uma atualização do aplicativo usando o recurso de instalação contínua, o runtime abre a versão instalada do aplicativo. O runtime não abre o instalador do aplicativo padrão do AIR. A lógica do seu aplicativo pode então determinar como proceder com a operação de atualização. (O ID do aplicativo e o ID do editor no arquivo AIR devem corresponder aos valores no aplicativo instalado para que uma atualização prossiga.)

Para obter mais informações, consulte Atualização de aplicativos do AIR .

Elemento pai: application

Elementos filho: nenhum

<customUpdateUI>true</customUpdateUI>

Indica que o aplicativo exige o uso do buffer de profundidade ou de estêncil. Normalmente, você usa esses buffers ao trabalhar com conteúdo 3D. Por padrão, o valor desse elemento é false para desativar os buffers de profundidade e de estêncil. Esse elemento é necessário, pois os buffers devem ser alocados ao inicializar o aplicativo, antes de carregar qualquer conteúdo.

A configuração desse elemento deve corresponder ao valor passado para o argumento enableDepthAndStencil para o método Context3D.configureBackBuffer() . Se os valores não corresponderem, o AIR emite um erro.

Esse elemento é aplicável somente quando renderMode = direct . Se renderMode não equivaler a direct , o ADT emite o erro 118:

<depthAndStencil> element unexpected for render mode cpu.  It requires "direct" render mode.

Elemento pai: initialWindow

Elementos filho: nenhum

<depthAndStencil>true</depthAndStencil>

A descrição do aplicativo, exibida no instalador do aplicativo do AIR.

Se você especificar um único nó de texto (e não vários elementos text), o instalador do aplicativo do AIR usará essa descrição, independentemente do idioma do sistema. Caso contrário, o instalador do aplicativo do AIR usa a descrição que mais se aproxima do idioma da interface do usuário do sistema operacional do usuário. Por exemplo, considere uma instalação na qual o elemento description do arquivo do descritor do aplicativo inclui um valor para o local en (inglês). O instalador do aplicativo do AIR usará a descrição en se o sistema do usuário identificar en (inglês) como o idioma da interface do usuário. Ele também usa a descrição en se o idioma da interface do usuário do sistema for en-US (inglês norte-americano). No entanto, se o idioma da interface do usuário do sistema é en-US e o arquivo do descritor do aplicativo define os nomes en-US e en-GB, o instalador do aplicativo do AIR usa o valor en-US. Se o aplicativo não define nenhuma descrição que corresponda ao idioma da interface do usuário do sistema, o instalador do aplicativo do AIR usa o primeiro valor description definido no arquivo do descritor do aplicativo.

Para obter mais informações sobre o desenvolvimento de aplicativos com vários idiomas, consulte Localização de aplicativos AIR .

Elemento pai: application

Elementos filho: text

<description>This is a sample AIR application.</description> 

<description> 
    <text xml:lang="en">This is an example.</text> 
    <text xml:lang="fr">C'est un exemple.</text> 
    <text xml:lang="es">Esto es un ejemplo.</text> 
</description> 

A descrição do tipo de arquivo é exibida para o usuário pelo sistema operacional. A descrição do tipo de arquivo não é traduzida.

Consulte também: description como filho do elemento do aplicativo

Elemento pai: fileType

Elementos filho: nenhum

<description>PNG image</description>

Permite que você use fontes personalizadas no StageText no aplicativo do AIR. Esse elemento é opcional.

Elemento pai: application

Elementos filho: fonte

<embedFonts> 
   <font> 
      <fontPath>ttf/space age.ttf</fontPath>
      <fontName>space age</fontName> 
   </font>
   <font> 
      <fontPath>ttf/xminus.ttf</fontPath>
      <fontName>xminus</fontName> 
   </font>
</embedFonts>

O iOS usa propriedades chamadas entitlements para fornecer o acesso do aplicativo a recursos adicionais. Use o elemento Entitlements para especificar esta informação em um aplicativo iOS móvel.

Elemento pai: iPhone

Elementos filho: Elementos iOS Entitlements.plist

<iphone> 
... 
   <Entitlements> 
      <![CDATA[ 
         <key>aps-environment</key> 
         <string>development</string> 
      ]]> 
   </Entitlements> 
</iphone>

A sequência de caracteres de extensão de um tipo de arquivo.

Elemento pai: fileType

Elementos filho: nenhum

<extension>png</extension>

Especifica o ID de uma extensão ActionScript usada pelo aplicativo. O ID é definida no documento descritor da extensão.

Elemento pai: extensions

Elementos filho: nenhum

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

Identifica as extensões ActionScript usadas por um aplicativo.

Elemento pai: application

Elementos filho: extensionID

<extensions> 
    <extensionID>extension.first</extensionID> 
    <extensionID>extension.next</extensionID> 
    <extensionID>extension.last</extensionID> 
</extensions>

Especifica o nome de um arquivo de texto que contenha uma lista de arquivos SWF a serem configurados pelo ADT para hospedagem remota. Você pode minimizar o tamanho inicial de download do aplicativo ao empacotar um subconjunto dos SWFs usados por seu aplicativo e carregar os SWFs externos restantes (apenas ativos) no runtime usando o método Loader.load() . Para usar esse recurso, é necessário empacotar o aplicativo para que o ADT mova todo o ActionScript ByteCode (ABC) dos arquivos SWF carregados externamente para o aplicativo SWF principal, deixando um arquivo SWF que contenha todos os recursos. Isso é feito para obedecer à regra da Apple Store que proíbe o download de códigos depois que um aplicativo é instalado.

Para obter mais informações, consulte Minimizar o tamanho do download carregando SWFs externos com somente ativos .

Elemento pai: iPhone , initialWindow

Elementos filho: nenhum

<iPhone> 
    <externalSwfs>FileContainingListofSWFs.txt</externalSwfs> 
</iPhone>

A sequência de caracteres a ser usada como um filename do aplicativo (sem extensão) quando o aplicativo é instalado. O arquivo do aplicativo inicia o aplicativo do AIR no tempo de execução. Se nenhum valor name for fornecido, filename também será usado como o nome da pasta de instalação.

Elemento pai: application

Elementos filho: nenhum

<filename>MyApplication</filename>

Descreve um tipo único de arquivo que o aplicativo pode se cadastrar.

Elemento pai: fileTypes

Elementos filho:

• contentType

• description

• extension

• icon

• name

<fileType> 
    <name>foo.example</name> 
    <extension>foo</extension> 
    <description>Example file type</description> 
    <contentType>text/plain</contentType> 
    <icon> 
        <image16x16>icons/fooIcon16.png</image16x16> 
        <image48x48>icons/fooIcon48.png</imge48x48> 
    <icon> 
</fileType>

O elemento fileTypes permite declarar os tipos de arquivos com os quais um aplicativo do AIR pode ser associado.

Quando um aplicativo do AIR for instalado, qualquer tipo de arquivo declarado é registrado com o sistema operacional. Se esses tipos de arquivo ainda não estiverem associados a um outro aplicativo, eles são associados ao aplicativo do AIR. Para substituir uma associação existente entre um tipo de arquivo e outro aplicativo, use o método NativeApplication.setAsDefaultApplication() em runtime (preferencialmente com a permissão do usuário).

O elemento fileTypes é opcional.

Elemento pai: application

Elementos filho: fileType

<fileTypes> 
    <fileType> 
        <name>adobe.VideoFile</name> 
        <extension>avf</extension> 
        <description>Adobe Video File</description> 
        <contentType>application/vnd.adobe.video-file</contentType> 
        <icon> 
            <image16x16>icons/AIRApp_16.png</image16x16>       
            <image32x32>icons/AIRApp_32.png</image32x32>       
            <image48x48>icons/AIRApp_48.png</image48x48>      
            <image128x128>icons/AIRApp_128.png</image128x128> 
        </icon> 
    </fileType> 
</fileTypes>

Descreve uma única fonte personalizada que pode ser usada no aplicativo do AIR.

Elemento pai: embedFonts

Elementos filho: fontName , fontPath

<font> 
   <fontPath>ttf/space age.ttf</fontPath>
   <fontName>space age</fontName> 
</font>

Especifica o nome da fonte personalizada.

Elemento pai: fonte

Elementos filho: nenhum

<fontName>space age</fontName> 

Oferece o local do arquivo da fonte personalizada.

Elemento pai: fonte

Elementos filho: nenhum

<fontPath>ttf/space age.ttf</fontPath> 

Force o CPU a entrar no modo de renderização para um conjunto específico de dispositivos. Esse recurso permite que você efetivamente ative o modo de renderização da GPU de forma seletiva para os dispositivos iOS restantes.

Adicione esta tag como filha da tag iPhone e especifique uma lista separada por espaços com os nomes dos modelos de dispositivos. Os nomes de modelos de dispositivo válidos incluem:

Elemento pai: iPhone , initialWindow

Elementos filho: nenhum

... 
<renderMode>GPU</renderMode> 
... 
<iPhone> 
... 
   <forceCPURenderModeForDevices>iPad1,1 iPhone1,1 iPhone1,2 iPod1,1 
   </forceCPURenderModeForDevices> 
</iPhone>

Especifica se o aplicativo é iniciado no modo de tela cheia.

Elemento pai: initialWindow

Elementos filho: nenhum

<fullscreen>true</fullscreen>

A altura inicial da janela principal do aplicativo.

Se você não definir uma altura, esta é determinada pelas configurações no arquivo SWF raiz ou, no caso de um aplicativo do AIR baseado em HTML, pelo sistema operacional.

A altura máxima de uma janela muda de 2048 para 4096 pixels no AIR 2.

Elemento pai: initialWindow

Elementos filho: nenhum

<height>4095</height>

A propriedade icon especifica um ou mais arquivos de ícone a serem usados pelo aplicativo. A inclusão de um ícone é opcional. Se você não especificar uma propriedade icon , o sistema operacional exibirá um ícone padrão.

O caminho especificado é relativo ao diretório raiz do aplicativo. Os arquivos de ícone devem estar no formato PNG. Você pode especificar todos os tamanhos de ícones a seguir:

Se um elemento para um determinado tamanho estiver presente, a imagem no arquivo deverá ser exatamente do tamanho especificado. Se todos os tamanhos não forem fornecidos, o tamanho mais próximo será dimensionado para se ajustar para um determinado uso do ícone pelo sistema operacional.

Para melhores resultados, forneça uma imagem para cada um dos tamanhos disponíveis. Além disso, verifique se os ícones estão apresentáveis nos modos de cores de 16 e 32 bits.

Elemento pai: application

Elementos filho: imageNxN

<icon> 
    <image16x16>icons/smallIcon.png</image16x16> 
    <image32x32>icons/mediumIcon.png</image32x32> 
    <image48x48>icons/bigIcon.png</image48x48> 
    <image128x128>icons/biggestIcon.png</image128x128>  
</icon>

Uma sequência de caracteres de identificador para o aplicativo, conhecida como O ID do aplicativo. Um identificador do estilo DNS reverso é usado frequentemente, mas este estilo não é necessário.

Elemento pai: application

Elementos filho: nenhum

<id>org.example.application</id>

Define o caminho para um ícone relativo ao diretório do aplicativo.

As imagens de ícone a seguir podem ser usadas, cada um especificando um tamanho diferente de ícone:

• image16x16

• image29x29 (acima de AIR 2)

• image32x32

• image36x36 (acima de AIR 2.5)

• image48x48

• image50x50 (acima de AIR 3.4)

• image57x57 (acima de AIR 2)

• image58x58 (acima de AIR 3.4)

• image72x72 (acima de AIR 2)

• image100x100 (acima de AIR 3.4)

• image114x114 (acima de AIR 2.6)

• image128x128

• image144x144 (acima de AIR 3.4)

• image512x512 (acima de AIR 2)

• image1024x1024 (acima de AIR 3.4)

O ícone deve ser um gráfico PNG exatamente do tamanho indicado pelo elemento de imagem. Os arquivos de ícone devem ser incluídos no pacote de aplicativos; ícones referenciados no documento de descrição do aplicativo não são incluídos automaticamente.

Elemento pai: application

Elementos filho: nenhum

<image32x32>icons/icon32.png</image32x32>

Permite especificar propriedades adicionais de um aplicativo iOS.

Elemento pai: iPhone

Elementos filho: elementos Info.plist para iOS

<InfoAdditions> 
    <![CDATA[ 
        <key>UIStatusBarStyle</key> 
        <string>UIStatusBarStyleBlackOpaque</string> 
        <key>UIRequiresPersistentWiFi</key> 
        <string>NO</string> 
    ]]> 
</InfoAdditions>

Define o principal conteúdo do arquivo e aparência inicial do aplicativo.

Elemento pai: application

<initialWindow> 
    <title>Hello World</title> 
    <content> 
        HelloWorld.swf 
    </content> 
    <depthAndStencil>true</depthAndStencil> 
    <systemChrome>none</systemChrome> 
    <transparent>true</transparent> 
    <visible>true</visible> 
    <maxSize>1024 800</maxSize> 
    <minSize>320 240</minSize> 
    <maximizable>false</maximizable> 
    <minimizable>false</minimizable> 
    <resizable>true</resizable> 
    <x>20</x> 
    <y>20</y> 
    <height>600</height> 
    <width>800</width> 
    <aspectRatio>landscape</aspectRatio> 
    <autoOrients>true</autoOrients> 
    <fullScreen>false</fullScreen> 
    <renderMode>direct</renderMode> 
</initialWindow>

Identifica o subdiretório do diretório de instalação padrão.

No Windows, o subdiretório de instalação padrão é Arquivos de Programas. No Mac OS, é o diretório /Applications. No Linux, é /opt/. Por exemplo, se a propriedade installFolder é definida como "Acme" e um aplicativo é chamado de "ExampleApp" , o aplicativo é instalado em C:\Arquivos de Programas\Acme\ExampleApp no Windows, em /Applications/Acme/Example.app no Mac OS e em /opt/Acme/ExampleApp no Linux.

A propriedade installFolder é opcional. Se você não especificar nenhuma propriedade installFolder , o aplicativo será instalado em um subdiretório do diretório de instalação padrão, com base na propriedade name .

Elemento pai: application

Elementos filho: nenhum

<installFolder>utilities/toolA</installFolder>

Define as propriedades de aplicativos específicos para iOS.

Elemento pai: application

Especifica informações para adicionar ao arquivo de manifesto do Android para o aplicativo.

Elemento pai: manifestAdditions

Elementos filho: Definido pelo Android SDK.

<![CDATA[      
    <manifest android:sharedUserID="1001"> 
        <uses-permission android:name="android.permission.CAMERA"/> 
        <uses-feature android:required="false" android:name="android.hardware.camera"/> 
        <application     android:allowClearUserData="true" 
                    android:enabled="true" 
                    android:persistent="true"/> 
    </manifest> 
]]>

Especifica informações para adicionar ao arquivo do manifesto do Android.

Cada aplicativo do Android inclui um arquivo de manifesto que define as propriedades básicas do aplicativo. O manifesto do Android é semelhante em conceito ao descritor do aplicativo do AIR. Um aplicativo do AIR for Android tem tanto um descritor de aplicativo quanto um arquivo de manifesto do Android gerado automaticamente. Quando um aplicativo do AIR for Android é compactado, as informações contidas neste elemento manifestAdditions são adicionadas às partes correspondentes do documento de manifesto do Android.

Elemento pai: android

Elementos filho: manifesto

<manifestAdditions> 
    <![CDATA[      
        <manifest android:installLocation="preferExternal"> 
            <uses-permission android:name="android.permission.INTERNET"/> 
            <application     android:allowClearUserData="true" 
                        android:enabled="true" 
                        android:persistent="true"/> 
        </manifest> 
    ]]> 
</manifestAdditions>

Especifica se a janela pode ser maximizada.

Elemento pai: initialWindow

Elementos filho: nenhum

<maximizable>false</maximizable>

O tamanho máximo da janela. Se você não definir um tamanho máximo, este será determinado pelo sistema operacional.

Elemento pai: initialWindow

Elementos filho: nenhum

<maxSize>1024 360</maxSize>

Especifica se a janela pode ser minimizada.

Elemento pai: initialWindow

Elementos filho: nenhum

<minimizable>false</minimizable>

Especifica o tamanho mínimo permitido para a janela.

Elemento pai: initialWindow

Elementos filho: nenhum

<minSize>120 60</minSize>

O título do aplicativo que é exibido pelo instalador do aplicativo do AIR.

Se nenhum elemento name for especificado, o instalador do aplicativo do AIR exibirá filename como o nome do aplicativo.

Elemento pai: application

Elementos filho: text

<name>Test Application</name> 

<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 

Identifica o nome de um tipo de arquivo.

Elemento pai: fileType

Elementos filho: nenhum

<name>adobe.VideoFile</name>

Identifica o local no qual colocar atalhos para o aplicativo no menu Todos os Programas do sistema operacional Windows ou no menu Aplicativos do Linux. (Essa configuração é atualmente ignorada em outros sistemas operacionais.)

Elemento pai: application

Elementos filho: nenhum

<programMenuFolder>Example Company/Sample Application</programMenuFolder>

Identifica o ID do editor para atualizar um aplicativo do AIR criada originalmente com AIR versão 1.5.2 ou anterior.

Somente especifique um ID do editor ao criar uma atualização do aplicativo. O valor do elemento publisherID deve corresponder à ID do editor gerada pelo AIR para a versão anterior do aplicativo. Para um aplicativo instalado, o ID do editor pode ser encontrada na pasta em que um aplicativo é instalado, no arquivo META-INF/AIR/publisherid .

Novos aplicativos criados com o AIR 1.5.3 ou posterior não devem especificar um ID do editor.

Para obter mais informações, consulte Sobre identificadores de editor do AIR .

Elemento pai: application

Elementos filho: nenhum

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

Especifica se deve usar aceleração de unidade de processamento gráfico (GPU), se disponível no dispositivo de computação atual.

Elemento pai: initialWindow

Elementos filho: nenhum

<renderMode>direct</renderMode>

Especifica se o aplicativo deseja usar a resolução padrão ou alta em um dispositivo ou monitor de computador com uma tela de alta resolução. Quando definida para padrão , a tela aparecerá para o aplicativo como uma tela de resolução padrão. Quando definida para alta , o aplicativo pode tratar cada pixel de alta resolução.

Por exemplo, em uma tela de iPhone de 640x960 de alta resolução, se a configuração for standard , as dimensões do palco em tela inteira são 320x480 e cada pixel do aplicativo é renderizado usando quatro pixels da tela. Se a configuração for high , as dimensões do palco em tela inteira são 640x960.

Em dispositivos com telas de resolução padrão, as dimensões do palco combinam com de tela, sem importar qual definição é usada.

Se o elemento requestedDisplayResolution estiver aninhado no elemento iPhone , ele se aplica aos dispositivos iOS. Neste caso, o atributo excludeDevices pode ser usado para especificar dispositivos aos quais a configuração não é aplicada.

Se o elemento requestedDisplayResolution estiver aninhado ao elemento initialWindow , ele se aplica aos aplicativos de desktop AIR nos computadores MacBook Pro compatíveis com exibições em alta resolução. O valor especificado se aplica a todas as janelas nativas usadas no aplicativo. O aninhamento do elemento requestedDisplayResolution ao elemento initialWindow é suportado no AIR 3.6 e posterior.

Elemento pai: iPhone , initialWindow

Elementos filho: nenhum

<initialWindow> 
    <requestedDisplayResolution>high</requestedDisplayResolution> 
</initialWindow>

<iPhone> 
    <requestedDisplayResolution excludeDevices="iPad3 iPad4">high</requestedDisplayResolution> 
</iPhone>

Especifica se a janela pode ser redimensionada.

Elemento pai: initialWindow

Elementos filho:

<resizable>false</resizable>

Especifica o comportamento padrão do aplicativo quando um teclado virtual é exibido. O comportamento padrão é deslocar o aplicativo para cima. O runtime mantém o objeto interativo ou o campo de texto focalizado na tela. Use a opção pan se o aplicativo não fornecer sua própria lógica de manipulação do teclado.

Você também pode desativar o comportamento automático, definindo o elemento softKeyboardBehavior para nenhum . Neste caso, os campos de texto e objetos interativos enviam um SoftKeyboardEvent quando o teclado virtual é gerado, mas o runtime não desloca ou redimensiona o aplicativo. É responsabilidade do seu aplicativo manter a área de entrada de texto em exibição.

Elemento pai: initialWindow

Elementos filho: nenhum

<softKeyboardBehavior>none</softKeyboardBehavior>

Identifica os idiomas suportados pelo aplicativo. Esse elemento é usado apenas pelo iOS, runtime cativo do Mac e pelos aplicativos Android. Esse elemento é ignorado por todos os tipos de aplicativo.

Se você não especificar esse elemento, por padrão o empacotador realiza as seguintes ações com base no tipo de aplicativo:

Elemento pai: application

Elementos filho: nenhum

<supportedLanguages>en ja fr es</supportedLanguages>

Identifica os perfis que são compatíveis com o aplicativo.

Elemento pai: application

Elementos filho: nenhum

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

<supportedProfiles>desktop mobileDevice</supportedProfiles>

Especifica se a janela inicial do aplicativo é criada com controles, bordas e barra de título padrão fornecidos pelo sistema operacional.

A configuração do cromo do sistema da janela não pode ser alterada em runtime.

Elemento pai: initialWindow

Elementos filho: nenhum

<systemChrome>standard</systemChrome>

Especifica uma sequência de caracteres traduzida.

O atributo xml:lang de um elemento de texto especifica um código de idioma, como definido em RFC4646 (http://www.ietf.org/rfc/rfc4646.txt).

O instalador do aplicativo do AIR usa o elemento text com o valor de atributo xml:lang que mais se aproxima do idioma da interface do sistema operacional do usuário.

Por exemplo, considere uma instalação na qual um elemento text inclui um valor para o local en (inglês). O instalador do aplicativo do AIR usa o nome en se o sistema operacional identifica en (inglês) como o idioma da interface do usuário. Ele também usa o nome en se o idioma da interface do usuário do sistema for en-US (inglês norte-americano). No entanto, se o idioma da interface do usuário é en-US e o arquivo do descritor do aplicativo define os nomes en-US e en-GB, o instalador do aplicativo do AIR usa o valor en-US.

Se o aplicativo não define nenhum elemento text que corresponda aos idiomas da interface do usuário do sistema, o instalador do aplicativo do AIR usa o primeiro valor name definido no arquivo do descritor do aplicativo.

Elementos filho: nenhum

<text xml:lang="fr">Bonjour AIR</text>

Especifica o título exibido na barra de título da janela inicial do aplicativo.

Um título é exibido apenas se o elemento systemChrome estiver definido para standard .

Elemento pai: initialWindow

Elementos filho: nenhum

<title>Example Window Title</title>

Especifica se a janela inicial do aplicativo é alfa mesclada com o desktop.

Uma janela com transparência ativada pode ser desenhada mais lentamente e exigir mais memória. A configuração de transparente não pode ser alterada no tempo de execução.

Elemento pai: initialWindow

Elementos filho: nenhum

<transparent>true</transparent>

Especifica as informações de versão para o aplicativo.

A sequência de caracteres da versão é um designador definido pelo aplicativo. O AIR não interpreta de maneira nenhuma a string de versão. Portanto, não se supõe que a versão “3.0” é mais atual que a versão “2.0.” Exemplos: "1.0" , " .4" , " 0.5 ", "4.9" , "1.3.4a" .

Em AIR 2.5 e posterior, o elemento version é substituído pelos elementos versionNumber e versionLabel .

Elemento pai: application

Elementos filho: nenhum

<version>0.1 Alpha</version>

Especifica uma sequência de caracteres da versão legível por pessoas.

O valor do rótulo da versão é exibido em diálogos de instalação em vez de o valor do elemento versionNumber . Se versionLabel não for usado, o versionNumber é usado para ambos.

Elemento pai: application

Elementos filho: nenhum

<versionLabel>0.9 Beta</versionlabel>

O número da versão do aplicativo.

Elemento pai: application

Elementos filho: nenhum

<versionNumber>1.0.657</versionNumber> 
 
<versionNumber>10</versionNumber> 
 
<versionNumber>0.01</versionNumber>

Especifica se a janela inicial do aplicativo fica visível assim que é criada.

Janelas do AIR, incluindo a janela inicial, são criadas em estado invisível por padrão. Você pode exibir a janela chamando o método activate() do objeto NativeWindow ou definindo a propriedade visible como true . Você pode querer deixar a janela principal oculta inicialmente, para que alterações na posição da janela, no tamanho da janela e o layout de seu conteúdo não sejam exibidos.

O componente mx:WindowedApplication do Flex exibe e ativa de maneira automática a janela imediatamente antes que o evento applicationComplete seja despachado, a menos que o atributo visible seja definido como false na definição MXML.

Nos dispositivos em perfis móveis, que não são compatíveis com janelas, a configuração visível é ignorada.

Elemento pai: initialWindow

Elementos filho: nenhum

<visible>true</visible>

A largura inicial da janela principal do aplicativo.

Se você não definir uma largura, esta é determinada pelas configurações no arquivo SWF raiz ou, no caso de um aplicativo do AIR baseado em HTML, pelo sistema operacional.

A largura máxima de uma janela muda de 2048 para 4096 pixels no AIR 2.

Elemento pai: initialWindow

Elementos filho: nenhum

<width>1024</width>

A posição horizontal da janela inicial do aplicativo.

Na maioria dos casos, é melhor deixar o sistema operacional determinar a posição inicial da janela em vez de atribuir um valor fixo.

A origem do sistema de coordenadas da tela (0,0) é o canto superior esquerdo da tela principal do desktop (conforme determinado pelo sistema operacional).

Elemento pai: initialWindow

Elementos filho: nenhum

<x>120</x>

A posição vertical da janela inicial do aplicativo.

Na maioria dos casos, é melhor deixar o sistema operacional determinar a posição inicial da janela em vez de atribuir um valor fixo.

A origem do sistema de coordenadas da tela (0,0) é o canto superior esquerdo da tela principal do desktop (conforme determinado pelo sistema operacional).

Elemento pai: initialWindow

Elementos filho: nenhum

<y>250</y>