Elementy deskryptora aplikacji AIR

Umożliwia interfejsowi API środowiska AIR w przeglądarce wykrywanie i uruchamianie aplikacji.

Jeśli dla tej wartości zostanie ustawiona wartość true , wówczas należy rozważyć zagadnienia związane z bezpieczeństwem. Zostały one opisane w sekcji Wywoływanie aplikacji AIR z przeglądarki (dla programistów ActionScript) oraz w sekcji Wywoływanie aplikacji AIR z przeglądarki (dla programistów HTML).

Więcej informacji zawiera sekcja Uruchamianie zainstalowanej aplikacji AIR z przeglądarki .

Element macierzysty: application

Elementy potomne: brak

<allowBrowserInvocation>true</allowBrowserInvocation>

Umożliwia dodawanie elementów do pliku manifestu systemu Android. Środowisko AIR tworzy plik AndroidManifest.xml dla każdego pakietu APK. Korzystając z elementu android w deskryptorze aplikacji AIR, można dodawać do tego pliku dodatkowe elementy. Ten element jest ignorowany na wszystkich platformach poza platformą Android.

Element macierzysty: application

Elementy potomne:

• colorDepth

• manifestAdditions

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

Główny element dokumentu deskryptora aplikacji AIR.

Element macierzysty: brak

Elementy potomne:

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

Określa proporcje aplikacji.

Jeśli ten element nie został określony, aplikacja jest otwierana w „naturalnych” proporcjach i w naturalnej orientacji urządzenia. Naturalna orientacja zależy od urządzenia. Zazwyczaj na urządzeniach z niewielkim wyświetlaczem, takich jak telefony, są to proporcje pionowe. Na niektórych urządzeniach, takich jak tablet iPad, aplikacja jest otwierana w bieżącej orientacji. W środowisku AIR 3.3 lub nowszym ma to zastosowanie do całej aplikacji, nie tylko do początkowego formatu wyświetlania.

Element macierzysty: initialWindow

Elementy potomne: brak

<aspectRatio>landscape</aspectRatio>

Określa, czy orientacja bieżącej zawartości aplikacji jest automatycznie zmieniana wraz ze zmianą orientacji fizycznej urządzenia. Więcej informacji zawiera artykuł Orientacja stołu montażowego .

W przypadku używania automatycznej orientacji należy wziąć pod uwagę ustawienie właściwości align i scaleMode stołu montażowego w następujący sposób:

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

Te ustawienia pozwalają aplikacji na obracanie dookoła górnego lewego rogu i uniemożliwiają automatyczne skalowanie zawartości aplikacji. W innych trybach skalowania zawartość aplikacji jest dopasowywana do obróconych wymiarów stołu montażowego, ale jest ona również przycinana, zniekształcana lub nadmiernie zmniejszana. Prawie zawsze można osiągnąć lepsze wyniki, samodzielnie ponownie rysując zawartość lub zmieniając jej układ.

Element macierzysty: initialWindow

Elementy potomne: brak

<autoOrients>true</autoOrients>

Określa, czy mają być używane kolory 16-bitowe, czy 32-bitowe.

Stosowanie kolorów 16-bitowych może zwiększyć wydajność renderowania, lecz obniża jakość kolorów. W wersjach wcześniejszych niż AIR 3 kolory 16-bitowe są zawsze używane w systemie Android. W środowisku AIR 3 są domyślnie używane kolory 32-bitowe.

Element macierzysty: android

Elementy potomne: brak

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

Określa, czy aplikacja zawiera elementy wideo.

Element macierzysty: android

Elementy potomne: brak

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

Wartość określona dla elementu content jest adresem URL głównego pliku zawartości aplikacji. Może to być plik SWF lub HTML. Adres URL jest określony względem głównego katalogu folderu instalacyjnego aplikacji. (W przypadku uruchomienia aplikacji AIR za pomocą programu ADL adres URL jest określony względem folderu zawierającego plik deskryptora aplikacji. W celu określenia innego katalogu głównego należy określić parametr root-dir programu ADL).

