NAZWAPLIKU
Nazwa pliku, w którym zostanie zapisany certyfikat.
HASAO
Hasło certyfikatu.
Aby wygenerować nowy samodzielnie podpisany certyfikat,
należy wykonać poniższe czynności:
1. Otworzyć okno terminala (Mac OS X) albo konsoli (Windows).
2. Przejść do katalogu, który zawiera pliki AIRHelloWorld.html
i AIRHelloWorld.xml.
3. Wydać poniższe polecenie:
adt -certificate -cn foo 1024-RSA test_cert.p12 mypass
W tym przykładzie nadajemy certyfikatowi nazwę foo i hasło
mypass.
62 | Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
Polecenie to wygeneruje samodzielnie podpisany certyfikat i zapi-
sze go w pliku o nazwie test_cert.p12.
UWAGA
Tego samego samodzielnie podpisanego certyfikatu można użyć
do podpisania wielu plików AIR.
W tym momencie powinniśmy mieć plik o nazwie test_cert.p12
w tym samym katalogu co pliki aplikacji. Teraz możemy użyć
tego certyfikatu do cyfrowego podpisania pliku AIR.
Generowanie pliku AIR
Pliki AIR tworzy się za pomocą narzędzia ADT dołączonego do
pakietu Adobe AIR SDK. Używa się go w następujący sposób:
adt -package OPCJEPODPISU NAZWAPLIKUAIR DOACZANEPLIKI
Aby utworzyć plik AIR podpisany za pomocą samodzielnie pod-
pisanego certyfikatu, należy wykonać poniższe czynności:
1. Otworzyć okno terminala (Mac OS X) albo konsoli (Windows).
2. Przejść do katalogu, który zawiera pliki AIRHelloWorld.html
i AIRHelloWorld.xml.
3. Wydać poniższe polecenie:
adt -package -storetype pkcs12 -keystore test_cert.p12
AIRHelloWorld.air AIRHelloWorld.xml AIRHelloWorld.html
4. Po wydaniu polecenia powinno pojawić się pytanie o hasło
do certyfikatu. Należy wprowadzić hasło, w tym przypadku
mypass.
Rozdział 2. Pierwsze kroki w Adobe AIR | 63
UWAGA
Podczas podpisywania pliku AIR narzędzie ADT próbuje skon-
taktować się z internetowym serwerem czasu, aby oznaczyć
plik bieżącą datą i godziną. Jeśli połączenie nie powiedzie
się, zostanie wyświetlony następujący komunikat o błędzie:
Could not generate timestamp
Podczas samodzielnego podpisywania pliku AIR można omi-
nąć ten błąd, nakazując narzędziu ADT, aby nie oznaczało pliku
bieżącą datą i godziną; w tym celu należy dodać do wiersza
polecenia następującą opcję:
-tsa none
W tym przypadku całe polecenie miałoby postać:
adt -package -storetype pkcs12 -keystore
test_cert.p12 -tsa none AIRHelloWorld.air
AIRHelloWorld.xml AIRHelloWorld.html
Powyższe polecenie powinno utworzyć plik o nazwie AIRHello-
World.air w tym samym katalogu, w którym znajdują się pliki apli-
kacji. Jeśli plik nie zostanie utworzony albo pojawią się jakieś błędy,
należy sprawdzić, czy:
" pakiet SDK jest skonfigurowany prawidłowo, a narzędzie
ADT znajduje się na ścieżce systemowej;
" polecenie ADT zostało wydane w katalogu, w którym znaj-
duje się plik AIRHelloWorld.xml;
" plik deskryptora aplikacji zawiera poprawny składniowo
kod XML;
" informacje w pliku deskryptora aplikacji są prawidłowe
(szczególną uwagę należy zwrócić na atrybuty application
i element content);
" pliki AIRHelloWorld.html, test_cert.p12 oraz AIRHelloWorld.xml
znajdują się w tym samym katalogu;
64 | Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
" podano to samo hasło, co podczas generowania pliku certy-
fikatu.
Testowanie i instalowanie pliku AIR
Po utworzeniu pliku AIR pozostaje nam tylko przetestować go
i sprawdzić, czy instaluje się prawidłowo.
Aby przetestować plik AIR, trzeba zainstalować go w systemie,
a następnie uruchomić. W tym celu należy:
1. W programie Eksplorator Windows (Windows) albo Finder
(Mac OS X) przejść do katalogu, który zawiera plik AIR.
2. Kliknąć dwukrotnie plik AIR.
3. Postępować według wskazówek wyświetlonych w oknie
instalacji.
4. Na ostatnim ekranie okna instalacji zaznaczyć pole wyboru
Start Application after installation.
Aplikacja powinna się uruchomić. Jeśli się nie uruchomi albo po-
jawi się komunikat o błędzie, należy sprawdzić, czy:
" w systemie została zainstalowana wersja 1.0 Adobe AIR;
" podczas tworzenia pliku AIR za pomocą ADT nie wystąpiły
żadne błędy;
" odinstalowano wstępne wersje Adobe AIR.
Jeśli aplikacja została zainstalowana i działa prawidłowo, można
uruchomić ją ponownie przez kliknięcie jej ikony. Domyślna loka-
lizacja skrótu zależy od systemu operacyjnego. W Macu skrót jest
tworzony w folderze /Applications. W Windows można go znalezć
w menu Start/Programy/.
Rozdział 2. Pierwsze kroki w Adobe AIR | 65
Wdrażanie pliku AIR
Po pomyślnym utworzeniu i spakowaniu aplikacji AIR można przy-
stąpić do jej rozpowszechniania. Aplikacje AIR można dystrybu-
ować w sieci WWW albo bezpośrednio na płytach CD-ROM lub
innych nośnikach.
UWAGA
Obszerne informacje o rozpowszechnianiu aplikacji Adobe AIR
przez sieć WWW można znalezć w dokumentacji Adobe AIR
oraz w samouczku pod adresem: http://www.adobe.com/devnet/air/
articles/air_badge_install.html.
Ustawianie typu MIME
Jeśli pliki AIR mają być udostępniane do pobrania przez serwer
WWW, należy zwrócić uwagę, aby w serwerze ustawiony był pra-
widłowy typ MIME. Jeśli typ MIME nie jest ustawiony poprawnie,
przeglądarki mogą potraktować plik AIR jak plik ZIP (przy okazji
zmieniając jego nazwę) albo wyświetlić bajty pliku w oknie prze-
glądarki zamiast pobrać aplikację do systemu użytkownika.
Prawidłowy typ MIME dla pliku AIR to:
application/vnd.adobe.air-application-installer-package+zip
Aby na przykład ustawić typ MIME w serwerze Apache, należy
dodać następujący wiersz do pliku konfiguracyjnego serwera:
AddType application/vnd.adobe.air-application-
installerpackage+zip .air
Informacje dotyczące ustawiania typów MIME w innych serwerach
można znalezć w ich dokumentacji.
W tym momencie czytelnicy wiedzą już, jak tworzyć, testować
i wdrażać proste aplikacje AIR. Teraz pora powiedzieć więcej o wy-
wołaniach API AIR oraz o budowaniu bardziej funkcjonalnych i za-
awansowanych aplikacji.
66 | Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy [ Pobierz całość w formacie PDF ]