Tworzenie pierwszej aplikacji AIR środowiska Flex w programie Flash Builder

W celu uzyskania szybkich i niezawodnych instrukcji na temat działania środowiska Adobe® AIR® można wykorzystać poniższe instrukcje, aby utworzyć i spakować prostą aplikację AIR „Hello World” opartą na pliku SWF za pomocą programu Adobe® Flash® Builder.

Przed przystąpieniem do pracy należy pobrać i zainstalować program Flex Builder. Należy również pobrać i zainstalować najnowszą wersję środowiska Adobe AIR, która jest dostępne na stronie www.adobe.com/go/air_pl .

Tworzenie projektu AIR

Program Flash Builder zawiera narzędzia służące do projektowania i pakowania aplikacji AIR.

Tworzenie aplikacji AIR w programie Flash Builder lub Flex Builder rozpoczyna się tak samo, jak tworzenie innych projektów aplikacji Flex — od zdefiniowania nowego projektu.

  1. Otwórz program Flash Builder.

  2. Wybierz opcję Plik > Nowe > Projekt Flex.

  3. Wprowadź nazwę projektu: AIRHelloWorld.

  4. W środowisku Flex aplikacje AIR są traktowane jako typ aplikacji. Dostępne są dwa typy:

    • Aplikacja internetowa działająca w programie Adobe® Flash® Player

    • Aplikacja komputerowa działająca w środowisku Adobe AIR

    Jako typ aplikacji wybierz: Komputerowa.

  5. Aby utworzyć projekt, kliknij przycisk Zakończ.

Projekty AIR początkowo zawierają dwa pliki: główny plik MXML oraz plik XML aplikacji (określany jako plik deskryptora aplikacji). Drugi plik określa właściwości aplikacji.

Więcej informacji zawiera artykuł Programowanie aplikacji AIR za pomocą programu Flash Builder .

Pisanie kodu aplikacji AIR

W celu napisania kodu aplikacji „Hello World” należy przeprowadzić edycję pliku MXML aplikacji (AIRHelloWorld.mxml), który jest otwarty w edytorze. (Jeśli plik nie jest otwarty, należy użyć nawigatora projektów, aby otworzyć ten plik).

Aplikacje Flex AIR na komputerze stacjonarnym są zawarte w znaczniku MXML WindowedApplication. Znacznik MXML WindowedApplication tworzy zwykłe okno, które zawiera podstawowe elementy sterujące, takie jak pasek tytułu i przycisk zamykania.

  1. Dodaj atrybut title do składnika WindowedApplication, a następnie przypisz do niego wartość "Hello World" :

    <?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. Dodaj do aplikacji składnik Label (umieść go w znaczniku WindowedApplication). Ustaw właściwość text składnika Label na "Hello AIR" i ustaw ograniczenia układu w taki sposób, aby etykieta znajdowała się na środku:

    <?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>
  3. Następujący blok stylu dodaj bezpośrednio po otwarciu znacznika WindowedApplication i przed znacznikiem składnika label, który właśnie został wprowadzony:

    <fx:Style> 
        @namespace s "library://ns.adobe.com/flex/spark"; 
        s|WindowedApplication 
        { 
         
    skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin"); 
            background-color:#999999; 
            background-alpha:"0.7"; 
        }          
    </fx:Style>

Ustawienia stylu mają zastosowanie do całej aplikacji i renderują dla tła okna częściowo przepuszczalny szary kolor.

Kod aplikacji wygląda, jak poniżej:

<?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"> 
     
    <fx:Style> 
        @namespace s "library://ns.adobe.com/flex/spark"; 
        s|WindowedApplication 
        { 
         
skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin"); 
            background-color:#999999; 
            background-alpha:"0.7"; 
        }          
    </fx:Style> 
 
    <s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/> 
</s:WindowedApplication>

Następnie wymagana jest zmiana niektórych ustawień w deskryptorze aplikacji, dzięki czemu aplikacja będzie mogła stać się przezroczysta.

  1. W panelu nawigatora Flex znajdź plik deskryptora aplikacji w katalogu źródłowym projektu: Jeśli projekt ma nazwę AIRHelloWorld, ten plik ma nazwę AIRHelloWorld-app.xml.

  2. Kliknij dwukrotnie plik deskryptora aplikacji przeznaczony do edycji w programie Flash Builder.

  3. W kodzie XML odszukaj wiersze oznaczone jako komentarz dla właściwości systemChrome i transparent (właściwości initialWindow ). Usuń znaki komentarza. (Usuń znaki „<!--" i „-->" , tj. ograniczniki komentarzy.)

  4. Ustaw wartość tekstu właściwości systemChrome na none , jak poniżej:

    <systemChrome>none</systemChrome>
  5. Ustaw wartość tekstu właściwości transparent na true , jak poniżej:

    <transparent>true</transparent>
  6. Zapisz plik.

Testowanie aplikacji AIR

Aby przetestować napisany kod aplikacji, należy uruchomić tryb debugowania.

  1. Kliknij przycisk Debuguj na głównym pasku narzędziowym programu

    Można również wybrać polecenia Uruchom > Debuguj > AIRHelloWorld.

    Powstała aplikacja AIR powinna przypominać następujący przykład.

  2. Za pomocą właściwości horizontalCenter i verticalCenter elementu sterującego Label można umieścić tekst na środku okna. Okno można przesuwać i powiększać/zmniejszać tak samo jak okno każdej innej aplikacji.

Uwaga: Jeśli skompilowanie aplikacji nie jest możliwe, należy usunąć błędy składniowe i błędy pisowni, które przypadkowo znalazły się w kodzie. Błędy i ostrzeżenia są opisane w widoku Problemy w programie Flash Builder.

Pakowanie, podpisywanie i uruchamianie aplikacji AIR

Po wykonaniu powyższych czynności można spakować aplikację „Hello World” do pliku AIR w celu dystrybucji. Plik AIR jest plikiem archiwum, który zawiera pliki aplikacji — są to wszystkie pliki zawarte w folderze bin projektu. W tym prostym przykładzie są to pliki SWF oraz pliki XML aplikacji. Pakiet AIR jest dystrybuowany do użytkowników, którzy wykorzystają go w celu zainstalowania aplikacji. Wymaganym etapem tego procesu jest cyfrowe podpisanie pakietu.

  1. Upewnij się, że podczas kompilacji nie pojawiają się błędy i że aplikacja działa zgodnie z oczekiwaniami.

  2. Wybierz opcje Projekt > Eksportuj kompilację do publikacji.

  3. Sprawdź, czy podano wartość AIRHelloWorld jako projekt i wartość AIRHelloWorld.mxml jako aplikację.

  4. Wybierz opcję Eksportuj jako podpisany pakiet AIR. Następnie kliknij przycisk Dalej.

  5. Jeśli istnieje certyfikat cyfrowy, kliknij przycisk Przeglądaj, aby go odszukać, a następnie wybierz plik.

  6. Jeśli wymagane jest utworzenie nowego samopodpisanego certyfikatu cyfrowego, wybierz opcję Utwórz.

  7. Wprowadź wymagane informacje i kliknij przycisk OK.

  8. Kliknij przycisk Zakończ, aby wygenerować pakiet AIR, który będzie miał nazwę AIRHelloWorld.air.

Po wykonaniu tych czynności aplikację można zainstalować i uruchomić z poziomu nawigatora projektu w programie Flash Builder lub z poziomu systemu plików przez dwukrotne kliknięcie pliku AIR.