Inställningar för iOS

Adobe AIR 3.3 och senare versioner har stöd för flera samtidiga åtgärder på iOS när vissa bakgrundsbeteenden är aktiverade:

• Ljud

• Platsuppdateringar

• Nätverk

• Välja bort programkörning i bakgrunden

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

AIR anger flera poster i den genererade filen Info.plist för att garantera att programmet och körningsfunktionerna fungerar korrekt. Du kan inte definiera följande inställningar:

För iPad-stöd inkluderar du korrekt nyckelvärdesinställning för UIDeviceFamily inuti InfoAdditions -elementet. Inställningen UIDeviceFamily är en array med strängar. Varje sträng definierar enheter som stöds. Inställningen <string>1</string> definierar stöd för iPhone och iPod touch. Inställningen <string>2</string> definierar stöd för iPad. Inställningen <string>3</string> definierar stöd för tvOS. Om du bara anger en av dessa strängar stöds bara den enhetsgruppen. Följande sträng begränsar till exempel stödet till iPad:

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

Följande inställning har stöd för båda enhetsgrupperna (iPhone/iPod Touch och iPad):

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

Dessutom kan du i AIR 3.7 och senare använda taggen forceCPURenderModeForDevices om du vill framtvinga CPU-återgivningsläget för en angiven uppsättning enheter och aktivera GPU-återgivningsläget för återstående iOS-enheter.

Du lägger till denna tagg som underordnad till iPhone -taggen och skapar en blankstegsavgränsad lista över enhetsmodellnamnen. Se forceCPURenderModeForDevices om du vill få en lista över godkända enhetsmodellnamn.

Om du till exempel vill använda CPU-läget i gamla iPod-, iPhone- och iPad-modeller och aktiverar GPU-läget för alla andra enheter ska du ange följande i programbeskrivningen:

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

Elementet requestedDisplayResolution anger om ditt program ska använda standardupplösning eller hög upplösning på iOS-enheter med högupplösta skärmar.

<requestedDisplayResolution>high</requestedDisplayResolution>

I läget med hög upplösning kan du adressera varje högupplöst pixel individuellt. I standardläget visas enhetens skärm som en skärm med standardupplösning för programmet. När en enda pixel ritas i det här läget anges färgen för fyra pixlar på den högupplösta skärmen.

Standardinställningen är standard . Tänk på att om målenheterna är iOS-enheter använder du elementet requestedDisplayResolution som ett underordnat element till elementet iPhone (inte elementet InfoAdditions eller initialWindow ).

Om du vill använda olika inställningar för olika enheter anger du standardvärdet som värdet för elementet requestedDisplayResolution . Använd attributet excludeDevices för att ange de enheter som ska använda motsatt värde. Med följande kod används till exempel läget med hög upplösning för alla enheter som har stöd för detta, utom 3:e generationens iPad-enheter, som använder standardläget:

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

Attributet excludeDevices finns i AIR 3.6 och senare versioner.

Du kan registrera ett anpassat URI-schema om du vill tillåta ditt program att anropas av en länk på en webbsida eller ett annat, inbyggt program på enheten. Om du vill registrera ett URI-schema lägger du till en CFBundleURLTypes-nyckel i InfoAdditions-elementet. I följande exempel registreras ett URI-schema med namnet com.example.app för att tillåta ett program att anropas av webbadresser med adressformatet: 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>

När ditt program anropas via en anpassad URI skickar NativeApplication-objektet en invoke -händelse. URL:en för den länken, inklusive frågeparametrar, placeras i arguments -arrayen för InvokeEvent-objektet. Du kan använda valfritt antal anpassade URI-scheman.

Lägg till poster i en UIRequiredDeviceCapabilities-array inuti InfoAdditions -elementet om ditt program bara ska användas på enheter med vissa maskinvaru- eller programvarufunktioner. Följande post talar till exempel om att ett program kräver en stillbildskamera och en mikrofon:

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

Om en enhet saknar dessa funktioner kan programmet inte installeras. De funktionsinställningar som rör AIR-program är:

I AIR 2.6+ läggs armv7 och opengles-2 automatiskt till i listan över obligatoriska funktioner.

När en användare växlar från ett AIR-program placeras detta i bakgrunden och pausas. Om du vill att ditt program ska avslutas helt i stället för att pausas anger du egenskapen UIApplicationExitsOnSuspend som YES :

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

Du kan minimera storleken på den första programnedladdningen genom att förpacka en delmängd av SWF-filerna som används i programmet och läsa in de återstående (resursexklusiva) externa SWF-filerna i miljön med metoden Loader.load () . Om du vill använda den här funktionen måste du förpacka programmet så att ADT flyttar all ActionScript ByteCode (ABC) från de externt inlästa SWF-filerna till huvudprogrammet för SWF och lämnar en SWF-fil som endast innehåller resurser. Detta görs för att anpassa till regelverket för Apple Store som förbjuder att kod laddas ned sedan programmet har installerats.

ADT gör efterföljande för att stödja externt inlästa SWF-filer (kallas även för "strippade" SWF-filer):

• Läser in textfilen som anges i <iPhone> -elementets <externalSwfs> -delelement för att komma åt den radavgränsade listan med SWF-filer som ska läsas under körningen:

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

• Överför ABC-koden från varje externt inläst SWF-fil till huvudfilen.

• Utelämnar den externt inlästa SWF-filen från .ipa-filen.

• Kopierar de strippade SWF-filerna till .remoteStrippedSWFs -katalogen. Du har dessa SWF-filer på en webbserver och programmet läser in dem vid behov under körningen.

Du anger vilka SWF-filer som ska läsas in under körningen genom att ange deras namn, en per rad i en textfil. Se följande exempel:

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

Den angivna filsökvägen är relativ till programbeskrivningsfilen. Dessutom måste du ange dessa SWF-filer som resurser i adt -kommandot.

Mer information om den här funktionen, inklusive exempelkod, finns i External hosting of secondary SWFs for AIR apps on iOS , en blogg som drivs av Adobe-teknikern Abhinav Dhandh.

För Geolocation-stöd ska du lägga till ett av följande nyckelvärdepar i elementet 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>