Elemente des AIR-Anwendungsdeskriptors

Ermöglicht der AIR „in-browser“-API, die Anwendung zu erkennen und zu starten.

Wenn Sie diesen Wert auf true setzen, beachten Sie unbedingt die Auswirkungen auf die Sicherheit. Diese sind beschrieben unter Aufrufen von AIR-Anwendungen aus dem Browser (für ActionScript-Entwickler) und Invoking an AIR application from the browser (für HTML-Entwickler).

Weitere Informationen finden Sie unter Aufrufen installierter AIR-Anwendungen vom Browser .

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<allowBrowserInvocation>true</allowBrowserInvocation>

Ermöglicht das Hinzufügen von Elementen zur Android-Manifestdatei. AIR erstellt die Datei „AndroidManifest.xml“ für jedes APK-Paket. Sie können das android-Element im AIR-Anwendungsdeskriptor verwenden, um diesem zusätzliche Elemente hinzuzufügen. Wird auf allen Plattformen außer bei Android ignoriert.

Übergeordnetes Element: application

Untergeordnete Elemente:

• colorDepth

• manifestAdditions

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

Das Stammelement eines AIR-Anwendungsdeskriptordokuments.

Übergeordnetes Element: Ohne

Untergeordnete Elemente:

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

Gibt das Seitenverhältnis der Anwendung an.

Falls dies nicht angegeben ist, wird die Anwendung im „natürlichen“ Seitenverhältnis und Ausrichtung des Geräts geöffnet. Die natürliche Ausrichtung variiert von Gerät zu Gerät. Normalerweise ist dies bei Geräten mit kleinem Bildschirm, zum Beispiel bei Telefonen, das Hochformat. Bei einigen Geräten, zum Beispiel beim iPad-Tablet, wird die Anwendung in der aktuellen Ausrichtung geöffnet. In AIR 3.3 und höher gilt dies für die gesamte Anwendung, nicht nur die anfängliche Anzeige.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<aspectRatio>landscape</aspectRatio>

Legt fest, ob die Ausrichtung des Inhalts in der Anwendung automatisch angepasst werden soll, wenn die physische Ausrichtung des Geräts geändert wird. Weitere Informationen finden Sie unter Bühnenausrichtung .

Wenn Sie die automatische Ausrichtung verwenden, ziehen Sie in Betracht, die Stage-Eigenschaften align und scaleMode auf Folgendes einzustellen:

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

Mit diesen Einstellungen kann die Anwendung um die obere linke Ecke gedreht werden und es wird verhindert, dass die Anwendungsinhalte automatisch skaliert werden. Die anderen Skalierungsmodi passen den Inhalt zwar an die gedrehten Bühnenabmessungen an, allerdings beschneiden, verzerren oder verkleinern sie den Inhalt auch übermäßig. So gut wie immer lassen sich bessere Ergebnisse erzielen, wenn Sie den Inhalt selbst neu zeichnen oder anordnen.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<autoOrients>true</autoOrients>

Gibt an, ob der 16-Bit- oder 32-Bit-Farbmodus verwendet werden soll.

Die Verwendung der 16-Bit-Farbtiefe kann die Renderingleistung zwar verbessern, allerdings geht dies auf Kosten der Farbtreue. In Versionen vor AIR 3 wird unter Android immer der 16-Bit-Farbmodus verwendet. In AIR 3 wird standardmäßig der 32-Bit-Farbmodus verwendet.

Übergeordnetes Element: android

Untergeordnete Elemente: keine

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

Gibt an, ob die Anwendung Videoinhalte oder nicht enthält.

Übergeordnetes Element: android

Untergeordnete Elemente: keine

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

