Elemente des AIR-Anwendungsdeskriptors

Im folgenden Wörterbuch der Elemente werden die einzelnen zulässigen Elemente einer AIR-Anwendungsdeskriptordatei beschrieben.

allowBrowserInvocation

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

Inhalt

true oder false (Standard)

Beispiel für

<allowBrowserInvocation>true</allowBrowserInvocation>

android

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:

Inhalt

Elemente, die die Android-spezifischen Eigenschaften definieren, die dem Android-Anwendungsmanifest hinzugefügt werden sollen.

Beispiel für

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

application

Das Stammelement eines AIR-Anwendungsdeskriptordokuments.

Übergeordnetes Element: Ohne

Untergeordnete Elemente:

Attribute

minimumPatchLevel – Das von dieser Anwendung mindestens benötigte Patch-Level der AIR-Laufzeitumgebung.

xmlns – Das XML-Namespace-Attribut bestimmt die erforderliche AIR-Laufzeitversion der Anwendung.

Der Namespace ändert sich mit jeder wichtigen AIR-Version (nicht aber für Patches). Das letzte Segment der Namespacebezeichnung, etwa „3.0“, bezeichnet die für die Anwendung erforderliche Version der Laufzeitumgebung.

Die xmlns-Werte für die AIR-Hauptversionen lauten:

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"

Bei SWF-basierten Anwendungen bestimmt die im Anwendungsdeskriptor angegebene Version der AIR-Laufzeitumgebung die höchste SWF-Version, die als anfänglicher Inhalt der Anwendung geladen werden kann. Anwendungen, die AIR 1.0 oder AIR 1.1 angeben, können nur SWF9-Dateien (Flash Player 9) als ersten Inhalt verwenden, selbst wenn die AIR 2-Laufzeitumgebung ausgeführt wird. Anwendungen, die AIR 1.5 (oder höher) angeben, können entweder SWF9-Dateien oder SWF10-Dateien (Flash Player 10) als Anfangsinhalt verwenden.

Die SWF-Version bestimmt, welche Versionen der AIR- und Flash Player-APIs verfügbar sind. Wenn eine SWF9-Datei als anfänglicher Inhalt einer AIR 1.5-Anwendung verwendet wird, hat diese Anwendung nur auf die AIR 1.1- und Flash Player 9-APIs Zugriff. Außerdem treten Verhaltensänderungen an vorhandenen APIS in AIR 2.0 oder Flash Player 10.1 nicht in Kraft. (Wichtige sicherheitsrelevante Änderungen an APIs sind von dieser Regel ausgenommen und können rückwirkend in aktuellen oder zukünftigen Patches der Laufzeitumgebung angewendet werden.)

Bei HTML-basierten Anwendungen bestimmt die im Anwendungsdeskriptor angegebene Version, welche Versionen der AIR- und Flash Player-APIs der Anwendung zur Verfügung stehen. Die HTML-, CSS- und JavaScript-Verhalten werden immer von der Webkit-Version, die in der installierten AIR-Laufzeitumgebung angegeben ist, bestimmt, nicht vom Anwendungsdeskriptor.

Wenn eine AIR-Anwendung SWF-Inhalte lädt, bestimmt die Art, wie die Inhalte geladen werden, welche AIR- und Flash Player-APIs dem Inhalt zur Verfügung stehen. Manchmal wird die effektive Version vom Anwendungsdeskriptor-Namespace bestimmt, manchmal von der Version des ladenden Inhalts und manchmal von der Version des geladenen Inhalts. In der folgenden Tabelle ist aufgeführt, wie die API-Version anhand der Lademethode bestimmt wird:

Wie der Inhalt geladen wird

Wie die API-Version bestimmt wird

Anfänglicher Inhalt, SWF-basierte Anwendung

SWF-Version der geladenen Datei

Anfänglicher Inhalt, HTML-basierte Anwendung

Anwendungsdeskriptornamespace

Vom SWF-Inhalt geladene SWF-Datei

Version des ladenden Inhalts

Vom HTML-Inhalt mit <script>-Tag geladene SWF-Bibliothek

Anwendungsdeskriptornamespace

