Tworzenie pierwszej aplikacji AIR dla systemu Android za pomocą zestawu SDK środowiska Flex

W niniejszej sekcji opisano sposób tworzenia deskryptora aplikacji, który jest plikiem XML o następującej strukturze:

<application xmlns="..."> 
    <id>...</id> 
    <versionNumber>...</versionNumber> 
    <filename>…</filename> 
    <initialWindow> 
        <content>…</content> 
    </initialWindow> 
    <supportedProfiles>...</supportedProfiles> 
</application>

1. Utwórz plik XML o nazwie HelloWorld-app.xml i zapisz go w katalogu projektu.

2. Dodaj element <application> zawierający atrybut przestrzeni nazw AIR:

   <application xmlns="http://ns.adobe.com/air/application/2.7"> Ostatni segment przestrzeni nazw — „2.7” — określa wymaganą wersję środowiska wykonawczego.

3. Dodaj element <id> :

   <id>samples.android.HelloWorld</id> Identyfikator aplikacji w unikalny sposób określa aplikację wraz z identyfikatorem wydawcy (uzyskiwanym przez środowisko AIR z certyfikatu używanego w celu podpisania pakietu aplikacji). Zalecaną formą jest rozdzielony kropkami ciąg zapisany w odwrotnej notacji DNS, taki jak com.firma.nazwa_aplikacji .

4. Dodaj element <versionNumber> .

   <versionNumber>0.0.1</versionNumber> Ułatwia użytkownikom określenie, którą wersję aplikacji instalują.

5. Dodaj element <filename> :

   <filename>HelloWorld</filename> Nazwa używana dla pliku wykonywalnego aplikacji, katalogu instalacyjnego, a także dla podobnych odwołań w systemie operacyjnym.

6. Dodaj element <initialWindow> zawierający następujące elementy potomne w celu określenia właściwości dla początkowego okna aplikacji:

   <content>HelloWorld.swf</content> Identyfikuje główny plik HTML, który ładuje środowisko AIR.

7. Dodaj element <supportedProfiles> .

   <supportedProfiles>mobileDevice</supportedProfiles> Wskazuje, że aplikacja działa wyłącznie w profilu urządzeń przenośnych.

8. Zapisz plik. Zakończony plik deskryptora aplikacji powinien być następujący:

   <?xml version="1.0" encoding="UTF-8"?> 
   <application xmlns="http://ns.adobe.com/air/application/2.7"> 
       <id>samples.android.HelloWorld</id> 
       <versionNumber>0.0.1</versionNumber> 
       <filename>HelloWorld</filename> 
       <initialWindow> 
           <content>HelloWorld.swf</content> 
       </initialWindow> 
       <supportedProfiles>mobileDevice</supportedProfiles> 
   </application>

W tym przykładzie przedstawiono ustawianie tylko kilku możliwych właściwości aplikacji. W pliku deskryptora aplikacji można również używać innych ustawień. Na przykład do elementu initialWindow można dodać ustawienie <fullScreen>true</fullScreen>, co pozwoli utworzyć aplikację pełnoekranową. W celu włączenia w systemie Android zdalnego debugowania i funkcji o kontrolowanym dostępie do deskryptora aplikacji trzeba również dodać uprawnienia systemu Android. Uprawnienia nie są wymagane w przypadku tej prostej aplikacji, więc na razie nie trzeba ich dodawać.

Więcej informacji zawiera rozdział Konfigurowanie właściwości aplikacji dla urządzeń przenośnych .

Utwórz plik o nazwie HelloWorld.as i dodaj poniższy kod, korzystając z edytora tekstu:

package 
{ 
    import flash.display.Sprite; 
    import flash.text.TextField; 
     
    public class HelloWorld extends Sprite 
    { 
        public function HelloWorld() 
        { 
            var textField:TextField = new TextField(); 
            textField.text = "Hello, World!"; 
            stage.addChild( textField ); 
        } 
    } 
}

Zanim możliwe będzie uruchomienie i zdebugowanie aplikacji należy skompilować kod MXML — w celu utworzenia pliku SWF — za pomocą kompilatora amxmlc. Kompilator amxmlc jest dostępny w katalogu bin pakietu Flex SDK. W razie potrzeby można ustawić ścieżkę środowiska komputera w taki sposób, aby uwzględniała katalog bin pakietu Flex SDK. Ustawienie ścieżki ułatwia uruchamianie programów narzędziowych z wiersza poleceń.