Element macierzysty: initialWindow

Elementy potomne: brak

<content>TravelPlanner.swf</content>

Właściwość contentType jest wymagana w środowisku AIR 1.5 lub nowszym. (Była ona właściwością opcjonalną w środowisku AIR 1.0 i 1.1). Ta właściwość pomaga niektórym systemom operacyjnym zlokalizować najlepszą aplikację do otwarcia pliku. Wartość powinna być typem MIME dla treści pliku. Należy zauważyć, że wartość jest ignorowana w systemie Linux, jeśli typ pliku jest już zarejestrowany i ma przypisany typ MIME.

Element macierzysty: fileType

Elementy potomne: brak

<contentType>text/plain</contentType>

Informacje o prawach autorskich dotyczących aplikacji AIR. W systemie Mac OS tekst dotyczący praw autorskich pojawia się w oknie dialogowym informacji dla zainstalowanej aplikacji. W systemie Mac OS informacje o prawach autorskich są również wykorzystywane w polu NSHumanReadableCopyright w pliku Info.plist aplikacji.

Element macierzysty: application

Elementy potomne: brak

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

Określa, czy aplikacja zapewnia własne okna dialogowe aktualizacji. W przypadku wartości false środowisko AIR przedstawia użytkownikowi standardowe okna dialogowe aktualizacji. Z wbudowanego systemu aktualizacji środowiska AIR mogą korzystać wyłącznie aplikacje rozpowszechniane w postaci plików AIR.

Jeśli element customUpdateUI zainstalowanej wersji aplikacji jest ustawiony na true , a użytkownik kliknie dwukrotnie plik AIR dla nowej wersji lub zainstaluje aktualizację aplikacji za pomocą funkcji instalacji bezproblemowej, wówczas środowisko operacyjne otworzy zainstalowaną wersję aplikacji. Środowisko wykonawcze nie otwiera domyślnego instalatora aplikacji AIR. Logika aplikacji może wówczas określić sposób kontynuowania operacji aktualizacji. (Identyfikator aplikacji i identyfikator wydawcy w pliku AIR muszą być zgodne z identyfikatorami w zainstalowanej aplikacji — tylko wówczas możliwe będzie kontynuowanie aktualizacji).

Więcej informacji zawiera sekcja Aktualizowanie aplikacji AIR .

Element macierzysty: application

Elementy potomne: brak

<customUpdateUI>true</customUpdateUI>

Wskazuje, że aplikacja wymaga zastosowania bufora głębi lub bufora szablonu. Te bufory są zazwyczaj używane podczas pracy z zawartością 3D. Domyślnie ten element ma wartość false w celu wyłączenia bufora głębi i bufora szablonu. Ten element jest potrzebny, gdyż bufory należy przydzielić podczas uruchamiania aplikacji — przed wczytaniem zawartości.

Ustawienie tego elementu musi odpowiadać wartości przekazanej w argumencie enableDepthAndStencil do metody Context3D.configureBackBuffer() . Jeśli te wartości nie są zgodne, środowisko AIR generuje błąd.

Ten element ma zastosowanie jedynie w sytuacji, gdy renderMode = direct . Jeśli właściwość renderMode nie ma wartości direct , narzędzie ADT generuje błąd 118.

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

Element macierzysty: initialWindow

Elementy potomne: brak

<depthAndStencil>true</depthAndStencil>

Opis aplikacji wyświetlany w instalatorze aplikacji AIR.

