Erstmaliges Erstellen einer Desktop-AIR-Anwendung mit dem Flex-SDK

In diesem Abschnitt wird beschrieben, wie Sie den Anwendungsdeskriptor erstellen. Dabei handelt es sich um eine XML-Datei mit der folgenden Struktur:

<application xmlns="..."> 
    <id>...</id> 
    <versionNumber>...</versionNumber> 
    <filename>…</filename> 
    <initialWindow> 
        <content>…</content> 
        <visible>…</visible> 
        <width>…</width> 
        <height>…</height> 
    </initialWindow> 
</application>

1. Erstellen Sie eine XML-Datei mit dem Namen HelloWorld-app.xml und speichern Sie sie im Projektverzeichnis.

2. Fügen Sie das <application>-Element einschließlich des AIR-Namespace-Attributs hinzu:

   <application xmlns="http://ns.adobe.com/air/application/2.6"> Das letzte Segment des Namespace, „2.6“, gibt die Version der Laufzeitumgebung an, die für die Anwendung erforderlich ist.

3. Fügen Sie das <id>-Element hinzu:

   <id>samples.flex.HelloWorld</id> Die Anwendungs-ID identifiziert Ihre Anwendung eindeutig, zusammen mit der Hearusgeber-ID (die AIR aus dem Zertifikat ableitet, mit dem das Anwendungspaket signiert wurde). Das empfohlene Format ist ein durch einen Punkt getrennter String im umgekehrten DNS-Stil, zum Beispiel "com.firma.AppName". Die Anwendungs-ID wird verwendet für die Installation, den Zugriff auf das private Anwendungsspeicherverzeichnis im Dateisystem, den Zugriff auf den privaten verschlüsselten Speicher und für die Kommunikation zwischen Anwendungen.

4. Fügen Sie das <versionNumber>-Element hinzu:

   <versionNumber>1.0</versionNumber> Hilft Benutzern dabei, festzustellen, welche Version Ihrer Anwendung sie installieren.

5. Fügen Sie das <filename>-Element hinzu:

   <filename>HelloWorld</filename> Der Name, der für die ausführbare Datei der Anwendung, das Installationsverzeichnis und für Verweise auf die Anwendung im Betriebssystem verwendet wird.

6. Fügen Sie das <initialWindow>-Element hinzu, das die folgenden untergeordneten Elemente enthält, um die Eigenschaften des Anfangsfensters Ihrer Anwendung festzulegen:

   <content>HelloWorld.swf</content> Identifiziert die HTML-Stammdatei, die AIR laden soll.

   <visible>true</visible> Macht das Fenster sofort sichtbar.

   <width>400</width> Legt die Breite des Fensters fest (in Pixeln).

   <height>200</height> Legt die Höhe des Fensters fest.

7. Speichern Sie die Datei. Die fertige Anwendungsdeskriptordatei sollte ähnlich wie das folgende Beispiel aussehen:

   <?xml version="1.0" encoding="UTF-8"?> 
   <application xmlns="http://ns.adobe.com/air/application/2.6"> 
       <id>samples.flex.HelloWorld</id> 
       <versionNumber>0.1</versionNumber> 
       <filename>HelloWorld</filename> 
       <initialWindow> 
           <content>HelloWorld.swf</content> 
           <visible>true</visible> 
           <width>400</width> 
           <height>200</height> 
       </initialWindow> 
   </application>

In diesem Beispiel werden nur einige wenige der möglichen Anwendungseigenschaften festgelegt. Eine Übersicht über alle Anwendungseigenschaften, mit denen Sie das Fensterdesign, die Fenstergröße, die Transparenz, das Standardinstallationsverzeichnis, die zugeordneten Dateitypen sowie Anwendungssymbole festlegen können, finden Sie unter AIR-Anwendungsdeskriptordateien.

Wie alle Flex-basierten Anwendungen enthalten AIR-Anwendungen, die mit dem Flex-Framework erstellt wurden, eine MXML-Hauptdatei. Desktop-AIR-Anwendungen verwenden die WindowedApplication-Komponente als Stammelement anstelle der Application-Komponente. Die WindowedApplication-Komponente stellt Eigenschaften, Methoden und Ereignisse für die Steuerung der Anwendung und des Anfangsfensters bereit. Bei Plattformen und Profilen, für die AIR nicht mehrere Fenster unterstützt, verwenden Sie weiterhin die Application-Komponente. In mobilen Flex-Anwendungen können Sie auch die View- oder TabbedViewNavigatorApplication-Komponente verwenden.

Mit dem folgenden Verfahren wird die Anwendung „Hello World“ erstellt:

1. Erstellen Sie mithilfe eines Texteditors eine Datei mit dem Namen HelloWorld.mxml und fügen Sie ihr den folgenden MXML-Code hinzu:

   <?xml version="1.0" encoding="utf-8"?> 
   <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                          xmlns:s="library://ns.adobe.com/flex/spark" 
                          xmlns:mx="library://ns.adobe.com/flex/mx" 
                          title="Hello World"> 
   </s:WindowedApplication>

2. Fügen Sie der Anwendung dann eine Label-Komponente hinzu (platzieren Sie sie innerhalb des WindowedApplication-Tags).

3. Stellen Sie die text-Eigenschaft der Label-Komponente auf den Wert "Hello AIR" ein.

4. Legen Sie die Layoutbeschränkungen so fest, dass sie sich immer in der Mitte befindet.

   Das folgende Beispiel zeigt den bis jetzt erstellten Code:

   <?xml version="1.0" encoding="utf-8"?> 
   <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                          xmlns:s="library://ns.adobe.com/flex/spark" 
                          xmlns:mx="library://ns.adobe.com/flex/mx" 
                          title="Hello World"> 
        
       <s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/> 
   </s:WindowedApplication>