1. Otwórz powłokę lub terminal poleceń i przejdź do folderu projektu aplikacji AIR.

2. Wprowadź następujące polecenie:

   amxmlc HelloWorld.as 

Uruchomienie kompilatora amxmlc spowoduje utworzenie pliku HelloWorld.swf , który zawiera skompilowany kod aplikacji.

Więcej informacji zawiera rozdział Kompilowanie plików źródłowych MXML i ActionScript dla środowiska AIR .

W celu uruchomienia i przetestowania aplikacji z wiersza poleceń należy użyć programu AIR Debug Launcher (ADL), aby uruchomić aplikację za pomocą pliku deskryptora aplikacji. (Narzędzie ADL znajduje się w katalogu bin zestawu SDK środowisk AIR i Flex).

Do okna wiersza polecenia wprowadź następujące polecenie:

adl HelloWorld-app.xml 

Więcej informacji można znaleźć w sekcji Symulowanie urządzenia przy użyciu narzędzia ADL .

Jeśli aplikacja jest prawidłowo uruchamiana, można użyć narzędzia ADL w celu spakowania aplikacji do pliku pakietu APK. Plik pakietu APK jest natywnym formatem pliku systemu Android, który można rozpowszechniać wśród użytkowników.

Wszystkie aplikacje dla systemu Android muszą być podpisywane. W przeciwieństwie do plików AIR aplikacje dla systemu Android są zwyczajowo podpisywane za pomocą certyfikatu podpisanego automatycznie. System operacyjny Android nie próbuje ustalić tożsamości autora aplikacji. Do podpisywania pakietów dla systemu Android można używać certyfikatu utworzonego przez narzędzie ADT. Certyfikaty używane na potrzeby aplikacji wysyłanych do sklepu Android Market muszą być ważne przez co najmniej 25 lat.

Generowanie pary: certyfikat samopodpisany i klucz

Do wiersza poleceń wprowadź następujące polecenie (plik wykonywalny ADT można znaleźć w katalogu bin pakietu Flex SDK):

adt -certificate -validityPeriod 25 -cn SelfSigned 1024-RSA sampleCert.pfx samplePassword

W tym przykładzie zastosowano minimalną liczbę atrybutów, jakie można ustawić dla certyfikatu. Typem klucza musi być 1024-RSA lub 2048-RSA (zobacz Polecenie certificate narzędzia ADT ).

Tworzenie pakietu AIR

W wierszu polecenia wpisz następujące polecenie (w pojedynczym wierszu):

adt -package -target apk -storetype pkcs12 -keystore sampleCert.p12 HelloWorld.apk HelloWorld-app.xml HelloWorld.swf

Zostanie wyświetlona zachęta do wprowadzenia hasła pliku kluczy. Wpisz hasło i naciśnij klawisz Enter.

Więcej informacji zawiera rozdział Pakowanie aplikacji AIR dla urządzeń przenośnych .

Instalowanie środowiska wykonawczego AIR

Na urządzeniu można zainstalować najnowszą wersję środowiska wykonawczego AIR ze sklepu Android Market. Środowisko wykonawcze będące częścią zestawu SDK można zainstalować na urządzeniu lub w emulatorze systemu Android.

W wierszu poleceń wpisz następujące polecenie (w pojedynczym wierszu):

adt -installRuntime -platform android -platformsdk

Ustaw flagę -platformsdk wskazującą katalog zestawu SDK środowiska Android. (Określ folder nadrzędny folderu tools).

Narzędzie ADT zainstaluje plik Runtime.apk będący częścią zestawu SDK.

Więcej informacji zawiera sekcja Instalowanie środowiska wykonawczego AIR i aplikacji na potrzeby programowania .

Instalowanie aplikacji AIR

W wierszu poleceń wpisz następujące polecenie (w pojedynczym wierszu):

adt -installApp -platform android -platformsdk path-to-android-sdk -package path-to-app

Ustaw flagę -platformsdk wskazującą katalog zestawu SDK środowiska Android. (Określ folder nadrzędny folderu tools).

Więcej informacji zawiera sekcja Instalowanie środowiska wykonawczego AIR i aplikacji na potrzeby programowania .

Aplikację można uruchomić, dotykając ikony aplikacji na ekranie urządzenia lub emulatora.