Po określeniu pojedynczego węzła text (zamiast wielu elementów text) instalator aplikacji AIR korzysta z tego opisu bez względu na język systemu. W przeciwnym razie instalator aplikacji AIR korzysta z opisu, który jest najbliższy językowi interfejsu systemu operacyjnego użytkownika. Załóżmy na przykład, że w instalacji element description pliku deskryptora aplikacji zawiera wartość ustawień regionalnych en (angielski). Instalator aplikacji AIR korzysta z opisu en pod warunkiem, że system użytkownika identyfikuje en (angielski) jako język interfejsu użytkownika. Ten instalator korzysta z opisu en również wówczas, gdy język interfejsu systemu operacyjnego to en-US (angielski USA). Jeśli jednak język interfejsu użytkownika to en-US, a plik deskryptora aplikacji definiuje nazwy en-US i en-GB, wówczas instalator aplikacji AIR korzysta z wartości en-US. Jeśli aplikacja nie definiuje opisu zgodnego z językiem interfejsu użytkownika systemu, wówczas instalator aplikacji AIR korzysta z pierwszej wartości description zdefiniowanej w pliku deskryptora aplikacji.

Więcej informacji na temat programowania aplikacji wielojęzycznych zawiera sekcja Lokalizowanie aplikacji AIR .

Element macierzysty: application

Elementy potomne: 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> 

Opis typu pliku jest wyświetlany użytkownikowi przez system operacyjny. Opisu typu pliku nie można lokalizować.

Dodatkowe informacje zawiera sekcja Element description jako element potomny elementu application.

Element macierzysty: fileType

Elementy potomne: brak

<description>PNG image</description>

Umożliwia zastosowanie czcionek niestandardowych do obiektu StageText w aplikacji AIR. Ten element jest opcjonalny.

Element macierzysty: application

Elementy potomne: czcionka

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

W systemie iOS są używane właściwości określane jako uprawnienia, które pozwalają aplikacji uzyskać dostęp do dodatkowych zasobów i funkcji. W aplikacji dla urządzeń przenośnych z systemem iOS można podać te informacje za pomocą elementu Entitlements.

Element macierzysty: iPhone

Elementy potomne: Elementy pliku Entitlements.plist systemu iOS

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

Ciąg rozszerzenia typu pliku.

Element macierzysty: fileType

Elementy potomne: brak

<extension>png</extension>

Określa identyfikator rozszerzenia języka ActionScript używanego przez aplikację. Ten identyfikator jest definiowany w dokumencie deskryptora aplikacji.

Element macierzysty: extensions

Elementy potomne: brak

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

Określa rozszerzenia języka ActionScript używane przez aplikację.

Element macierzysty: application

Elementy potomne: extensionID

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

Określa nazwę pliku tekstowego, który zawiera listę plików SWF do skonfigurowania przez ADT na potrzeby zdalnego przechowywania. Aby zminimalizować wstępny rozmiar pobieranej aplikacji, można spakować podzbiór plików SWF używanych przez aplikację, a do wczytywania pozostałych zewnętrznych plików SWF (zawierających tylko zasoby) stosować metodę Loader.load() w czasie wykonywania. W celu skorzystania z tej funkcji trzeba spakować aplikację w taki sposób, aby narzędzie ADT przeniosło cały kod bajtowy ActionScript (ABC) z zewnętrznych plików SWF do głównego pliku SWF aplikacji, co pozwoli uzyskać plik SWF zawierający tylko zasoby. Sposób ten zapewnia zgodność z obowiązującą w sklepie Apple Store regułą, która zabrania pobierania jakiegokolwiek kodu do zainstalowanej aplikacji.

Więcej informacji zawiera dokument Minimalizowanie ilości pobieranych danych przez wczytywanie zewnętrznych plików SWF zawierających tylko zasoby .

Element macierzysty: iPhone , initialWindow

Elementy potomne: brak

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

Ciąg znaków używany jako nazwa pliku aplikacji (bez rozszerzenia) po zainstalowaniu aplikacji. Plik aplikacji uruchamia aplikację AIR w środowisku wykonawczym. Jeśli nie określono wartości name , wówczas wartość filename jest używana również jako nazwa folderu instalacyjnego.