Vom HTML-Inhalt mit AIR- oder Flash Player-APIs (z. B. flash.display.Loader) geladene SWF-Datei

Anwendungsdeskriptornamespace

Vom HTML-Inhalt mit <object>- oder <embed>-Tags (oder den entsprechenden JavaScript-APIs) geladene SWF-Datei

SWF-Version der geladenen Datei

Wenn eine SWF-Datei mit einer anderes Version als der des ladenden Inhalts geladen wird, können zwei Probleme auftreten:

  • Laden einer SWF-Datei einer neueren Version durch eine SWF-Datei einer älteren Version – Verweise im geladenen Inhalt auf APIs, die in den neueren Versionen von AIR Und Flash Player hinzugefügt wurden, werden nicht aufgelöst.

  • Laden einer SWF-Datei einer älteren Version durch eine SWF-Datei einer neueren Version – APIs, die in den neueren Versionen von AIR Und Flash Player geändert wurden, verhalten sich möglicherweise anders als vom geladenen Inhalt erwartet.

Inhalt

Das application-Element enthält untergeordnete Elemente, die die Eigenschaften der AIR-Anwendung definieren.

Beispiel für

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

aspectRatio

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

Inhalt

portrait, landscape , oder any

Beispiel für

<aspectRatio>landscape</aspectRatio>

autoOrients

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

Inhalt

true oder false (Standard)

Beispiel für

<autoOrients>true</autoOrients>

colorDepth

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.

Hinweis: Falls Ihre Anwendung die StageVideo-Klasse verwendet, müssen Sie den 32-Bit-Farbmodus angeben.

Übergeordnetes Element: android

Untergeordnete Elemente: keine

Inhalt

Einer der folgenden Werte:

  • 16 Bit

  • 32 Bit

Beispiel für

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

containsVideo

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

Übergeordnetes Element: android

Untergeordnete Elemente: keine

Inhalt

Einer der folgenden Werte:

  • true

  • false

Beispiel für

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

content

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

Inhalt

Eine URL relativ zum Anwendungsverzeichnis. Da der Wert des Elements „content“ wie eine URL behandelt wird, müssen die Zeichen des Namens der Inhaltsdatei gemäß den unter RFC 1738 definierten Regeln URL-kodiert sein. Leerzeichen beispielsweise müssen als %20 kodiert sein.

Beispiel für

<content>TravelPlanner.swf</content>

contentType

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

Inhalt

Der MIME-Typ und Untertyp. Weitere Informationen zu MIME-Typen finden Sie unter RFC2045 .

Beispiel für

<contentType>text/plain</contentType>

copyright

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

Inhalt

Ein String mit Copyright-Informationen zur Anwendung.

Beispiel für

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

customUpdateUI

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

Hinweis: Der customUpdateUI -Mechanismus kommt dann zum Tragen, wenn die Anwendung bereits installiert ist und der Benutzer auf die AIR-Installationsdatei mit dem Update doppelklickt oder anhand der nahtlosen Installationsfunktion ein Anwendungsupdate installiert. Sie können ein Update auch über die eigene Anwendungslogik herunterladen und starten und nach Bedarf die von Ihnen definierte UI anzeigen, abhängig davon, ob customUpdateUI den Wert true hat.

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

Übergeordnetes Element: application

Untergeordnete Elemente: keine

Inhalt

true oder false (Standard)

Beispiel für

<customUpdateUI>true</customUpdateUI>

depthAndStencil

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

Inhalt

true oder false (Standard)

Beispiel für

<depthAndStencil>true</depthAndStencil>

description

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

Inhalt

Das AIR 1.0-Anwendungsdeskriptorschema gestattet als Definition für den Namen nur einen einzelnen text-Knoten (nicht mehrere text -Elemente).

In AIR 1.1 (oder höher) können Sie im description -Element mehrere Sprachen festlegen. Im Attribut xml:lang der verschiedenen text-Elemente wird ein Sprachencode gemäß der Definition unter RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) verwendet.

Beispiel für

Beschreibung mit einfachem Textknoten:

<description>This is a sample AIR application.</description> 

Beschreibung mit lokalisierten Textelementen für Englisch, Französisch und Spanisch (gültig in AIR 1.1 und höher):

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

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