Der im Element content angegebene Wert bezeichnet die URL der Hauptinhaltsdatei der Anwendung. Das kann entweder eine SWF- oder eine HTML-Datei sein. Die URL wird relativ zum Installationsstammordner der Anwendung angegeben. (Wenn Sie eine AIR-Anwendung mit ADL ausführen, ist die URL relativ zum Ordner mit der Anwendungsdeskriptordatei. Mithilfe des ADL-Parameters root-dir können Sie ein anderes Stammverzeichnis angeben.)

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<content>TravelPlanner.swf</content>

contentType ist ab AIR 1.5 erforderlich (optional in AIR 1.0 und 1.1). Die Eigenschaft hilft einigen Betriebssystemen beim Finden der besten Anwendung zum Öffnen einer Datei. Als Wert für diese Eigenschaft sollte der MIME-Typ des Dateiinhalts angegeben werden. Beachten Sie, dass der Wert unter Linux ignoriert wird, wenn der Dateityp bereits registriert wurde und ihm ein MIME-Typ zu geordnet ist.

Übergeordnetes Element: fileType

Untergeordnete Elemente: keine

<contentType>text/plain</contentType>

In diesem Element werden die Copyright-Hinweise für die AIR-Anwendung angegeben. Unter Mac OS erscheint der Copyright-Text im Dialogfeld „Info“ der installierten Anwendung. Unter Mac OS wird der Copyright-Text auch im NSHumanReadableCopyright-Feld der Info.plist-Datei der Anwendung verwendet.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

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

Gibt an, ob eine Anwendung ihre eigenen Update-Dialogfelder bereitstellt. Bei der Einstellung false zeigt AIR dem Benutzer standardmäßige Update-Dialogfelder an. Nur als AIR-Dateien verteilte Anwendungen können das integrierte AIR-Updatesystem verwenden.

Wenn für die installierte Version Ihrer Anwendung das Element customUpdateUI auf true gesetzt ist und der Benutzer für eine neue Version auf die AIR-Datei doppelklickt oder anhand der nahtlosen Installationsfunktion ein Anwendungsupdate installiert, öffnet die Laufzeitumgebung die installierte Version der Anwendung. Die Laufzeit öffnet nicht das standardmäßige AIR-Anwendungsinstallationsprogramm. Die Anwendungslogik kann dann feststellen, wie mit der Updateoperation zu verfahren ist. (Die Anwendungs-ID und Herausgeber-ID in der AIR-Datei müssen den Werten in der installierten Anwendung entsprechen, damit das Update fortgesetzt wird.)

Weitere Informationen hierzu finden Sie unter Aktualisieren von AIR-Anwendungen .

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<customUpdateUI>true</customUpdateUI>

Gibt an, dass die Anwendung die Verwendung des Tiefen- oder Schablonenpuffers erfordert. Diese Puffer werden normalerweise bei der Arbeit mit 3D-Inhalten verwendet. Standardmäßig hat dieses Element den Wert false , um die Tiefen- und Schablonenpuffer zu deaktivieren. Dieses Element ist erforderlich, da die Puffer beim Starten der Anwendung zugewiesen werden müssen, bevor Inhalte geladen werden.

Die Einstellung dieses Elements muss dem Wert entsprechen, der für das enableDepthAndStencil -Argument an die Context3D.configureBackBuffer() -Methode übergeben wurde. Wenn die Werte nicht übereinstimmen, gibt AIR einen Fehler aus.

Dieses Element gilt nur, wenn renderMode den Wert direct hat. Wenn renderMode nicht den Wert direct aufweist, gibt ADT den Fehler 118 aus:

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

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<depthAndStencil>true</depthAndStencil>

Die im AIR-Anwendungsinstallationsprogramm angezeigte Beschreibung.