Element macierzysty: application

Elementy potomne: brak

<filename>MyApplication</filename>

Opisuje pojedynczy typ pliku, który może zostać zarejestrowany dla aplikacji.

Element macierzysty: fileTypes

Elementy potomne:

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

Element fileTypes umożliwia deklarowanie typów plików, z którymi można kojarzyć aplikacje AIR.

Po zainstalowaniu aplikacji AIR wszystkie zadeklarowane typy plików zostają zarejestrowane w systemie operacyjnym. Jeśli te typy plików nie są jeszcze skojarzone z inną aplikacją, wówczas są kojarzone z aplikacją AIR. W celu zastąpienia istniejącego skojarzenia między typem pliku a inną aplikacją należy użyć metody NativeApplication.setAsDefaultApplication() w środowisku wykonawczym (najlepiej za zgodą użytkownika).

Element fileTypes jest opcjonalny.

Element macierzysty: application

Elementy potomne: 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>

Opisuje pojedynczą czcionkę niestandardową, jakiej można użyć w aplikacji AIR.

Element macierzysty: embedFonts

Elementy potomne: fontName , fontPath

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

Określa nazwę czcionki niestandardowej.

element macierzysty: czcionka

Elementy potomne: brak

<fontName>space age</fontName> 

Podaje lokalizację pliku niestandardowych czcionek.

element macierzysty: czcionka

Elementy potomne: brak

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

Wymusza tryb renderowania z użyciem procesora dla określonego zbioru urządzeń. Ta funkcja umożliwia selektywne włączenie trybu renderowania GPU dla pozostałych urządzeń z systemem iOS.

Ten znacznik można dodać jako obiekt potomny znacznika iPhone , wskazując rozdzieloną spacjami listę nazw modeli urządzeń. Prawidłowe nazwy modeli urządzeń:

Element macierzysty: iPhone , initialWindow

Elementy potomne: brak

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

Określa, czy aplikacja jest uruchamiana w trybie pełnoekranowym.

Element macierzysty: initialWindow

Elementy potomne: brak

<fullscreen>true</fullscreen>

Początkowa wysokość głównego okna aplikacji.

Jeśli wysokość nie zostanie ustawiona, zostanie określona przez ustawienia w głównym pliku SWF, a w przypadku aplikacji AIR w języku HTML przez system operacyjny.

Maksymalna wysokość okna została zmieniona w środowisku AIR 2 z 2048 pikseli na 4096 pikseli.

Element macierzysty: initialWindow

Elementy potomne: brak

<height>4095</height>

Właściwość icon określa jeden lub większą liczbę plików ikon, jakie mogą być używane dla aplikacji. Dołączenie ikony jest opcjonalne. Jeśli właściwość icon nie zostanie określona, wówczas system operacyjny wyświetla ikonę domyślną.

Ścieżka jest określona względem katalogu głównego aplikacji. Pliki ikon muszą być w formacie PNG. Możliwe jest określenie ikon we wszystkich następujących rozmiarach:

Jeśli istnieje element określonego rozmiaru, obraz w pliku musi być dokładnie zgodny z określonym rozmiarem. Jeśli nie są dostępne wszystkie rozmiary, wówczas zmieniana jest skala rozmiaru najbliższego dla określonego zastosowania ikony przez system operacyjny.

W celu zapewnienia najlepszych rezultatów należy udostępnić obraz dla każdego z dostępnych rozmiarów. Ponadto należy się upewnić, że ikony wyglądają odpowiednio w trybach koloru 16- i 32-bitowego.

Element macierzysty: application

Elementy potomne: imageNxN

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

Ciąg znaków identyfikatora aplikacji, określany jako identyfikator aplikacji. Często jest używany identyfikator w odwrotnej notacji DNS, ale ten styl nie jest wymagany.

Element macierzysty: application