Inhalt

Ein String, der den Dateiinhalt beschreibt.

Beispiel für

<description>PNG image</description>

embedFonts

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

Inhalt

Das embedFonts-Element kann eine beliebige Anzahl an Schriftarten-Elementen enthalten.

Beispiel für

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

Entitlements

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

Inhalt

Enthält die untergeordneten Elemente zum Festlegen der Schlüssel-Wert-Paare, die als Entitlements.plist-Einstellungen für die Anwendung verwendet werden. Der Inhalt des Entitlements-Elements sollte in einem CDATA-Block eingeschlossen sein. Weitere Informationen finden Sie unter Entitlement Key Reference in der iOS Developer Library.

Beispiel für

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

extension

Der Erweiterungsstring eines Dateityps.

Übergeordnetes Element: fileType

Untergeordnete Elemente: keine

Inhalt

Ein String, der die Zeichen der Dateierweiterung angibt (ohne den Punkt, „.“).

Beispiel für

<extension>png</extension>

extensionID

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

Inhalt

Ein String, der die ActionScript Erweiterungs-ID angibt.

Beispiel für

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

extensions

Identifiziert die von der Anwendung verwendeten ActionScript-Erweiterungen.

Übergeordnetes Element: application

Untergeordnete Elemente: extensionID

Inhalt

Untergeordnete extensionID -Elemente, die die ActionScript-Erweiterungs-IDs aus der Erweiterungsdeskriptordatei enthalten.

Beispiel für

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

externalSwfs

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

Inhalt

Name einer Textdatei, die eine Liste von SWF-Dateien mit Zeilenumbrüchen als Trennzeichen enthält, die remote gehostet werden sollen.

Attribute:

Keine.

Beispiele

iOS:

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

filename

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

Inhalt

Die Eigenschaft filename kann jedes Unicode-Zeichen (UTF-8) enthalten, außer den folgenden Zeichen, die auf verschiedenen Dateisystemen nicht für die Verwendung in Dateinamen zugelassen sind:

Zeichen

Hexadezimalcode

Verschiedene

0x00 – x1F

*

x2A

"

x22

:

x3A

>

x3C

<

x3E

?

x3F

\

x5C

|

x7C

Der Wert im Element filename darf nicht mit einem Punkt enden.

Beispiel für

<filename>MyApplication</filename>

fileType

Beschreibt einen einzelnen Dateityp, den die Anwendung registrieren kann.

Übergeordnetes Element: fileTypes

Untergeordnete Elemente:

Inhalt

Elemente, die einen Dateityp beschreiben.

Beispiel für

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

fileTypes

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() .

Hinweis: Die Laufzeitmethoden können nur Verknüpfungen verwalten, die im Anwendungsdeskriptor deklariert wurden.

Das Element fileTypes ist optional.

Übergeordnetes Element: application

Untergeordnete Elemente: fileType

Inhalt

Das fileTypes -Element kann eine beliebige Anzahl fileType -Elemente enthalten.

Beispiel für

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

font

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

Übergeordnetes Element: embedFonts

Untergeordnete Elemente: fontName , fontPath

Inhalt

Elemente, die den Namen der benutzerdefinierten Schriftart sowie den Pfad angeben.

Beispiel für

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

fontName

Gibt den Namen der benutzerdefinierten Schriftart an.

Übergeordnetes Element: font

Untergeordnete Elemente: keine

Inhalt

Name der benutzerdefinierten Schriftart, der in StageText.fontFamily angegeben werden soll

Beispiel für

<fontName>space age</fontName> 

fontPath

Gibt den Speicherort der benutzerdefinierten Schriftarten-Datei an.

Übergeordnetes Element: font

Untergeordnete Elemente: keine

Inhalt

Prad der benutzerdefinierten Schriftart (unter Berücksichtigung der Quelle).

Beispiel für

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

forceCPURenderModeForDevices

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:

iPad1,1

iPhone1,1

iPod1,1

iPad2,1

iPhone1,2

iPod2,1

iPad2,2

iPhone2,1

iPod3,3

iPad2,3

iPhone3.1

iPod4,1