Wenn Sie einen einzelnen text-Knoten angeben (anstelle mehrerer text-Elemente), verwendet das AIR-Anwendungsinstallationsprogramm diese Beschreibung, und zwar ungeachtet der Sprache des Systems. Andernfalls verwendet das Anwendungsinstallationsprogramm der AIR-Anwendung die Beschreibung, deren Sprache der des Betriebssystems des Benutzers am ehesten entspricht. Angenommen, es wird eine Anwendung installiert, in der das description -Element der Anwendungsdeskriptordatei den Wert „en“ für das englische Gebietsschema enthält. Das AIR-Anwendungsinstallationsprogramm verwendet dann die en-Beschreibung, wenn das Benutzerbetriebssystem en (Englisch) als die Sprache der Benutzeroberfläche identifiziert. Es verwendet die en-Beschreibung aber auch, wenn die Sprache der Benutzeroberfläche en-US (amerikanisches Englisch) ist. Wenn jedoch die Sprache der Benutzeroberfläche en-US ist, und die Anwendungsdeskriptordatei Namen sowohl für en-US als auch für en-GB definiert, so verwendet das AIR-Anwendungsinstallationsprogramm den en-US-Wert. Wenn in der Anwendung keine Beschreibung definiert ist, die der Benutzeroberfläche des Systems entspricht, verwendet das AIR-Anwendungsinstallationsprogramm den ersten in der Anwendungsdeskriptordatei für description definierten Wert.

Weitere Informationen zum Entwickeln mehrsprachiger Anwendungen finden Sie unter Lokalisieren von AIR-Anwendungen .

Übergeordnetes Element: application

Untergeordnete Elemente: 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> 

Die Dateitypbeschreibung wird dem Benutzer vom Betriebssystem angezeigt. Die Dateitypbeschreibung kann nicht lokalisiert werden.

Siehe auch: description als untergeordnetes Element des application-Elements

Übergeordnetes Element: fileType

Untergeordnete Elemente: keine

<description>PNG image</description>

Mit dieser Option können Sie in der AIR-Anwendung in StageText benutzerdefinierte Schriftarten verwenden. Dieses Element ist optional.

Übergeordnetes Element: application

Untergeordnete Elemente: font

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

iOS verwendet Eigenschaften, die Entitlements (Berechtigungen) genannt werden, um Anwendungen den Zugriff auf zusätzliche Ressourcen und Fähigkeiten zu ermöglichen. Mit dem Entitlements-Element können Sie diese Informationen in einer mobilen iOS-Anwendung angeben.

Übergeordnetes Element: iPhone

Untergeordnete Elemente: iOS Entitlements.plist-Elemente

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

Der Erweiterungsstring eines Dateityps.

Übergeordnetes Element: fileType

Untergeordnete Elemente: keine

<extension>png</extension>

Gibt die ID einer ActionScript-Erweiterung an, die von der Anwendung verwendet wird. Die ID wird im Erweiterungsdeskriptordokument definiert.

Übergeordnetes Element: extensions

Untergeordnete Elemente: keine

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

Identifiziert die von der Anwendung verwendeten ActionScript-Erweiterungen.

Übergeordnetes Element: application

Untergeordnete Elemente: extensionID

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

Gibt den Namen einer Textdatei an, die eine Liste von SWF-Dateien, die durch ADT für Remote-Hosting konfiguriert werden sollen, enthält. Sie können Ihre anfängliche Downloadgröße für die Anwendung minimieren, indem Sie einen Teilsatz der SWF-Dateien, die von Ihrer Anwendung verwendet wird, komprimieren und die verbleibenden (nur für das Element) externen SWF-Dateien zur Laufzeit mithilfe der Loader.load() -Methode laden. Um diese Funktion verwenden zu können, müssen Sie die Anwendung so komprimieren, dass ADT alle ActionScript-ByteCode (ABC) aus den extern geladenen SWF-Dateien in die SWF-Dateien der Hauptanwendung verschiebt, wobei eine SWF-Datei, die nur Elemente enthält, verbleibt. Das entspricht der Regel des Apple Stores, die besagt, das nach dem Installieren einer Anwendung kein Code heruntergeladen werden darf.

Weitere Informationen finden Sie unter Minimieren der Downloadgröße durch Laden externer (nur für das Element) SWF-Dateien .

