O arquivo do descritor do aplicativo é um arquivo XML que contém propriedades do aplicativo inteiro, tais como nome, versão, direitos autorais e outras configurações.
O Flash Professional CS5 cria o arquivo do descritor do aplicativo com base nas configurações na caixa de diálogo Configurações do iPhone. No entanto, é possível também editar o arquivo do descritor do aplicativo em um editor de texto. O Flash Professional nomeia o arquivo do descritor do aplicativo adicionando “-app.xml” ao nome do projeto. Por exemplo, o arquivo do descritor do aplicativo do projeto HelloWorld é nomeado HelloWorld-app.xml. Edite o arquivo do descritor do aplicativo se desejar definir as configurações não suportadas na caixa do diálogo Configurações do iPhone do Flash Professional CS5. Por exemplo, é possível definir o elemento
InfoAdditions
para definir as configurações de info.Plist para o aplicativo.
Veja os detalhes das configurações nesse arquivo do descritor do aplicativo:
-
No elemento
<application>
, é necessário “AIR 2.0 namespace” para criar aplicativos para iPhone:
<application xmlns="http://ns.adobe.com/air/application/2.0">
-
O elemento
<id>
:
<id>com.example.as3.HelloWorld</id>
O ID do aplicativo identifica exclusivamente seu aplicativo. A forma recomendado é uma sequência de caractere separados por pontos, do tipo DNS reverso, como, por exemplo,
"com.company.AppName"
. O compilador usa esse valor como ID de conjunto para o aplicativo para iPhone.
Se o arquivo de aprovisionamento estiver ligado a um ID de aplicativo específico, utilize o ID de aplicativo deste elemento. Ignore os caracteres que a Apple atribui no início de do ID de aplicativo Apple (conhecido como ID da distribuição de conjunto). Por exemplo, se o ID de aplicativo do perfil de aprovisionamento for 96LPVWEASL.com.example.bob.myApp, utilize com.example.bob.myApp como ID de aplicativo no arquivo descritor do aplicativo.
Se o perfil de aprovisionamento permitir múltiplos IDs de aplicativo (caractere curinga), o ID do aplicativo terminará em asterisco (exemplo: 5RM86Z4DJM.*). Forneça um ID de aplicativo que corresponda ao padrão do caractere curinga do ID do aplicativo que você forneceu à Apple:
-
Se o seu ID de aplicativo da Apple é com.myDomain.*, o ID de aplicativo no arquivo descritor de aplicativo deve iniciar com com.myDomain. É possível especificar um ID de aplicativo como, por exemplo, com.myDomain.myApp ou com.myDomain.app22.
-
Se o seu ID de aplicativo da Apple for *, o ID de aplicativo do arquivo descritor pode ser qualquer cadeia de caracteres válidos.
É possível localizar o ID de aplicativo Apple (ou padrão de ID de aplicativo curinga) associado com um perfil de aprovisionamento no iPhone Dev Center (
http://developer.apple.com/iphone
). Acesse a o iPhone Developer Program Portal e, em seguida, acesse a seção Provisioning.
Aviso importante:
Ignore os caracteres no início do ID de aplicativo da Apple. A Apple chama essa cadeia de caracteres de ID da distribuição de conjunto. Por exemplo, se a Apple indicar seu ID de aplicativo como 5RM86Z4DJM.*, ignore a parte 5RM86Z4DJM—isto é um ID de aplicativo curinga. Se a Apple indicar seu ID de aplicativo como 96LPVWEASL.com.example.bob.myApp, ignore a parte 96LPVWEASL—use com.example.bob.myApp como ID do aplicativo.
-
O elemento
<filename>
:
<filename>HelloWorld</filename>
Nome utilizado no arquivo do instalador do iPhone. Não inclua o caractere do sinal de adição (+) no nome de arquivo.
-
O elemento
<name>
:
<name>Hello World</name>
Nome do aplicativo exibido no aplicativo iTunes e no iPhone. Não inclua o caractere do sinal de adição (+) no nome.
-
O elemento
<version>
:
<version>1.0</version>
Ajuda os usuários a determinar qual versão do aplicativo eles estão instalando. Esta versão é utilizada como CFBundleVersion do aplicativo para iPhone. O formato deve ser semelhante à nnnnn[.nn[.nn]], onde n é um dígito de 0 a 9 e os colchetes indicam componentes opcionais como 1, 1.0 ou 1.0.1. As versões do iPhone devem conter somente dígitos e casas decimais. As versões do iPhone podem conter até duas casas decimais.
-
O elemento
<initialWindow>
contém os seguintes elementos filho para especificar as propriedades da aparência inicial do aplicativo:
<content>HelloWorld.swf</content>
Identifica o arquivo SWF raiz a fim de compilar para o aplicativo para iPhone.
<visible>true</visible>
Essa configuração é necessária.
<fullScreen>true</fullScreen>
Especifica se o aplicativo usa a tela inteira do iPhone.
<aspectRatio>portrait</aspectRatio>
Especifica se a proporção do aspecto inicial do aplicativo está no modo retrato (em vez de paisagem). O arquivo Default.png usado para definir a janela inicial do aplicativo deve ter 320 pixels de largura e 480 pixels de altura, independentemente dessa configuração. (Consulte
Ícone do iPhone e imagens de tela iniciais
.)
<autoOrients>true</autoOrients>
(Opcional) Especifica se a orientação do conteúdo no aplicativo reorienta automaticamente quando o próprio dispositivo altera a orientação física. O valor padrão é
true
. É possível cancelar a orientação automática chamando o método
preventDefault()
de um evento
orientationChanging
. despachado pelo objeto Palco. Para obter mais informações, consulte
Definindo e detectando a orientação da tela
.
Ao utilizar orientação automática, para obter melhores resultados, defina a propriedade
align
de palco para a seguinte:
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
<renderMode>gpu</renderMode>
(Opcional) Modo de renderização que o aplicativo utiliza. Há três configurações possíveis:
-
cpu
: O aplicativo usa a CPU para renderizar todos os objetos de exibição. Não se usa aceleração por hardware.
-
gpu
: O aplicativo usa o iPhone GPU para compor bitmaps.
-
Automático
: Esse recurso não foi implantado.
Para obter mais informações, consulte
Aceleração por hardware
.
-
O elemento
<profiles>
:
<profiles>mobileDevice</profiles>
Limita o aplicativo que será compilado para o perfil de dispositivo portátil. Atualmente, esse perfil suporta apenas aplicativos para iPhone. Há três perfis suportados:
-
desktop
—Aplicativo AIR.
-
extendedDesktop
: Aplicativo AIR com suporte a processo nativo API.
-
mobileDevice
: Aplicativo AIR para dispositivo portátil. Atualmente, o iPhone é o único dispositivo portátil suportado.
Limitar o aplicativo a um perfil específico impede que ele seja compilado para outros perfis. Se especificar nenhum perfil, então é possível compilar um aplicativo para qualquer perfil. É possível especificar múltiplos perfis, listando-os, separados por espaços, no elemento
<profiles>
.
Certifique-se de incluir
mobileDevice
como perfil suportado (ou deixe o elemento
<profiles>
vazio).
-
O elemento
<icon>
contém os seguintes elementos filho para especificar os ícones que o aplicativo utiliza:
<image29x29>icons/icon29.png</image29x29>
Essa é a imagem usada em resultados da pesquisa Spotlight.
<image48x48>icons/icon48.png</image48x48>
Esta é a imagem usada em resultados da pesquisa Spotlight no iPad.
<image57x57>icons/icon57.png</image57x57>
Esta é a imagem usada na tela inicial do iPhone e do iPod Touch.
<image72x72>icons/icon72.png</image72x72>
Esta é a imagem usada na tela inicial do iPad.
<image512x512>icons/icon512.png</image512x512>
Essa é a imagem usada no aplicativo iTunes.
A ferramenta Packager for iPhone usa ícones 29, 57 e 512 indicados no arquivo do descritor do aplicativo. A ferramenta copia os ícones para arquivos Icon-Small.png, Icon.png e iTunesArtwork, respectivamente. Para evitar fazer a cópia, é possível empacotar os arquivos diretamente. Empacote os arquivos diretamente, colocando-os no diretório que contém o arquivo do descritor do aplicativo e liste os nomes e os caminhos corretos.
A imagem com 512 pixels destina-se a testes internos apenas. Ao submeter um aplicativo à Apple, submeta a imagem com 512 pixels separadamente. Isso não está incluído no IPA. Especifique-o para certificar-se de que a imagem com 512 pixels tem boa aparência no iTunes antes de submetê-la.
-
O elemento
<iPhone>
contém os seguintes elementos filho para especificar as configurações específicas do iPhone:
<InfoAdditions></InfoAdditions>
contém os elementos filho, especificando os pares com valor-chave para usar como configurações de Info.plist para o aplicativo:
<![CDATA[
<key>UIStatusBarStyle</key>
<string>UIStatusBarStyleBlackOpaque</string>
<key>UIRequiresPersistentWiFi</key>
<string>NO</string>
]]>
Nesse exemplo, os valores definem o estilo da barra de status do aplicativo e determinam que o aplicativo não requer acesso WiFi contínuo.
As configurações de InfoAdditions são anexadas a uma tag
CDATA
.
Para o suporte ao iPad, inclua as configurações de valor chave de
UIDeviceFamily
. A configuração
UIDeviceFamily
é uma matriz de sequências de caracteres. Cada sequência de caracteres define os dispositivos suportados. O parâmetro
<string>1</string>
define o suporte para iPhone e iPod Touch. A configuração
<string>2</string>
define o suporte ao iPad. A configuração
<string>3</string>
define o suporte ao tvOS. Se você especificar somente uma dessas sequências de caracteres, somente aquela família de dispositivos será suportada. Por exemplo, a configuração a seguir limita o suporte ao iPad:
<key>UIDeviceFamily</key>
<array>
<string>2</string>
</array>>
Os conjuntos a seguir suportam as duas famílias de dispositivos (iPhone/iPod Touch e iPad):
<key>UIDeviceFamily</key>
<array>
<string>1</string>
<string>2</string>
</array>
Para obter mais informações sobre outras configurações de Info.plist, consulte a documentação do desenvolvedor da Apple.
