Configurações do iOS

Adobe AIR 3.3 e superior oferece suporte a multitarefa no iOS ativando determinados comportamentos de segundo plano:

• Áudio

• Atualizações de local

• Sistemas de rede

• Cancelar a execução de aplicativos em segundo plano

<InfoAdditions> 
                                <![CDATA[ 
                                <key>UIBackgroundModes</key> 
                                <array> 
                                <string>audio</string> 
                                </array> 
                                ]]> 
                                </InfoAdditions>

<InfoAdditions> 
                                <![CDATA[ 
                                <key>UIBackgroundModes</key> 
                                <array> 
                                <string>location</string> 
                                </array> 
                                ]]> 
                                </InfoAdditions>

<InfoAdditions> 
                                <![CDATA[ 
                                <key>UIApplicationExitsOnSuspend</key> 
                                <true/> 
                                ]]> 
                                </InfoAdditions>

O AIR define várias entradas no arquivo INfo.plist gerado para garantir que os recursos do aplicativo e o runtime funcionem corretamente. Não é possível definir as configurações a seguir:

Para oferecer suporte a iPad, inclua as configurações adequadas de valores chave para UIDeviceFamily no elemento InfoAdditions . 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. O ajuste <string>2</string> define o suporte para o iPad. O ajuste <string>3</string> define o suporte para o 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>>

As configurações 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>

Além disso, no AIR 3.7 e superiores, é possível usar a tag forceCPURenderModeForDevices para forçar a CPU a entrar no modo de renderização para um conjunto de dispositivos especificado e ativar o modo de renderização da GPU 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. Para obter uma lista de nomes de modelos de dispositivos válidos, consulte forceCPURenderModeForDevices .

Por exemplo, para usar o modo de CPU em iPods, iPhones e iPads antigos e ativar o modo de GPU para todos os demais dispositivos, especifique o seguinte no descritor do aplicativo:

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

O elemento requestedDisplayResolution especifica se o seu aplicativo usará o modo de resolução padrão ou alta nos dispositivos iOS com tela de alta resolução.

<requestedDisplayResolution>high</requestedDisplayResolution>

No modo de alta resolução, você pode tratar individualmente cada pixel numa exibição de alta resolução. No modo padrão, a tela do dispositivo aparecerá para o seu aplicativo como uma tela de resolução padrão. O desenho de um único pixel nesse modo definirá a cor de quatro pixel na tela de alta resolução.

A definição proposta pelo aplicativo é padrão . Observe que, para o direcionamento de dispositivos iOS, você utiliza o elemento requestedDisplayResolution como um filho do elemento iPhone (não os elementos InfoAdditions ou initialWindow ).

Se desejar utilizar configurações diferentes em dispositivos diferentes, especifique o seu valor padrão como o valor do elemento requestedDisplayResolution . Use o atributo excludeDevices para especificar dispositivos que devem usar o valor oposto. Por exemplo, com o código a seguir, o modo de alta resolução é usado para todos os dispositivos compatíveis, exceto os iPads de 3ª geração, que usam o modo padrão.

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

O atributo excludeDevices está disponível no AIR 3.6 e posterior.

Você pode registrar um esquema URI personalizado para permitir que o seu aplicativo seja invocado por um link numa página da web ou em um outro aplicativo nativo no dispositivo. Para registrar um esquema URI, adicione uma chave CFBundleURLTypes no elemento InfoAdditions. O exemplo a seguir registra um esquema URI denominado com.example.app para permitir que o aplicativo seja invocado por URLs com a forma: example://foo .

<key>CFBundleURLTypes</key> 
                            <array> 
                            <dict> 
                            <key>CFBundleURLSchemes</key> 
                            <array> 
                            <string>example</string> 
                            </array> 
                            <key>CFBundleURLName</key> 
                            <string>com.example.app</string> 
                            </dict> 
                            </array>

Quando o aplicativo é invocado através de um URI personalizado, o objeto NativeApplication envia um evento invoke . A URL do link, incluindo parâmetros de consulta, é colocada no array arguments do objeto InvokeEvent. Você pode usar qualquer número de esquemas URI personalizados.

Adicione entradas a uma matriz UIRequiredDeviceCapabilities dentro do elemento InfoAdditions se o seu aplicativo tiver que ser usado somente em dispositivos com capacidades específicas de hardware ou software. Por exemplo, a entrada a seguir indica que um aplicativo requer uma câmara fotográfica digital e um microfone:

<key>UIRequiredDeviceCapabilities</key> 
                            <array> 
                            <string>microphone</string> 
                            <string>still-camera</string> 
                            </array>

Se um dispositivo não tiver a capacidade correspondente, o aplicativo não poderá ser instalado. As configurações de capacidade relevantes para os aplicativos AIR incluem:

O AIR 2.6+ adiciona automaticamente armv7 e opengles-2 à lista de capacidades requeridas.

Quando um usuário sai de um aplicativo do AIR, o aplicativo vai para o segundo plano e pausa. Se você quiser que o seu aplicativo seja encerrado completamente, em vez de pausar, defina a propriedade UIApplicationExitsOnSuspend como YES :

<key>UIApplicationExitsOnSuspend</key> 
                            <true/>

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.

O ADT realiza o seguinte procedimento para ser compatível com os SWFs carregados externamente (também chamados de SWFs sem código):

• Lê o arquivo de texto especificado no sub-elemento <externalSwfs> do elemento <iPhone> para acessar a lista determinada por linhas dos SWFs que serão carregados no momento de execução:

  <iPhone> 
                                         ... 
                                         <externalSwfs>FilewithPathsOfSWFsThatAreToNotToBePackaged.txt</externalSwfs> 
                                      </iPhone>

• Transfere o código ABC de cada SWF carregado externamente para o executável principal.

• Omite o SWF carregado externamente do arquivo .ipa.

• Copia os SWFs sem código para o diretório .remoteStrippedSWFs . Você hospeda esses SWFs em um servidor da Web e seu aplicativo os carrega, conforme necessário, no runtime.

Você indica que os arquivos SWF devem ser carregados no runtime especificando seus nomes, um por linha em um arquivo de texto, conforme o exemplo a seguir:

assets/Level1/Level1.swf 
                            assets/Level2/Level2.swf 
                            assets/Level3/Level3.swf 
                            assets/Level4/Level4.swf

O caminho do arquivo especificado é relativo ao arquivo do descritor do aplicativo. Além disso, esses SWFs devem ser especificados como ativos no comando adt .

Para obter mais informações sobre esse recurso, incluindo amostras de código, consulte Hospedagem externa de SWFs secundários para os aplicativos AIR no iOS , uma postagem de blog do engenheiro da Adobe, Abhinav Dhandh.

Para usar o suporte à geolocalização, adicione um dos seguintes pares de valores-chave ao elemento InfoAdditions :

<InfoAdditions> 
                            <![CDATA[ 
                            <key>NSLocationAlwaysUsageDescription</key> 
                            <string>Sample description to allow geolocation always</string> 
                            <key>NSLocationWhenInUseUsageDescription</key> 
                            <string>Sample description to allow geolocation when application is in foreground</string>               
                            ]]> 
                            </InfoAdditions>