iOS-instellingen

Adobe AIR 3.3 en hoger biedt ondersteuning voor multitasking in iOS door bepaalde achtergrondfuncties mogelijk te maken:

• Audio

• Locatie-updates

• Netwerken

• Uitvoering van apps op achtergrond uitschakelen

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

Door AIR worden verschillende vermeldingen in het gegenereerde Info.plist-bestand ingesteld om te garanderen dat de toepassings- en runtimefuncties correct werken. U kunt de volgende instellingen niet definiëren:

Neem voor iPad-ondersteuning de juiste sleutel-waarde-instellingen voor UIDeviceFamily op in het InfoAdditions -element. De instelling UIDeviceFamily is een array van tekenreeksen. In elke tekenreeks worden ondersteunde apparaten gedefinieerd. De instelling <string>1</string> definieert ondersteuning voor de iPhone en de iPod touch. De instelling <string>2</string> definieert ondersteuning voor de iPad. De instelling <string>3</string> definieert ondersteuning voor de tvOS. Als u slechts één van deze tekenreeksen definieert, wordt alleen de desbetreffende apparaatfamilie ondersteund. Bij de volgende instelling is er bijvoorbeeld alleen ondersteuning voor de iPad:

<key>UIDeviceFamily</key> 
                            <array> 
                            <string>2</string> 
                            </array>>

En bij deze instelling is er ondersteuning voor beide apparaatfamilies (de iPhone/iPod touch en iPad):

<key>UIDeviceFamily</key> 
                            <array> 
                            <string>1</string> 
                            <string>2</string> 
                            </array>

Bovendien kunt u in AIR 3.7 en hoger de tag forceCPURenderModeForDevices gebruiken om de CPU-rendermodus te forceren voor een opgegeven serie apparaten en de GPU-rendermodus in te schakelen voor de resterende iOS-apparaten.

U voegt deze tag toe als een onderliggend element van de iPhone -tag en geeft een lijst op waarin de modelnamen van apparaten met een spatie van elkaar zijn gescheiden. Zie forceCPURenderModeForDevices voor een lijst met geldige modelnamen van apparaten.

Geef bijvoorbeeld het volgende op in het descriptorbestand van de toepassing als u de CPU-modus wilt gebruiken in oudere iPods, iPhones en iPads en de GPU-modus voor alle andere apparaten:

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

Het element requestedDisplayResolution geeft op of uw toepassing de modus voor standaard of hoge resolutie moet gebruiken op iOS-apparaten met hoge-resolutieschermen.

<requestedDisplayResolution>high</requestedDisplayResolution>

In de hoge-resolutiemodus kunt u elke pixel op een scherm met hoge resolutie afzonderlijk verwerken. In de standaardmodus komt het apparaatscherm op uw toepassing over als een scherm met standaardresolutie. Wanneer u één pixel tekent in deze modus, wordt de kleur van vier pixels op het scherm met hoge resolutie ingesteld.

De standaardinstelling is standard . Merk op dat u voor het plaatsen van iOS-apparaten het requestedDisplayResolution -element gebruikt als een onderliggend element van het iPhone -element (niet het InfoAdditions -element of initialWindow -element).

Als u verschillende instellingen wilt gebruiken op verschillende apparaten, geeft u uw standaardwaarde op als de waarde van het requestedDisplayResolution -element. Gebruik het excludeDevices -attribuut om apparaten op te geven die de tegenovergestelde waarde moeten gebruiken. Met de volgende code, bijvoorbeeld, wordt de modus voor hoge resolutie gebruikt voor alle apparaten die deze ondersteunen, behalve iPad's van de derde generatie, die de standaardmodus gebruiken:

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

Het excludeDevices -attribuut is beschikbaar in AIR 3.6 en later.

U kunt een aangepast URI-schema registreren, zodat uw toepassing kan worden aangeroepen door een koppeling op een webpagina of in een andere, native toepassing op het apparaat. U registreert een URI-schema door een CFBundleURLTypes-sleutel toe te voegen aan het InfoAdditions-element. Het volgende voorbeeld registreert het URI-schema com.example.app , zodat een toepassing kan worden aangeroepen door URL's met de notatie: 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>

Wanneer uw toepassing wordt opgeroepen via een custom-URL, wordt door het NativeApplication-object een gebeurtenis invoke verzonden. De URL van de koppeling, inclusief queryparameters, wordt geplaatst in de array arguments van het object InvokeEvent. U kunt een willekeurig aantal aangepaste URI-schema's gebruiken.

Voeg vermeldingen toe aan een UIRequiredDeviceCapabilities-array in het InfoAdditions -element als uw toepassing alleen gebruikt mag worden op apparaten met specifieke hardware- of softwarefunctionaliteit. De volgende vermelding geeft bijvoorbeeld aan dat een toepassing een fototoestel en een microfoon nodig heeft:

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

De toepassing kan niet worden geïnstalleerd als een apparaat daar niet over beschikt. Enkele voor AIR-toepassingen relevante functionaliteitsinstellingen:

AIR 2.6+ voegt armv7 en opengles-2 automatisch toe aan de lijst met vereiste functionaliteit.

Wanneer een gebruiker bij een AIR-toepassing wegklikt, wordt de toepassing op de achtergrond geplaatst en onderbroken. Als u de toepassing volledig wilt afsluiten in plaats van te onderbreken, stelt u de eigenschap UIApplicationExitsOnSuspend in op YES :

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

U kunt de downloadgrootte van de aanvankelijke toepassing minimaliseren door een subset van de door uw toepassing gebruikte SWF-bestanden te verpakken en de resterende externe SWF-bestanden (met alleen elementen) tijdens de runtime te laden met behulp van de methode Loader.load () . Als u deze functie wilt gebruiken, dient u de toepassing zodanig te verpakken dat ADT alle ActionScript ByteCode (ABC) uit de extern geladen SWF-bestanden naar de SWF-hoofdtoepassing verplaatst, zodat er een SWF-bestand met uitsluitend elementen overblijft. Zo wordt voldaan aan de regel van de Apple Store die het downloaden van code verbiedt nadat een toepassing is geïnstalleerd.

ADT biedt op de volgende manieren ondersteuning voor extern geladen SWF-bestanden (ook wel gestripte SWF-bestanden genoemd):

• Leest het tekstbestand dat is opgegeven in het subelement <externalSwfs> van het element <iPhone> voor toegang tot de lijst met via regels van elkaar gescheiden SFW-bestanden die tijdens de uitvoering moeten worden geladen:

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

• Brengt de ABC-code van elk extern geladen SWF-bestand over naar het hoofduitvoeringsbestand.

• Sluit extern geladen SWF-bestanden uit van het .ipa-bestand.

• Kopieert gestripte SWF-bestanden naar de map .remoteStrippedSWFs . U host deze SWF-bestanden op een webserver en uw toepassing laadt deze bestanden, indien nodig, tijdens de runtime.

U geeft de SWF-bestanden op die tijdens de runtime moeten worden geladen door de desbetreffende bestandsnamen op te geven in een tekstbestand, en wel één naam per regel, zoals in het volgende voorbeeld:

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

Het opgegeven bestandspad is relatief ten opzichte van het descriptorbestand van de toepassing. Daarnaast moet u deze SWF-bestanden als elementen opgeven in de opdracht adt .

Zie Secundaire SWF-bestanden extern hosten voor AIR-apps op iOS , een door Adobe-technicus Abhinav Dhandh geplaatst blog met meer informatie over deze functie, inclusief voorbeeldcode.

Voor Geolocation-ondersteuning, voegt u een van de volgende sleutelwaardeparen aan het element 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>