iPad2,4

iPhone3,2

iPod 5,1

iPad2,5

iPhone4,1

iPad3,1

iPhone5,1

iPad3,2

iPad3,3

iPad3,4

Übergeordnetes Element: iPhone , initialWindow

Untergeordnete Elemente: keine

Inhalt

Liste der durch Leerzeichen getrennte Gerätemodellnamen.

Attribute:

Keine.

Beispiele

iOS:

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

fullScreen

Gibt an, ob die Anwendung im Vollbildmodus gestartet wird.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

Inhalt

true oder false (Standard)

Beispiel für

<fullscreen>true</fullscreen>

height

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

Inhalt

Eine positive Ganzzahl mit einem Höchstwert von 4095.

Beispiel für

<height>4095</height>

icon

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.

Hinweis: Die angegebenen Symbole werden nicht automatisch in das AIR-Paket aufgenommen. Dazu müssen die Symboldateien beim Erstellen des Anwendungspakets im korrekten relativen Pfad abgelegt sein.

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

Inhalt

Ein imageNxN-Element für jede gewünschte Symbolgröße.

Beispiel für

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

id

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

Inhalt

Der ID-Wert ist auf die folgenden Zeichen beschränkt:

  • 0–9

  • a–z

  • A–Z

  • . (Punkt)

  • - (Bindestrich)

Der Wert muss 1 bis 212 Zeichen enthalten. Dieses Element ist obligatorisch.

Beispiel für

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

imageNxN

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

Inhalt

Der Dateipfad zum Symbol kann jedes Unicode-Zeichen (UTF-8) enthalten, außer den folgenden Zeichen, die auf verschiedenen Dateisystemen nicht für die Verwendung in Dateinamen zugelassen sind:

Zeichen

Hexadezimalcode

Verschiedene

0x00 – x1F

*

x2A

"

x22

:

x3A

>

x3C

<

x3E

?

x3F

\

x5C

|

x7C

Beispiel für

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

InfoAdditions

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

Übergeordnetes Element: iPhone

Untergeordnete Elemente: iOS Info.plist-Elemente

Inhalt

Enthält die untergeordneten Elemente zum Festlegen der Schlüssel-Wert-Paare, die als Info.plist-Einstellungen für die Anwendung verwendet werden. Der Inhalt des InfoAdditions-Elements sollte in einem CDATA-Block eingeschlossen sein.

Unter Information Property List Key Reference in der Apple iPhone Reference Library finden Sie Informationen zu den Schlüssel-Wert-Paaren und dazu, wie diese in XML ausgedrückt werden.

Beispiel für

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

initialWindow

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

Übergeordnetes Element: application

Untergeordnete Elemente: Alle folgenden Elemente können als untergeordnete Elemente des initialWindow-Elements auftreten. Einige Elemente werden jedoch ignoriert; dies ist davon abhängig, ob AIR auf einer Plattform Fenster unterstützt:

Element

Desktop

Mobilgeräte

aspectRatio

ignoriert

verwendet

autoOrients

ignoriert

verwendet

content

verwendet

verwendet

depthAndStencil

verwendet

verwendet

fullScreen

ignoriert

verwendet

height

verwendet

ignoriert

maximizable

verwendet

ignoriert

maxSize

verwendet

ignoriert

minimizable

verwendet

ignoriert

minSize

verwendet

ignoriert

renderMode

verwendet (AIR 3.0 und höher)

verwendet

requestedDisplayResolution

verwendet (AIR 3.6 und höher)

ignoriert

resizable

verwendet

ignoriert

softKeyboardBehavior

ignoriert

verwendet

systemChrome

verwendet

ignoriert

title

verwendet

ignoriert

transparent

verwendet

ignoriert

visible

verwendet

ignoriert

width

verwendet

ignoriert

x

verwendet

ignoriert

y

verwendet

ignoriert

Inhalt

Untergeordnete Elemente, die das Aussehen und Verhalten der Anwendung definieren.

Beispiel für

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

installFolder

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

Inhalt