Übergeordnetes Element: iPhone , initialWindow

Untergeordnete Elemente: keine

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

Ein String, der als Dateiname der Anwendung verwendet wird (ohne Erweiterung), wenn die Anwendung installiert wird. Die Anwendungsdatei lädt die AIR-Anwendung in die Laufzeitumgebung. Wird kein Wert für das Element name angegeben, wird der Wert im Element filename auch als Name des Installationsordners verwendet.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<filename>MyApplication</filename>

Beschreibt einen einzelnen Dateityp, den die Anwendung registrieren kann.

Übergeordnetes Element: fileTypes

Untergeordnete Elemente:

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

Das Element fileTypes erlaubt die Deklaration der Dateitypen, mit denen eine AIR-Anwendung verknüpft werden kann.

Wenn eine AIR-Anwendung installiert wird, wird jeder deklarierte Dateityp beim Betriebssystem registriert. Wenn diese Dateitypen nicht bereits mit anderen Anwendungen verknüpft sind, werden sie mit der AIR-Anwendung verknüpft. Um eine vorhandene Verknüpfung zwischen einem Dateityp und einer anderen Anwendung zu überschreiben, verwenden Sie zur Laufzeit (und vorzugsweise nach Einholung der Genehmigung des Benutzers) die Methode NativeApplication.setAsDefaultApplication() .

Das Element fileTypes ist optional.

Übergeordnetes Element: application

Untergeordnete Elemente: 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>

Beschreibt eine einzelne benutzerdefinierte Schriftart, die in der AIR-Anwendung verwendet werden kann.

Übergeordnetes Element: embedFonts

Untergeordnete Elemente: fontName , fontPath

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

Gibt den Namen der benutzerdefinierten Schriftart an.

Übergeordnetes Element: font

Untergeordnete Elemente: keine

<fontName>space age</fontName> 

Gibt den Speicherort der benutzerdefinierten Schriftarten-Datei an.

Übergeordnetes Element: font

Untergeordnete Elemente: keine

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

CPU-Rendermodus für einen festgelegten Gerätesatz erzwingen. Mit dieser Funktion können Sie selektiv den GPU-Rendermodus für die verbleibenden iOS-Geräte aktivieren.

Sie fügen diesen Tag als untergeordnetes Element des iPhone -Tags hinzu und geben eine Liste von durch Leerzeichen getrennte Gerätemodellnamen ein. Gültige Gerätenmodellnamen beinhalten Folgendes:

Übergeordnetes Element: iPhone , initialWindow

Untergeordnete Elemente: keine

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

Gibt an, ob die Anwendung im Vollbildmodus gestartet wird.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<fullscreen>true</fullscreen>

Die anfängliche Höhe des Hauptfensters der Anwendung.

Wenn Sie keine Höhe festlegen, wird sie von den Einstellungen in der SWF-Stammdatei oder, bei einer HTML-basierten AIR-Anwendung, vom Betriebssystem bestimmt.

Die maximale Höhe eines Fensters wurde in AIR 2 von 2048 Pixel zu 4096 Pixel geändert.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<height>4095</height>

In der Eigenschaft icon werden eine oder mehrere Symboldateien angegeben, die für eine Anwendung verwendet werden können. Die Festlegung eines Symbols ist optional. Wenn Sie keine icon -Eigenschaft festlegen, zeigt das Betriebssystem ein Standardsymbol an.

Der angegebene Pfad ist relativ zum Stammverzeichniss der Anwendung. Symboldateien müssen im PNG-Format vorliegen. Sie können für die folgenden vier Symbolgrößen jeweils eine eigene Symboldatei festlegen:

Wenn Sie für eines dieser Elemente eine Bilddatei angeben, so muss diese genau die angegebene Größe besitzen. Wenn nicht für alle Größen eine Bilddatei angegeben wird, wird das Bild, dessen Größe am nächsten liegt, vom Betriebssystem auf die benötigte Größe skaliert.