Bevor Sie die Anwendung ausführen und debuggen können, kompilieren Sie den MXML-Code mit dem amxmlc-Compiler in eine SWF-Datei. Sie finden den amxmlc-Compiler im Verzeichnis bin des Flex-SDK. Falls gewünscht, können Sie die Pfadumgebung Ihres Computers so einrichten, dass sie das „bin“-Verzeichnis des Flex-SDK enthält. Wenn Sie den Pfad einrichten, lassen sich die Dienstprogramme in der Befehlszeile leichter ausführen.

1. Öffnen Sie eine Befehls-Shell oder ein Terminal und navigieren Sie zum Projektordner der AIR-Anwendung.

2. Geben Sie den folgenden Befehl ein:

   amxmlc HelloWorld.mxml 

Durch das Ausführen von amxmlc wird die Datei HelloWorld.swf erstellt, die den kompilierten Code der Anwendung enthält.

Weitere Informationen finden Sie unter Kompilieren von MXML- und ActionScript-Quelldateien für AIR.

Um die Anwendung von der Befehlszeile auszuführen und zu testen, verwenden Sie den AIR Debug Launcher (ADL) zum Starten der Anwendung über die Anwendungsdeskriptordatei. (ADL befindet sich im Verzeichnis „bin“ des Flex-SDK.)

 Geben Sie an der Eingabeaufforderung den folgenden Befehl ein:

adl HelloWorld-app.xml 

Die resultierende AIR-Anwendung sieht ähnlich wie in dieser Abbildung aus:

Mithilfe der horizontalCenter- und verticalCenter-Eigenschaften der Label-Steuerung wird der Text in der Mitte des Fensters platziert. Sie können die Größe und die Position des Fensters verändern wie bei jeder anderen Desktopanwendung.

Weitere Informationen finden Sie unter AIR Debug Launcher (ADL).

Wenn Ihre Anwendung erfolgreich ausgeführt wird, können Sie sie mit dem ADT-Dienstprogramm zu einer AIR-Installationsdatei komprimieren. Eine AIR-Installationsdatei ist eine Archivdatei, die alle Anwendungsdateien enthält und die Sie an die Benutzer verteilen können. Sie müssen Adobe AIR installieren, bevor Sie eine komprimierte AIR-Datei installieren können.

Um die Sicherheit einer Anwendung zu gewährleisten, müssen alle AIR-Installationsdateien digital signiert werden. Zu Entwicklungszwecken können Sie mit ADT oder einem anderen Werkzeug für die Zertifikaterstellung ein selbstsigniertes Basiszertifikat erstellen. Sie können auch ein Codesignaturzertifikat von einer kommerziellen Zertifizierungsstelle erwerben. Wenn Benutzer ein selbstsigniertes Zertifikat installieren, wird der Herausgeber während des Installationsvorgangs als „unbekannt“ angezeigt. Dies liegt daran, dass ein selbstsigniertes Zertifikat lediglich gewährleistet, dass die AIR-Datei seit der Erstellung nicht geändert wurde. Es gibt keine Möglichkeit, zu verhindern, dass jemand eine „falsche“ AIR-Datei selbst signiert und als Ihre Anwendung ausgibt. Für veröffentlichte AIR-Dateien wird deshalb dringend ein überprüfbares, kommerzielles Zertifikat empfohlen. Einen Überblick über sicherheitsrelevante Themen zu AIR finden Sie unter AIR-Sicherheit (für ActionScript-Entwickler) oder AIR security (für HTML-Entwickler).

Generieren eines selbstsignierten Zertifikat-Schlüssel-Paars

 Geben Sie an der Eingabeaufforderung den folgenden Befehl ein (die ausführbare ADT-Datei befindet sich im Verzeichnis bin des Flex-SDK):

adt –certificate -cn SelfSigned 1024-RSA sampleCert.pfxsamplePassword

In diesem Beispiel wird nur die Mindestanzahl von Attributen verwendet, die für ein Zertifikat festgelegt werden können. Sie können beliebige Werte für die Parameter in Kursivschrift verwenden. Der Schlüsseltyp muss entweder 1024-RSA oder 2048-RSA sein (siehe Signieren von AIR-Anwendungen).

Erstellen des AIR-Pakets

 Geben Sie an der Eingabeaufforderung den folgenden Befehl ein (in einer Zeile):

adt -package -storetype pkcs12 -keystore sampleCert.pfx HelloWorld.air 
HelloWorld-app.xml HelloWorld.swf

Sie werden aufgefordert, das Kennwort für die Keystoredatei einzugeben. Geben Sie das Kennwort ein und drücken Sie die Eingabetaste. Aus Sicherheitsgründen werden die Buchstaben des Kennworts nicht angezeigt.

Das Argument „HelloWorld.air“ ist die AIR-Datei, die ADT erstellt. „HelloWorld-app.xml“ ist die Anwendungsdeskriptordatei. Die folgenden Argumente sind die Dateien, die von Ihrer Anwendung verwendet werden. In diesem Beispiel werden nur drei Dateien verwendet, Sie können jedoch eine beliebige Anzahl von Dateien und Ordnern einbeziehen.

Nachdem das AIR-Paket erstellt wurde, können Sie die Anwendung installieren und ausführen, indem Sie auf die Paketdatei doppelklicken. Sie können den AIR-Dateinamen auch als Befehl in einer Shell oder einem Befehlsfenster eingeben.

Weitere Informationen finden Sie unter Komprimieren einer AIR-Installationsdatei für den Desktop.