Die installFolder -Eigenschaft kann jedes Unicode-Zeichen (UTF-8) enthalten, außer den Zeichen, die auf verschiedenen Dateisystemen nicht für die Verwendung in Ordnernamen zugelassen sind (und in der Beschreibung der Eigenschaft filename aufgelistet sind).

Verwenden Sie das Schrägstrichzeichen (/) als Verzeichnistrennzeichen, wenn Sie ein verschachteltes Unterverzeichnis angeben möchten.

Beispiel für

<installFolder>utilities/toolA</installFolder>

iPhone

Definiert iOS-spezifische Anwendungseigenschaften.

Übergeordnetes Element: application

manifest

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

Übergeordnetes Element: manifestAdditions

Untergeordnete Elemente: Vom Android SDK definiert.

Inhalt

Das manifest-Element ist technisch gesehen kein Teil des AIR-Anwendungsdeskriptorschemas. Es ist der Stamm des Android-Manifest-XML-Dokuments. Alle Inhalte, die Sie in das manifest-Element setzen, müssen dem AndroidManifest-xml-Schema entsprechen. Wenn Sie mit den AIR-Werkzeugen eine APK-Datei generieren, werden die Informationen im manifest-Element in den entsprechenden Teil der generierten AndroidManifest.xml-Datei der Anwendung kopiert.

Wenn Sie Android-Manifestwerte angeben, die nur in einer SDK-Version verfügbar sind, die neuer als die direkt von AIR unterstützten ist, müssen Sie das -platformsdk -Flag beim Verpacken der Anwendung auf ADT setzen. Setzen Sie das Flag auf den Dateisystempfad zu einer Version des Android SDK, die die Werte, die Sie hinzufügen, unterstützt.

Das manifest-Element selbst muss in einem CDATA-Block innerhalb des AIR-Anwendungsdeskriptors enthalten sein.

Beispiel für

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

manifestAdditions

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

Inhalt

Informationen im manifestAdditions -Element werden dem AndroidManifest-XML-Dokument hinzugefügt.

AIR legt verschiedene Manifesteinträge im generierten Android-Manifestdokument fest, um sicherzustellen, dass die Funktionen der Anwendung und der Laufzeitumgebung korrekt arbeiten. Sie können die folgenden Einstellungen nicht überschreiben:

Die folgenden Attribute des manifest-Elements können Sie nicht festlegen:

  • package

  • android:versionCode

  • android:versionName

Die folgenden Attribute des Hauptaktivitätselements können Sie nicht festlegen:

  • android:label

  • android:icon

Die folgenden Attribute des application-Elements können Sie nicht festlegen:

  • android:theme

  • android:name

  • android:label

  • android:windowSoftInputMode

  • android:configChanges

  • android:screenOrientation

  • android:launchMode

Beispiel für

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

maximizable

Gibt an, ob das Fenster maximiert werden kann.

Hinweis: Unter Betriebssystemen wie Mac OS X, bei denen die Fenstermaximierung eine Größenänderungsoperation ist, müssen sowohl maximizable als auch resizable auf false eingestellt werden, um zu verhindern, dass die Fenstergröße geändert wird.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

Inhalt

true (Standard) oder false

Beispiel für

<maximizable>false</maximizable>

maxSize

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

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

Inhalt

Zwei Ganzzahlen, die die maximale Breite und Höhe angeben, getrennt durch Leerraum.

Hinweis: Die von AIR unterstützte maximale Fenstergröße wurde in AIR 2.0 von 2048x2048 Pixel auf 4096x4096 Pixel erhöht. (Da die Bildschirmkoordinaten auf Null basieren, ist der Höchstwert, den Sie für die Breite oder Höhe verwenden können, 4095.)

Beispiel für

<maxSize>1024 360</maxSize>

minimizable

Gibt an, ob das Fenster minimiert werden kann.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

Inhalt

true (Standard) oder false

Beispiel für

<minimizable>false</minimizable>

minSize

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

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

Inhalt

Zwei Ganzzahlen, die die Mindestwerte für Breite und Höhe angeben, getrennt durch Leerraum. Beachten Sie, dass die vom Betriebssystem bestimmte Mindestgröße Vorrang vor dem im Anwendungsdeskriptor festgelegten Wert hat.

Beispiel für