Elementy potomne: brak

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

Definiuje ścieżkę do ikony względem katalogu aplikacji.

Można używać następujących rozmiarów ikon, przy czym każdy określa inny rozmiar ikony:

• image16x16

• image29x29 (AIR 2 i nowsze wersje)

• image32x32

• image36x36 (AIR 2.5 i nowsze wersje)

• image48x48

• image50x50 (AIR 3.4 i nowsze wersje)

• image57x57 (AIR 2 i nowsze wersje)

• image58x58 (AIR 3.4 i nowsze wersje)

• image72x72 (AIR 2 i nowsze wersje)

• image100x100 (AIR 3.4 i nowsze wersje)

• image114x114 (AIR 2.6 i nowsze wersje)

• image128x128

• image144x144 (AIR 3.4 i nowsze wersje)

• image512x512 (AIR 2 i nowsze wersje)

• image1024x1024 (AIR 3.4 i nowsze wersje)

Ikona musi być grafiką PNG o rozmiarze dokładnie takim, jaki określono w elemencie image. Pliki ikon muszą być dołączone do pakietu aplikacji. Ikony, których dotyczą odniesienia w dokumencie deskryptora aplikacji, nie są automatycznie dołączane.

Element macierzysty: application

Elementy potomne: brak

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

Umożliwia określanie dodatkowych właściwości aplikacji systemu iOS.

Element macierzysty: iPhone

Elementy potomne: Elementy pliku Info.plist systemu iOS

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

Definiuje główny plik zawartości i początkowy wygląd aplikacji.

Element macierzysty: 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>

Identyfikuje podkatalog domyślnego katalogu instalacyjnego.

W systemie Windows domyślnym folderem instalacyjnym jest katalog Program Files. W systemie Mac OS jest to katalog /Applications. W systemie Linux jest to katalog /opt/. Na przykład: jeśli właściwość installFolder jest ustawiona na "Acme" , a aplikacja ma nazwę "ExampleApp" , wówczas aplikacja zostanie zainstalowana w folderze C:\Program Files\Acme\ExampleApp w systemie Windows, w folderze /Applications/Acme/Example.app w systemie MacOS i w folderze /opt/Acme/ExampleApp w systemie Linux.

Właściwość installFolder jest opcjonalna. Jeśli właściwość installFolder nie zostanie określona, wówczas aplikacja zostanie zainstalowana w domyślnym katalogu instalacyjnym, zgodnie z właściwością name .

Element macierzysty: application

Elementy potomne: brak

<installFolder>utilities/toolA</installFolder>

Definiuje właściwości aplikacji specyficzne dla systemu iOS.

Element macierzysty: application

Określa informacje, które mają zostać dodane do pliku manifestu systemu Android dla aplikacji.

Element macierzysty: manifestAdditions

Elementy potomne: Elementy zdefiniowane przez zestaw SDK systemu Android.

<![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> 
]]>

Określa informacje, które mają zostać dodane do pliku manifestu systemu Android.

Każda aplikacja dla systemu Android zawiera plik manifestu, który definiuje podstawowe właściwości aplikacji. Manifest systemu Android jest oparty na podobnym pomyśle co deskryptor aplikacji AIR. Aplikacja AIR dla systemu Android ma zarówno deskryptor aplikacji, jak i automatycznie tworzony plik manifestu systemu Android. Gdy aplikacja AIR dla systemu Android jest pakowana, informacje w tym elemencie manifestAdditions są dodawane do odpowiednich części dokumentu manifestu Android.

Element macierzysty: android

Elementy potomne: manifest

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

Określa, czy można maksymalizować okno.

Element macierzysty: initialWindow

Elementy potomne: brak

<maximizable>false</maximizable>

Maksymalne rozmiary okna. Jeśli rozmiar maksymalny nie zostanie ustawiony, określi go system operacyjny.

Element macierzysty: initialWindow