Das beste Ergebnis erhalten Sie, wenn Sie für jede verfügbare Größe ein Bild bereitstellen. Achten Sie darauf, dass die Symbole sowohl im 16- als auch im 32-Bit-Farbmodus gut aussehen.

Übergeordnetes Element: application

Untergeordnete Elemente: imageNxN

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

Ein Bezeichnerstring für die Anwendung, auch Anwendungs-ID genannt. Häufig wird ein umgekehrter Bezeichner im DNS-Stil verwendet, dieser Stil ist jedoch nicht erforderlich.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

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

Definiert den Pfad zu einem Symbol in Relation zum Anwendungsverzeichnis.

Es können die folgenden Symbolbilder verwendet werden, die jeweils eine andere Symbolgröße festlegen:

• image16x16

• image29x29 (AIR 2+)

• image32x32

• image36x36 (AIR 2.5+)

• image48x48

• image50x50 (AIR 3.4+)

• image57x57 (AIR 2+)

• image58x58 (AIR 3.4+)

• image72x72 (AIR 2+)

• image100x100 (AIR 3.4+)

• image114x114 (AIR 2.6+)

• image128x128

• image144x144 (AIR 3.4+)

• image512x512 (AIR 2+)

• image1024x1024 (AIR 3.4+)

Bei dem Symbol muss es sich um eine PNG-Grafik handeln, die genau die vom image-Element angegebene Größe hat. Symboldateien müssen im Anwendungspaket enthalten sein; Symbole, auf die im Anwendungsdeskriptordokument verwiesen wird, werden nicht automatisch eingeschlossen.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

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

Ermöglicht Ihnen, zusätzliche Eigenschaften einer iOS-Anwendung anzugeben.

Übergeordnetes Element: iPhone

Untergeordnete Elemente: iOS Info.plist-Elemente

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

Definiert die Hauptinhaltdatei und das anfängliche Erscheinungsbild der Anwendung.

Übergeordnetes Element: 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>

Identifiziert das Unterverzeichnis des Standardinstallationsverzeichnisses.

Unter Windows ist das Standardinstallationsunterverzeichnis das Verzeichnis „Programme“. Unter Mac OS ist dies das Verzeichnis „/Applications“. Unter Linux ist dies das Verzeichnis „/opt/“. Wenn die Eigenschaft installFolder beispielsweise auf "Acme" gesetzt und die betreffende Anwendung "ExampleApp" heißt, so wird die Anwendung unter Windows im Verzeichnis „C:\Programme\Acme\ExampleApp“, auf dem MAC OS unter „/Applications/Acme/Example.app“ und unter Linux im Verzeichnis „/opt/Acme/ExampleApp“ installiert.

Die Eigenschaft installFolder ist optional. Wenn Sie für die Eigenschaft installFolder keinen Wert angeben, wird die Anwendung gemäß der Eigenschaft name in einem Unterverzeichnis des Standardinstallationsverzeichnisses installiert.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<installFolder>utilities/toolA</installFolder>

Definiert iOS-spezifische Anwendungseigenschaften.

Übergeordnetes Element: application

Gibt Informationen an, die der Android-Manifestdatei für die Anwendung hinzugefügt werden sollen.

Übergeordnetes Element: manifestAdditions

Untergeordnete Elemente: Vom Android SDK definiert.

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

Gibt Informationen an, die der Android-Manifestdatei hinzugefügt werden sollen.

Jede Android-Anwendung enthält eine Manifestdatei, die grundlegende Eigenschaften der Anwendung definiert. Das Android-Manifest ähnelt vom Konzept her dem AIR-Anwendungsdeskriptor. Eine „AIR for Android“-Anwendung verfügt sowohl über einen Anwendungsdeskriptor als auch über eine automatisch generierte Manifestdatei. Wenn eine „AIR for Android“-App verpackt wird, werden die Informationen in diesem manifestAdditions -Element den entsprechenden Abschnitten des Android-Manifestdokuments hinzugefügt.