<minSize>120 60</minSize>

name

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

Inhalt

Wenn Sie einen einzelnen text-Knoten angeben (anstelle mehrerer <text> -Elemente), verwendet das AIR-Anwendungsinstallationsprogramm diesen Namen, und zwar ungeachtet der Sprache des Systems.

Das AIR 1.0-Anwendungsdeskriptorschema gestattet als Definition für den Namen nur einen einzelnen text-Knoten (nicht mehrere text -Elemente). In AIR 1.1 (oder höher) können Sie im name -Element mehrere Sprachen festlegen.

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

Das AIR-Anwendungsinstallationsprogramm verwendet den Namen, der der Sprache des Betriebssystems des Benutzers am meisten entspricht. Angenommen, es wird eine Anwendung installiert, in der das name -Element der Anwendungsdeskriptordatei den Wert „en“ für das englische Gebietsschema 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 Name definiert ist, der der Benutzeroberfläche des Systems entspricht, verwendet das AIR-Anwendungsinstallationsprogramm den ersten in der Anwendungsdeskriptordatei für name definierten Wert.

Das name -Element definiert nur den im AIR-Anwendungsinstallationsprogramm verwendeten Anwendungstitel. Das AIR-Anwendungsinstallationsprogramm unterstützt mehrere Sprachen: traditionelles Chinesisch, vereinfachtes Chinesisch, Tschechisch, Niederländisch, Englisch, Französisch, Deutsch, Italienisch, Japanisch, Koreanisch, Polnisch, brasilianisches Portugiesisch, Russisch, Spanisch, Schwedisch und Türkisch. Die im AIR-Anwendungsinstallationsprogramm angezeigte Sprache richtet sich (abgesehen von Anwendungstitel und -beschreibung) nach der Sprache der Benutzeroberfläche des Systems. Diese Sprachauswahl ist unabhängig von den Einstellungen in der Anwendungsdeskriptordatei.

Das name -Element definiert nicht die für die installierte, ausgeführte Anwendung verfügbaren Gebietsschemas. Informationen zum Entwickeln mehrsprachiger Anwendungen finden Sie unter Lokalisieren von AIR-Anwendungen .

Beispiel für

Im folgenden Beispiel wird ein Name mit einem einfachen Textknoten definiert:

<name>Test Application</name> 

Das folgende Beispiel, gültig in AIR 1.1. und höher, gibt den Namen in drei Sprachen (Englisch, Französisch und Spanisch) an, indem <text>-Elementknoten verwendet werden:

<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 

name

Gibt den Namen eines Dateityps an.

Übergeordnetes Element: fileType

Untergeordnete Elemente: keine

Inhalt

Ein String, der den Namen des Dateityps darstellt.

Beispiel für

<name>adobe.VideoFile</name>

programMenuFolder

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

Inhalt

Der String, der für den programMenuFolder -Wert verwendet wird, kann jedes Unicode-Zeichen (UTF-8) enthalten, außer den Zeichen, die auf verschiedenen Dateisystemen nicht für die Verwendung in Ordnernamen zugelassen sind (und in der Beschreibung des filename -Elements aufgelistet sind). Verwenden Sie als letztes Zeichen in diesem Wert nicht den vorwärtsgerichteten Schrägstrich (/).

Beispiel für

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

publisherID

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

Inhalt

Ein String mit der Herausgeber-ID.

Beispiel für

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

renderMode

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

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

Inhalt

Einer der folgenden Werte:

  • auto (Standard) – fällt zurzeit auf den CPU-Modus zurück.

  • cpu – es wird keine Hardwarebeschleunigung verwendet.

  • direct – die Renderingzusammensetzung erfolgt in der CPU; für Blitting wird die GPU verwendet. Verfügbar ab AIR 3.

    Hinweis: Um die GPU-Hardwarebeschleunigung von Flash-Inhalten mit AIR für mobile Plattformen zu nutzen, empfiehlt Adobe die Verwendung von renderMode="direct" (d. h. Stage3D) anstatt von renderMode="gpu". Adobe unterstützt und empfiehlt offiziell die folgenden Stage3D-basierten Frameworks: Starling (2D) und Away3D (3D). Weitere Informationen zu Stage3D und Starling/Away3D finden Sie unter http://gaming.adobe.com/getstarted/ .
  • gpu – falls verfügbar, wird die Hardwarebeschleunigung verwendet.

    Wichtig: Verwenden Sie den GPU-Rendermodus nicht für Flex-Anwendungen.