Elementy potomne: brak

<maxSize>1024 360</maxSize>

Określa, czy można minimalizować okno.

Element macierzysty: initialWindow

Elementy potomne: brak

<minimizable>false</minimizable>

Określa minimalny rozmiar dozwolony dla okna.

Element macierzysty: initialWindow

Elementy potomne: brak

<minSize>120 60</minSize>

Tytuł aplikacji wyświetlany w instalatorze aplikacji AIR.

Jeśli nie określono elementu name , instalator aplikacji AIR wyświetla wartość filename jako nazwę pliku.

Element macierzysty: application

Elementy potomne: 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> 

Określa nazwę typu pliku.

Element macierzysty: fileType

Elementy potomne: brak

<name>adobe.VideoFile</name>

Określa lokalizację, w której należy umieścić skróty do aplikacji, jakie będą dostępne w menu Wszystkie programy systemu operacyjnego Windows lub Applications (Aplikacje) systemu Linux. (To ustawienie jest aktualnie ignorowane w innych systemach operacyjnych).

Element macierzysty: application

Elementy potomne: brak

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

Określa identyfikator wydawcy w przypadku aktualizacji aplikacji AIR utworzonej pierwotnie za pomocą środowiska AIR 1.5.2 lub starszego.

W przypadku tworzenia aktualizacji aplikacji określa wyłącznie identyfikator wydawcy. Wartość elementu publisherID musi być zgodna z identyfikatorem wydawcy utworzonym przez środowisko AIR dla wcześniejszej wersji tej aplikacji. W przypadku zainstalowanej aplikacji identyfikator wydawcy można znaleźć w pliku META-INF/AIR/publisherid w folderze, w którym zainstalowano aplikację.

Nowe aplikacje utworzone za pomocą środowiska AIR 1.5.3 lub nowszego nie powinny określać identyfikatora wydawcy.

Więcej informacji zawiera sekcja Informacje o identyfikatorach wydawców AIR .

Element macierzysty: application

Elementy potomne: brak

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

Określa, czy jeśli w systemie jest obsługiwane przyspieszanie za pomocą GPU, to ma ono być stosowane.

Element macierzysty: initialWindow

Elementy potomne: brak

<renderMode>direct</renderMode>

Określa, czy na urządzeniu lub komputerze wyposażonym w wyświetlacz o wysokiej rozdzielczości aplikacja dąży do stosowania rozdzielczości standardowej czy wysokiej. Po ustawieniu wartości standard , która jest wartością domyślną, ekran jest widoczny dla aplikacji jako ekran o standardowej rozdzielczości. Po ustawieniu wartości high aplikacja może odwoływać się do każdego piksela w wysokiej rozdzielczości.

Jeśli na przykład na telefonie iPhone z ekranem o rozdzielczości 640x960 jest ustawiona wartość standard , stół montażowy zajmujący cały ekran ma wymiary 320x480, a każdy piksel aplikacji jest renderowany jako cztery piksele ekranu. W przypadku ustawienia high stół montażowy zajmujący cały ekran ma wymiary 640x960.

Na urządzeniach z ekranem o standardowej rozdzielczości wymiary stołu montażowego są zgodne z wymiarami ekranu niezależnie od tego, które ustawienie jest używane.

Jeśli element requestedDisplayResolution jest zagnieżdżony w elemencie iPhone , jest stosowany dla urządzeń z systemem iOS. W takiej sytuacji za pomocą atrybutu excludeDevices można wskazać urządzenia, dla których nie jest stosowane to ustawienie.

Jeśli element requestedDisplayResolution jest zagnieżdżony w elemencie initialWindow , jest stosowany w przypadku aplikacji komputerowych AIR na komputerach MacBook Pro, które obsługują wyświetlacze o wysokiej rozdzielczości. Określona wartość dotyczy wszystkich okien natywnych używanych w aplikacji. Zagnieżdżenie elementu requestedDisplayResolution w elemencie initialWindow jest obsługiwane od wersji 3.6 środowiska AIR.