Übergeordnetes Element: android

Untergeordnete Elemente: 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>

Gibt an, ob das Fenster maximiert werden kann.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<maximizable>false</maximizable>

Die maximalen Größen des Fensters. Wenn Sie keine Maximalgröße festlegen, wird sie vom Betriebssystem bestimmt.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<maxSize>1024 360</maxSize>

Gibt an, ob das Fenster minimiert werden kann.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<minimizable>false</minimizable>

Gibt die zulässige Mindestgröße für das Fenster an.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<minSize>120 60</minSize>

Der Titel der Anwendung, der vom Installationsprogramm der AIR-Anwendung angezeigt wird.

Wird gar kein Wert für das Element name angegeben, zeigt das AIR-Anwendungsinstallationsprogramm den Wert im Element filename als Anwendungsname an.

Übergeordnetes Element: application

Untergeordnete Elemente: 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> 

Gibt den Namen eines Dateityps an.

Übergeordnetes Element: fileType

Untergeordnete Elemente: keine

<name>adobe.VideoFile</name>

Identifiziert den Ordner unter „Start“ > „Alle Programme“ (Windows) bzw. im Anwendungsmenü (Linux), in dem Verknüpfungen zur Anwendung installiert werden. (Auf anderen Betriebssystemen wird diese Einstellung momentan ignoriert.)

Übergeordnetes Element: application

Untergeordnete Elemente: keine

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

Identifiziert die Herausgeber-ID zum Aktualisieren einer AIR-Anwendung, die ursprünglich mit AIR 1.5.2 oder einer früheren Version erstellt wurde.

Geben Sie nur dann eine Herausgeber-ID an, wenn Sie ein Anwendungsupdate erstellen. Der Wert des publisherID -Elements muss mit der Herausgeber-ID übereinstimmen, die von AIR für frühere Versionen der Anwendung generiert wurde. Bei einer installierten Anwendung befindet sich die Herausgeber-ID in dem Ordner, in dem eine Anwendung installiert wurde, in der Datei META-INF/AIR/publisherid .

Neue Anwendungen, die mit AIR 1.5.3 oder höher erstellt werden, sollten keine Herausgeber-ID angeben.

Weitere Informationen finden Sie unter Herausgeber-IDs in AIR .

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

Gibt an, ob GPU-Beschleunigung verwendet werden soll, falls diese auf dem aktuellen Gerät unterstützt wird.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<renderMode>direct</renderMode>

Gibt an, ob die Anwendung auf einem Gerät oder Computermonitor mit hochauflösendem Bildschirm die Standardauflösung oder die hohe Auflösung verwenden möchte. Bei der Standardeinstellung standard erscheint der Bildschirm der Anwendung wie ein Bildschirm mit standardmäßiger Auflösung. Bei der Einstellung high kann die Anwendung jedes Pixel der hohen Auflösung ansprechen.

Ist die Einstellung auf einem iPhone-Display mit einer Auflösung von 640 x 960 Pixeln standard , betragen die Vollbildbühnenabmessungen 320 x 480 und jedes Anwendungspixel wird als vier Pixel dargestellt. Ist die Einstellung high , betragen die Vollbildbühnenabmessungen 640 x 960.

Bei Geräten mit Bildschirm mit Standardauflösung stimmen die Bühnenabmessungen mit den Bildschirmabmessungen überein, unabhängig davon, welche Einstellung verwendet wird.

Ist das requestedDisplayResolution -Element im iPhone -Element verschachtelt, wird es auf iOS-Geräte angewendet. In diesem Fall kann das excludeDevices -Attribut verwendet werden, um Geräte festzulegen, auf die diese Einstellung nicht zutrifft.