Beispiel für

<renderMode>direct</renderMode>

requestedDisplayResolution

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

Inhalt

Entweder standard , die Standardeinstellung, oder high .

Attribut:

excludeDevices – eine durch Leerzeichen getrennte Liste mit iOS-Modellnamen oder -Modellnamenspräfixen. Dadurch können einige Geräte die hohe Auflösung und andere die Standardauflösung verwenden. Dieses Attribut ist nur unter iOS verfügbar (das requestedDisplayResolution -Element ist im iPhone -Element verschachtelt). Das Attribut excludeDevices ist in AIR 3.6 und höher verfügbar.

Bei allen Geräten, dessen Modellname in diesem Attribut festgelegt ist, ist der Wert requestedDisplayResolution dem festgelegten Wert entgegengesetzt. In anderen Worten: Wenn der Wert requestedDisplayResolution auf high gesetzt ist, verwenden die ausgeschlossenen Geräte die Standardauflösung. Wenn der Wert requestedDisplayResolution auf standard gesetzt ist, verwenden die ausgeschlossenen Geräte die hohe Auflösung.

Die Werte sind Modellnamen oder Modellnamenspräfixe von iOS-Geräten. Beispiel: Der Wert „iPad3,1“ bezieht sich auf ein iPad der 3. Generation (Wi-Fi) (jedoch nicht GSM oder CDMA). Alternativ bezieht sich der Wert „iPad3“ auf jedes iPad der 3. Generation. Eine unoffizielle Liste von iOS-Modellnamen ist unter Models - The iPhone Wiki verfügbar.

Beispiele

Desktop:

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

iOS:

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

resizable

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

Hinweis: Unter Betriebssystemen wie Mac OS X, bei denen die Fenstermaximierung eine Größenänderungsoperation ist, müssen sowohl maximizable als auch resizable auf false eingestellt werden, um zu verhindern, dass die Fenstergröße geändert wird.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente:

Inhalt

true (Standard) oder false

Beispiel für

<resizable>false</resizable>

softKeyboardBehavior

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

Inhalt

Entweder none oder pan . Der Standardwert lautet pan .

Beispiel für

<softKeyboardBehavior>none</softKeyboardBehavior>

supportedLanguages

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:

  • iOS – Alle von der AIR-Laufzeitumgebung unterstützten Sprachen sind im iOS App Store als unterstützte Sprachen der Anwendung aufgeführt.

  • Gekoppelte Mac-Laufzeitumgebung – Die mit einem gekoppelten Bundle verpackte Anwendung hat keine Lokalisierungsinformationen.

  • Android – Das Anwendungsbundle hat Ressourcen für alle von der AIR-Laufzeitumgebung unterstützten Sprachen.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

Inhalt

Eine durch Leerzeichen getrennte Liste der unterstützten Sprachen. Gültige Sprachenwerte sind die Kürzel gemäß ISO 639‑1 für die von der AIR-Laufzeitumgebung unterstützten Sprachen: en , de , es , fr , it , ja , ko , pt , ru , cs , nl , pl , sv , tr , zh , da , nb , iw .

Der Packager generiert einen Fehler, wenn das <supportedLanguages> -Element einen leeren Wert hat.

Hinweis: Lokalisierte Tags (zum Beispiel das name-Tag) ignorieren den Wert einer Sprache, wenn Sie das <supportedLanguages> -Tag verwenden und dieses nicht die entsprechende Sprache enthält. Wenn eine native Erweiterung Ressourcen für eine Sprache hat, die nicht im <supportedLangauges> -Tag aufgeführt ist, wird eine Warnung ausgegeben und die Ressourcen für diese Sprache werden ignoriert.

Beispiel für

<supportedLanguages>en ja fr es</supportedLanguages>

supportedProfiles

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

Übergeordnetes Element: application

Untergeordnete Elemente: keine