Element macierzysty: iPhone , initialWindow

Elementy potomne: brak

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

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

Określa, czy można zmieniać rozmiar okna.

Element macierzysty: initialWindow

Elementy potomne:

<resizable>false</resizable>

Określa domyślny sposób działania aplikacji, gdy jest wyświetlana klawiatura wirtualna. Domyślnym zachowaniem jest przesunięcie aplikacji do góry. Środowisko wykonawcze utrzymuje aktywne pole tekstowe lub obiekt interaktywny na ekranie. Jeśli aplikacja nie posiada własnej logiki obsługi klawiatury, można użyć opcji pan .

Można również wyłączyć domyślne zachowanie, ustawiając dla elementu softKeyboardBehavior wartość none . W takiej sytuacji uniesienie klawiatury programowej spowoduje wywołanie zdarzenia SoftKeyboardEvent przez pola tekstowe i obiekty interaktywne, ale środowisko wykonawcze nie przesunie aplikacji ani nie zmieni jej rozmiaru. To aplikacja będzie odpowiedzialna za zachowanie widoczności obszaru wprowadzania tekstu.

Element macierzysty: initialWindow

Elementy potomne: brak

<softKeyboardBehavior>none</softKeyboardBehavior>

Identyfikuje języki obsługiwane przez aplikację. Ten element jest używany tylko w systemie iOS, środowisku dołączanym dla komputerów Mac i aplikacjach dla systemu Android. Ten element jest ignorowany w aplikacjach wszystkich innych typów.

Jeśli ten element nie zostanie określony, pakowacz domyślnie wykona następujące operacje zależnie od typu aplikacji:

Element macierzysty: application

Elementy potomne: brak

<supportedLanguages>en ja fr es</supportedLanguages>

Określa profile obsługiwane dla danej aplikacji.

Element macierzysty: application

Elementy potomne: brak

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

<supportedProfiles>desktop mobileDevice</supportedProfiles>

Określa, czy tworzone początkowe okno aplikacji zawiera standardowy pasek tytułu, krawędzie i elementy sterujące oferowane przez system operacyjny.

W środowisku wykonawczym nie można zmieniać ustawienia karnacji systemowej okna.

Element macierzysty: initialWindow

Elementy potomne: brak

<systemChrome>standard</systemChrome>

Określa ciąg zlokalizowany.