Ist das requestedDisplayResolution -Element im initialWindow -Element verschachtelt, wird es auf AIR-Anwendungen auf MacBook Pro-Computern angewendet, die hochauflösende Bildschirme unterstützen. Der angegebene Wert wird auf alle nativen Fenster der Anwendung angewendet. Das Verschachteln des requestedDisplayResolution -Elements im initialWindow -Element wird in AIR 3.6 und höher unterstützt.

Übergeordnetes Element: iPhone , initialWindow

Untergeordnete Elemente: keine

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

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

Gibt an, ob die Größe des Fensters geändert werden kann.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente:

<resizable>false</resizable>

Gibt das Standardverhalten der Anwendung an, wenn eine virtuelle Tastatur eingeblendet wird. Das Standardverhalten ist, die Anwendung nach oben zu verschieben. Die Laufzeitumgebung hält das Textfeld oder das interaktive Objekt, das den Fokus hat, auf dem Bildschirm. Verwenden Sie die pan -Option, wenn Ihre Anwendung keine eigene Tastaturverarbeitungslogik bereitstellt.

Sie können das automatische Verhalten auch ausschalten, indem Sie das softKeyboardBehavior -Element auf none festlegen. In diesem Fall setzen Textfelder und interaktive Objekte ein SoftKeyboardEvent ab, wenn die virtuelle Tastatur eingeblendet wird, die Laufzeitumgebung ändert jedoch nicht Position oder Größe der Anwendung. Ihre Anwendung ist dafür zuständig, dass der Texteingabebereich sichtbar bleibt.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<softKeyboardBehavior>none</softKeyboardBehavior>

Identifiziert die von der Anwendung unterstützten Sprachen. Dieses Element wird nur von Anwendungen für iOS, gekoppelte Mac-Laufzeitumgebungen und Android verwendet. Dieses Element wird von allen anderen Anwendungstypen ignoriert.

Wenn Sie dieses Element nicht angeben, führt der Packager standardmäßig je nach Anwendungstyp die folgenden Aktionen aus:

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<supportedLanguages>en ja fr es</supportedLanguages>

Identifiziert die Profile, die von der Anwendung unterstützt werden.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

<supportedProfiles>desktop mobileDevice</supportedProfiles>

Gibt an, ob das anfängliche Anwendungsfenster mit den standardmäßigen Elementen wie Titelleiste, Rahmen und Steuerungselemente erstellt wird, die vom Betriebssystem bereitgestellt werden.

Die System-Fensterdesigneinstellung des Fensters kann zur Laufzeit nicht mehr geändert werden.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<systemChrome>standard</systemChrome>

Gibt einen lokalisierten String an.

Im Attribut xml:lang eines text-Elements wird ein Sprachencode gemäß der Definition unter RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) verwendet.

Das Installationsprogramm der AIR-Anwendung verwendet das text -Element mit dem xml:lang -Attributwert, der am ehesten der Sprache der Benutzeroberfläche im Betriebssystem des Benutzers entspricht.

Betrachten Sie zum Beispiel eine Installation, in der ein text -Element einen Wert für das Gebietsschema „en“ (Englisch) enthält. Das AIR-Anwendungsinstallationsprogramm verwendet den en-Namen, wenn das Betriebssystem en (Englisch) als die Sprache der Benutzeroberfläche identifiziert. Es verwendet den en-Namen aber auch, wenn die Sprache der Benutzeroberfläche en-US (amerikanisches Englisch) ist. Wenn jedoch die Sprache der Benutzeroberfläche en-US ist, und die Anwendungsdeskriptordatei Namen sowohl für en-US als auch für en-GB definiert, so verwendet das AIR-Anwendungsinstallationsprogramm den en-US-Wert.

Wenn in der Anwendung kein text -Element definiert ist, das der Benutzeroberfläche des Systems entspricht, verwendet das AIR-Anwendungsinstallationsprogramm den ersten in der Anwendungsdeskriptordatei für name definierten Wert.

Untergeordnete Elemente: keine

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