Inhalt

Sie können jeden dieser Werte in das supportedProfiles -Element einschließen:

  • desktop – Das Desktopprofil gilt für AIR-Anwendungen, die mithilfe einer AIR-Datei auf einem Desktop installiert werden. Diese Anwendungen haben keinen Zugriff auf die NativeProcess-Klasse (die die Kommunikation mit nativen Anwendungen ermöglicht).

  • extendedDesktop – Das erweiterte Desktopprofil gilt für AIR-Anwendungen, die mithilfe eines nativen Installationsprogramms auf einem Desktopcomputer installiert werden. Diese Anwendungen haben Zugriff auf die NativeProcess-Klasse (die die Kommunikation mit nativen Anwendungen ermöglicht).

  • mobileDevice – Das Mobile-Geräte-Profil gilt für mobile Anwendungen.

  • extendedMobileDevice – Das erweiterte Profil für mobile Geräte wird zurzeit nicht verwendet.

Die supportedProfiles -Eigenschaft ist optional. Wenn Sie dieses Element nicht in die Anwendungsdeskriptordatei einschließen, kann die Anwendung für jedes beliebige Profil kompiliert und bereitgestellt werden.

Wenn Sie mehrere Profile angeben möchten, trennen Sie sie durch ein Leerzeichen. Die folgende Einstellung legt zum Beispiel fest, dass die Anwendung nur für das Desktopprofil und die erweiterten Profile verfügbar ist:

<supportedProfiles>desktop extendedDesktop</supportedProfiles>
Hinweis: Wenn Sie eine Anwendung mit ADL ausführen und keinen Wert für die ADL-Option -profile angeben, wird das erste Profil im Anwendungsdeskriptor verwendet. (Falls auch im Anwendungsdeskriptor keine Profile angegeben wurden, wird das Desktopprofil verwendet.)

Beispiel für

<supportedProfiles>desktop mobileDevice</supportedProfiles>

systemChrome

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

Inhalt

Einer der folgenden Werte:

  • none – es wird kein System-Fensterdesign bereitgestellt. Die Anwendung (oder ein Anwendungs-Framework wie Flex) ist für die Anzeige des Fensterdesigns zuständig.

  • standard (Standardeinstellung) – das Betriebssystem stellt das System-Fensterdesign bereit.

Beispiel für

<systemChrome>standard</systemChrome>

text

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.

Übergeordnete Elemente:

Untergeordnete Elemente: keine

Inhalt

Ein xml:lang -Attribut, das ein Gebietsschema und einen String aus lokalisiertem Text angibt.

Beispiel für

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

title

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

Inhalt

Ein String, der den Fenstertitel enthält.

Beispiel für

<title>Example Window Title</title>

transparent

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.

Wichtig: Sie können transparent nur auf true setzen, wenn systemChrome auf none gesetzt ist.

Übergeordnetes Element: initialWindow

Untergeordnete Elemente: keine

Inhalt

true oder false (Standard)

Beispiel für

<transparent>true</transparent>

version

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

Inhalt

Ein String, der die Versionsnummer der Anwendung enthält.

Beispiel für

<version>0.1 Alpha</version>

versionLabel

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

Inhalt

Ein String, der den öffentlich angezeigten Versionstext enthält.

Beispiel für

<versionLabel>0.9 Beta</versionlabel>

versionNumber

Die Versionsnummer der Anwendung.

Übergeordnetes Element: application

Untergeordnete Elemente: keine

Inhalt

Die Versionsnummer kann eine Folge von bis zu drei Ganzzahlen, die durch Punkte getrennt sind, enthalten. Jede Ganzzahl muss eine Zahl zwischen 0 und 999 (einschließlich) sein.

Beispiele

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

visible

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

Inhalt

true oder false (Standard)

Beispiel für

<visible>true</visible>

width

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

Inhalt

Eine positive Ganzzahl mit einem Höchstwert von 4095.

Beispiel für

<width>1024</width>

x

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

Inhalt

Ein ganzzahliger Wert.

Beispiel für

<x>120</x>

y

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

Inhalt

Ein ganzzahliger Wert.

Beispiel für

<y>250</y>