Atrybut xml:lang elementu text określa kod języka zdefiniowany w normie RFC4646 (http://www.ietf.org/rfc/rfc4646.txt).

Instalator aplikacji AIR korzysta z elementu text wraz z wartością atrybutu xml:lang , która najbardziej pasuje do języka interfejsu użytkownika systemu operacyjnego tego użytkownika.

Na przykład w pewnej instalacji element text zawiera wartość dla ustawienia regionalnego en (angielski). Instalator aplikacji AIR korzysta z nazwy en pod warunkiem, że system operacyjny identyfikuje en (angielski) jako język interfejsu użytkownika. Korzysta z nazwy en również wówczas, gdy język interfejsu systemu operacyjnego to en-US (angielski USA). Jeśli jednak język interfejsu użytkownika to en-US, a plik deskryptora aplikacji definiuje nazwy en-US i en-GB, wówczas instalator aplikacji AIR korzysta z wartości en-US.

Jeśli aplikacja nie definiuje elementu text zgodnego z językami interfejsu użytkownika systemu, wówczas instalator aplikacji AIR korzysta z pierwszej wartości name zdefiniowanej w pliku deskryptora aplikacji.

Elementy potomne: brak

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

Określa tytuł wyświetlany na pasku tytułu początkowego okna aplikacji.

Tytuł jest wyświetlany wyłącznie wówczas, gdy dla elementu systemChrome jest ustawiona wartość standard .

Element macierzysty: initialWindow

Elementy potomne: brak

<title>Example Window Title</title>

Określa, czy dla początkowego okna aplikacji jest stosowane mieszanie alfa z pulpitem.

Okno, dla którego włączono przezroczystość, może być wyświetlane wolniej i wymagać większej ilości pamięci. Ustawienia przezroczystości nie można zmienić w środowisku wykonawczym.

Element macierzysty: initialWindow

Elementy potomne: brak

<transparent>true</transparent>

Określa informacje o wersji aplikacji.

Ciąg znaków wersji jest specyfikatorem zdefiniowanym w aplikacji. Środowisko AIR w żaden sposób nie interpretuje ciągu znaków wersji. Dlatego wersja „3.0” nie jest w żaden sposób traktowana jako bardziej aktualna niż wersja „2.0”. Przykłady: "1.0" , ".4" , "0.5" , "4.9" , "1.3.4a" .

W środowisku AIR 2.5 i nowszych wersjach element version został zastąpiony elementami versionNumber i versionLabel .

Element macierzysty: application

Elementy potomne: brak

<version>0.1 Alpha</version>

Określa ciąg wersji przeznaczony do odczytu przez użytkowników.

W oknach dialogowych instalacji zamiast wartości elementu versionNumber jest wyświetlana wartość etykiety wersji. Jeśli element versionLabel nie jest używany, wówczas w obu tych przypadkach jest stosowana wartość elementu versionNumber .

Element macierzysty: application

Elementy potomne: brak

<versionLabel>0.9 Beta</versionlabel>

Numer wersji aplikacji.

Element macierzysty: application

Elementy potomne: brak

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

Określa, czy początkowe okno aplikacji jest widoczne od razu po utworzeniu.

Domyślnie okna aplikacji AIR, łącznie z oknami początkowymi, są tworzone w stanie niewidocznym. Okno można wyświetlić przez wywołanie metody activate() obiektu NativeWindow lub ustawienie dla właściwości visible wartości true . Okno główne może być początkowo ukryte — wówczas zmiany położenia i wielkości okna oraz układu składników w oknie nie będą widoczne od razu.

Składnik mx:WindowedApplication środowiska Flex automatycznie wyświetla i aktywuje okno bezpośrednio przed wywołaniem zdarzenia applicationComplete , chyba że atrybut visible w definicji MXML ma wartość false .

Na urządzeniach z profilami mobile, które nie obsługują okien, ustawienie visible jest ignorowane.

Element macierzysty: initialWindow

Elementy potomne: brak

<visible>true</visible>

Początkowa szerokość głównego okna aplikacji.

Jeśli szerokość nie zostanie ustawiona, zostanie określona przez ustawienia w głównym pliku SWF, a w przypadku aplikacji AIR opartych na języku HTML — przez system operacyjny.

Maksymalna szerokość okna została zmieniona w środowisku AIR 2 z 2048 pikseli na 4096 pikseli.

Element macierzysty: initialWindow

Elementy potomne: brak

<width>1024</width>

Pozioma pozycja początkowego okna aplikacji.

W większości przypadków lepiej jest pozwolić systemowi operacyjnemu na określenie początkowej pozycji okna, niż przypisać stałą wartość.

Początek układu współrzędnych ekranu (0,0) znajduje się w lewym górnym rogu ekranu (tak jak określa to system operacyjny).

Element macierzysty: initialWindow

Elementy potomne: brak

<x>120</x>

Pionowa pozycja początkowego okna aplikacji.

W większości przypadków lepiej jest pozwolić systemowi operacyjnemu na określenie początkowej pozycji okna, niż przypisać stałą wartość.

Początek układu współrzędnych ekranu (0,0) znajduje się w lewym górnym rogu ekranu (tak jak określa to system operacyjny).

Element macierzysty: initialWindow

Elementy potomne: brak

<y>250</y>