Gibt den Titel an, der in der Titelleiste des Anfangsfensters der Anwendung angezeigt wird.

Ein Titel wird nur angezeigt, wenn das systemChrome -Element auf standard gesetzt ist.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<title>Example Window Title</title>

Gibt an, ob für das Anfangsfenster der Anwendung der Alpha-Mischmodus mit dem Desktop verwendet wird.

Ein Fenster mit aktivierter Transparenz wird möglicherweise langsamer aufgebaut und benötigt mehr Speicher. Die Transparenzeinstellung kann zur Laufzeit nicht mehr geändert werden.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<transparent>true</transparent>

In diesem Element werden die Versionsinformationen für die Anwendung angegeben.

Der Versionsstring ist ein innerhalb der Anwendung definierter Bezeichner. AIR interpretiert den Versionsstring in keiner Weise. Somit wird nicht davon ausgegangen, dass Version „3.0“ aktueller ist als Version „2.0“. Beispiele: „1.0" , „ .4" , „ 0.5 “, „4.9" , „1.3.4a" .

In AIR 2.5 und höher wird das version -Element durch die Elemente versionNumber und versionLabel ersetzt.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<version>0.1 Alpha</version>

Gibt den Versionsstring in lesbarem Klartext an.

Der Wert von versionlabel wird in Installationsdialogfeldern anstelle des Werts des versionNumber -Elements angezeigt. Falls versionLabel nicht verwendet wird, wird versionNumber für beides verwendet.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

<versionLabel>0.9 Beta</versionlabel>

Die Versionsnummer der Anwendung.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

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

Gibt an, ob das Anfangsfenster der Anwendung sichtbar ist, sobald es erstellt wird.

AIR-Fenster, einschließlich des Anfangsfensters, werden standardmäßig in einem unsichtbaren Zustand erstellt. Sie können ein Fenster anzeigen, indem Sie die activate() -Methode des NativeWindow-Objekts aufrufen oder seine visible -Eigenschaft auf true setzen. Oft empfiehlt es sich, das Hauptfenster zunächst einmal zu verbergen, sodass Änderungen an der Fensterposition und -größe und an der Darstellung des Inhalts nicht angezeigt werden.

In der Flex-Komponente mx:WindowedApplication wird das Fenster automatisch angezeigt und aktiviert, und zwar unmittelbar vor dem Auslösen des applicationComplete -Ereignisses, es sei denn, das visible -Attribut wurde in der MXML-Definition auf false gesetzt.

Bei Geräten in den mobile-Profilen, die Windows nicht unterstützen, wird die visible-Einstellung ignoriert.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<visible>true</visible>

Die anfängliche Breite des Hauptfensters der Anwendung.

Wenn Sie keine Breite festlegen, wird sie von den Einstellungen in der SWF-Stammdatei oder, bei HTML-basierten AIR-Anwendungen, vom Betriebssystem bestimmt.

Die maximale Breite eines Fensters wurde in AIR 2.0 von 2048 Pixel auf 4096 Pixel geändert.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<width>1024</width>

Die horizontale Position des Anfangsfensters der Anwendung.

In den meisten Fällen ist es besser, die Anfangsposition des Fensters vom Betriebssystem bestimmen zu lassen als einen festen Wert zuzuweisen.

Der Ursprung des Bildschirmkoordinatensystems (0,0) ist die obere linke Ecke des Hauptdesktopbildschirms (wie vom Betriebssystem bestimmt).

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<x>120</x>

Die vertikale Position des Anfangsfensters der Anwendung.

In den meisten Fällen ist es besser, die Anfangsposition des Fensters vom Betriebssystem bestimmen zu lassen als einen festen Wert zuzuweisen.

Der Ursprung des Bildschirmkoordinatensystems (0,0) ist die obere linke Ecke des Hauptdesktopbildschirms (wie vom Betriebssystem bestimmt).

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

<y>250</y>