Wydawnictwo Helion
ul. Koœciuszki 1c
44-100 Gliwice
tel. 032 230 98 63
e-mail: helion@helion.pl
Adobe AIR
dla programistów JavaScript.
Leksykon kieszonkowy
Autor: Mike Chambers, Daniel Dura,
Kevin Hoyt, Dragos Georgita
T³umaczenie: Grzegorz Werner
ISBN: 978-83-246-1960-3
Tytu³ orygina³u:
Adobe AIR for JavaScript
Developers Pocket Guide
Format: 115x170, stron: 200
Poznaj moc nowoczesnej technologii AIR
w tworzeniu funkcjonalnych aplikacji internetowych!
•
Jak skonfigurowaæ œrodowisko programistyczne w AIR?
•
Jak zaimplementowaæ funkcje?
•
Jak utworzyæ aplikacjê AIR, wykorzystuj¹c HTML i JavaScript?
Adobe AIR to nowe miêdzyplatformowe œrodowisko wykonawcze, które pozwala
programistom na wykorzystanie znanych technologii, takich jak HTML i JavaScript,
do tworzenia rozbudowanych aplikacji internetowych. AIR oferuje bogaty zbiór wywo³añ
API, a tak¿e œcis³¹ integracjê z pulpitem, co umo¿liwia ³¹czenie potêgi zasobów
lokalnych z dostêpem do internetu. O atrakcyjnoœci Adobe AIR œwiadcz¹ wiêc zarówno
zasiêg i ³atwoœæ programowania (najlepsze cechy modelu WWW), jak i funkcjonalnoœæ
oraz bogactwo modelu pulpitowego.
Ksi¹¿ka „Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy” stanowi
wprowadzenie do tworzenia aplikacji Adobe AIR z wykorzystaniem jêzyków HTML
i JavaScript. Leksykon zawiera przegl¹d mechanizmów wykonawczych HTML
i JavaScript w Adobe AIR oraz wyjaœnia, jak uzyskaæ dostêp do funkcji i interfejsów
Adobe AIR z poziomu JavaScript. Znajdziesz tu wszelkie porady i wskazówki niezbêdne
do tego, by skonfigurowaæ œrodowisko programistyczne, stworzyæ, przetestowaæ
i wdro¿yæ atrakcyjn¹ oraz funkcjonaln¹ aplikacjê WWW.
3
Spis tre
ļci
Przedmowa ...................................................................................5
1. Wprowadzenie do Adobe AIR ................................................... 18
Krótka historia aplikacji WWW
18
Problemy z dostarczaniem aplikacji
za poĈrednictwem przeglñdarki
21
Przeglñd Adobe AIR
23
Podstawowe technologie Adobe AIR
24
2. Pierwsze kroki w Adobe AIR ......................................................37
Co jest potrzebne do tworzenia aplikacji Adobe AIR?
37
Odinstalowywanie wstöpnych wersji Adobe AIR
39
Instalowanie Adobe AIR
41
Odinstalowywanie Adobe AIR
42
Konfigurowanie Adobe AIR SDK i narzödzi wiersza poleceþ
42
Tworzenie prostej aplikacji AIR przy uĔyciu HTML-a
i JavaScriptu
48
Testowanie aplikacji
55
Pakowanie i wdraĔanie aplikacji AIR
59
3. Praca z j
ýzykami JavaScript i HTML w Adobe AIR ....................67
WebKit w Adobe AIR
67
JavaScript w Adobe AIR
70
Implementacja funkcji w AIR
71
4
_ Spis treļci
Model bezpieczeþstwa
79
UĔywanie szkieletów JavaScriptu
87
Rozwiñzywanie problemów z aplikacjami AIR
98
4. Minireceptury Adobe AIR ........................................................ 103
WdraĔanie aplikacji
103
Styl aplikacji
108
Obsäuga okien
111
Plikowy interfejs API
121
Wybieranie plików
140
Monitorowanie usäugi i serwera
147
Online-offline
152
Przeciñganie i upuszczanie
155
Osadzona baza danych
161
Argumenty wiersza polecenia
174
Sieè
176
DĒwiök
185
A Aliasy JavaScriptu ..................................................................... 187
Skorowidz ................................................................................ 193
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 37
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR
W tym rozdziale wyjaĈnimy, jak zaczñè tworzenie aplikacji Adobe
AIR z wykorzystaniem HTML-a i JavaScriptu. Omówimy:
x instalacjö Adobe AIR;
x konfigurowanie Adobe AIR SDK i narzödzia wiersza poleceþ;
x tworzenie pierwszej aplikacji AIR;
x testowanie aplikacji AIR;
x podpisywanie, pakowanie i wdraĔanie aplikacji AIR.
Pod koniec tego rozdziaäu czytelnicy bödñ dysponowali prawi-
däowo skonfigurowanym Ĉrodowiskiem do tworzenia aplika-
cji AIR. Bödñ teĔ wiedzieli, jak buduje siö, testuje i wdraĔa apli-
kacje Adobe AIR.
Co jest potrzebne
do tworzenia aplikacji Adobe AIR?
Aby przystñpiè do tworzenia aplikacji AIR, trzeba dysponowaè
kilkoma elementami.
Ļrodowisko uruchomieniowe Adobe AIR
ćrodowisko uruchomieniowe Adobe AIR jest potrzebne do testo-
wania ikon oraz wdraĔania aplikacji Adobe AIR. ćrodowisko moĔ-
na pobraè bezpäatnie pod adresem: http://www.adobe.com/go/getair.
Adobe AIR SDK
Pakiet Adobe AIR SDK zawiera narzödzia wiersza poleceþ, przy-
käadowe pliki i inne zasoby, które uäatwiajñ tworzenie aplikacji AIR.
38
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
W szczególnoĈci bödziemy uĔywaè narzödzi wiersza poleceþ do-
äñczonych do SDK (ADL i ADT), które umoĔliwiñ testowanie, pod-
pisywanie i pakowanie aplikacji AIR z poziomu praktycznie do-
wolnego Ĉrodowiska programistycznego.
AIR SDK moĔna pobraè bezpäatnie pod adresem: http://www.adobe.
´
com/go/getairsdk.
Zintegrowane
ļrodowisko programistyczne
lub edytor HTML/JavaScript
Budowanie aplikacji AIR przy uĔyciu HTML-a i JavaScriptu wy-
maga jakiegoĈ sposobu tworzenia plików HTML i JavaScript. MoĔna
uĔyè dowolnego narzödzia, które pozwala na tworzenie i edycjö
plików tekstowych (takiego jak VIM lub Notatnik), choè warto
posäuĔyè siö narzödziem uäatwiajñcym pracö z plikami HTML
i JavaScript, takim jak Adobe Dreamweaver, Coda albo Aptana
Studio.
UWAGA
Wiöcej informacji o programie Adobe Dreamweaver moĔna
znaleĒè pod adresem: http://www.adobe.com/go/dreamweaver;
o Codzie firmy Panic — pod adresem: http://www.panic.com/coda/;
a o Aptana Studio — pod adresem: http://www.aptana.com.
Obs
ĥugiwane systemy operacyjne
Choè aplikacje AIR moĔna tworzyè i pakowaè w praktycznie do-
wolnym systemie operacyjnym (takĔe w Linuksie), ich testowanie
i wdraĔanie jest moĔliwe tylko w systemach, które sñ obsäugiwane
przez Adobe AIR.
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 39
Obsäugiwane systemy operacyjne to:
x Microsoft Windows 2000 SP4,
x Microsoft Windows XP SP2,
x Windows Vista Home Premium, Business, Ultimate lub
Enterprise,
x Mac OS 10.4.910 i nowsze wersje (procesory Intel i PowerPC).
UWAGA
Odtwarzanie wideo H.264 w systemie Mac wymaga procesora
Intela.
Adobe obecnie pracuje nad wersjñ Adobe AIR dla Linuksa.
Odinstalowywanie wst
ýpnych wersji Adobe AIR
Ci, którzy zainstalowali wstöpne wersje Adobe AIR (alfa lub beta),
byè moĔe bödñ musieli odinstalowaè je przed zainstalowaniem
wersji 1.0. Nie zawsze jest to jednak konieczne.
W tabeli 2.1 wymieniono wstöpne wersje Adobe AIR i wyjaĈniono,
czy trzeba je odinstalowaè przez przed zainstalowaniem wersji 1.0.
Tabela 2.1. Wstöpne wersje Adobe AIR
Wersja
Odinstalowa
ë?
Alfa
Odinstalowa
ë
Beta 1
Zostanie odinstalowana automatycznie przez instalator Adobe AIR 1.0
Beta 2
Nie trzeba odinstalowywa
ë
Beta 3
Nie trzeba odinstalowywa
ë
40
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
Jak widaè w tabeli 2.1, wersje beta 2 i beta 3 mogñ dziaäaè obok
Adobe AIR 1.0. UmoĔliwia to uruchamianie aplikacji zbudowanych
pod kñtem wersji beta 2 i beta 3, dopóki nie skoþczy siö waĔnoĈè
tych wersji.
Ci, którzy nie wiedzñ, czy zainstalowali wersjö alfa, na wszelki wy-
padek powinni odinstalowaè wszystkie wstöpne wersje Adobe AIR.
Odinstalowywanie w Windows
Aby odinstalowaè wszystkie wstöpne wersje Adobe AIR w systemie
Windows, naleĔy wykonaè poniĔsze czynnoĈci:
1. Z menu Start wybraè polecenie Ustawienia/Panel sterowania.
2. Kliknñè dwukrotnie ikonö Dodaj lub usuþ programy.
3. Wybraè wstöpnñ wersjö Adobe AIR, która ma zostaè odinsta-
lowana (w zaleĔnoĈci od wersji moĔe ona nosiè pseudonim
„Apollo”).
4. Kliknñè przycisk Zmieþ/usuþ.
Odinstalowywanie w systemie Mac
Aby odinstalowaè wszystkie wstöpne wersje Adobe AIR w syste-
mie Mac, naleĔy wykonaè opisane niĔej czynnoĈci. W zaleĔnoĈci od
zainstalowanych wersji niektóre etapy bödzie moĔna pominñè.
1. Uruchomiè program Adobe AIR Uninstaller w katalogu
/Users/
<u
šytkownik>
/Applications (gdzie
<u
šytkownik>
jest
nazwñ konta w systemie).
2. Uruchomiè program Adobe AIR Uninstaller w katalogu
/Applications.
3. Usunñè katalog /Library/Frameworks/Adobe Apollo.framework.
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 41
4. Usunñè plik /Library/Receipts/Adobe Apollo.pkg.
5. OpróĔniè kosz.
Po wykonaniu tych czynnoĈci moĔna przystñpiè do instalacji wersji
1.0 Ĉrodowiska uruchomieniowego.
Instalowanie Adobe AIR
Choè tworzenie i testowanie aplikacji Adobe AIR nie wymaga in-
stalowania Ĉrodowiska Adobe AIR, warto to zrobiè, aby wypró-
bowaè inne aplikacje AIR oraz przetestowaè pakowanie i wdra-
Ĕanie wäasnej aplikacji.
Instalowanie Ĉrodowiska uruchomieniowego jest proste. Wystarczy
pobraè i uruchomiè instalator Adobe AIR. W tym celu naleĔy:
1. Pobraè instalator AIR pod adresem: http://www.adobe.com/go/
´
getair.
2. Uruchomiè instalator. W Macu trzeba najpierw zamontowaè
plik .dmg, który zawiera program instalacyjny.
3. Postöpowaè wedäug wskazówek instalatora.
UWAGA
MoĔna równieĔ zainstalowaè Adobe AIR bezpoĈrednio z po-
ziomu Ĉrodowiska uruchomieniowego przy uĔyciu instalacji
ekspresowej. Opiszemy to w rozdziale 4.
Adobe AIR to Ĉrodowisko uruchomieniowe, a nie aplikacja, którñ
moĔna wykonaè. ēeby sprawdziè, czy zostaäo zainstalowane pra-
widäowo, najproĈciej bödzie zainstalowaè aplikacjö AIR. W tym
celu moĔna pobraè i zainstalowaè dowolnñ aplikacjö AIR albo sa-
modzielnie zbudowaè prostñ aplikacjö AIR wedäug wskazówek
zamieszczonych w dalszej czöĈci rozdziaäu.
42
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
UWAGA
Przykäadowe aplikacje AIR moĔna pobraè z witryny firmy
Adobe pod adresem: http://www.adobe.com/go/air_samples.
Odinstalowywanie Adobe AIR
Proces odinstalowywania Adobe AIR zaleĔy od uĔywanego systemu
operacyjnego.
Odinstalowywanie w Windows
W Windows moĔna odinstalowaè Adobe AIR w taki sam sposób
jak kaĔdñ innñ aplikacjö. Wystarczy wybraè pozycjö Adobe AIR
w oknie Dodawanie lub usuwanie programów w Panelu sterowania.
Odinstalowywanie w Macu
Instalator Adobe AIR umieszcza program deinstalacyjny w syste-
mie uĔytkownika. Aby odinstalowaè Adobe AIR, naleĔy uruchomiè
program o nazwie Adobe AIR Uninstaller, który znajduje siö
w katalogu /Applications/Utilities.
Konfigurowanie Adobe AIR SDK
i narz
ýdzi wiersza poleceħ
Adobe AIR SDK zawiera narzödzia i próbki kodu, które uäatwiajñ
tworzenie, testowanie i wdraĔanie aplikacji. W szczególnoĈci zawiera
dwa narzödzia wiersza poleceþ, którymi bödziemy siö posäugiwaè:
ADL
To narzödzie säuĔy do uruchamiania i testowania aplikacji
Adobe AIR bez jej uprzedniego instalowania.
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 43
ADT
To narzödzie säuĔy do pakowania i podpisywania aplikacji
AIR w celu przygotowania jej do dystrybucji.
Instalowanie Adobe AIR SDK
Aby uäatwiè sobie pracö, naleĔy umieĈciè te pliki na ĈcieĔce syste-
mowej. Dziöki temu bödzie moĔna uruchamiaè narzödzia z do-
wolnego katalogu.
Narzödzia wiersza poleceþ znajdujñ siö w katalogu bin pakietu SDK.
W celu zainstalowania pakietu naleĔy wykonaè poniĔsze czynnoĈci:
1. Pobraè Adobe AIR SDK pod adresem: http://www.adobe.com/
´
go/getairsdk.
2. Otworzyè pakiet SDK:
a. W Windows — zdekompresowaè archiwum ZIP.
b. W Macu — zamontowaè plik .dmg.
3. Skopiowaè zawartoĈè SDK do systemu (bödziemy okreĈlaè tö
lokalizacjö mianem
<
Łcieška_SDK>
).
UWAGA
Aby uruchamiaè narzödzia wiersza poleceþ, wystarczy
skopiowaè katalogi bin, lib i runtime z pakietu SDK.
NaleĔy zachowaè wzglödne poäoĔenie ĈcieĔek do ka-
talogów bin, lib i runtime.
4. W tym momencie na dysku powinny znajdowaè siö przy-
najmniej trzy nastöpujñce katalogi:
<
Łcieška_SDK>
/bin,
<
Łcieš
´
ka_SDK>
/lib oraz
<
Łcieška_SDK>
/runtime. Narzödzia ADL
i ADT znajdujñ siö w katalogu bin.
44
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
Umieszczanie narz
ýdzi wiersza poleceħ
na
ļcieżce systemowej
Teraz wystarczy umieĈciè katalog
<
Łcieška_SDK>
/bin na ĈcieĔce
systemowej, aby móc uruchamiaè aplikacje wiersza poleceþ z do-
wolnego miejsca w systemie.
Sposób wykonania tego zadania zaleĔy od uĔywanego systemu
operacyjnego (Windows lub Mac).
Windows
UĔytkownicy Windows powinni wykonaè nastöpujñce czynnoĈci:
1. Otworzyè okno dialogowe WäaĈciwoĈci systemu (moĔna je zna-
leĒè w Panelu sterowania) i kliknñè zakäadkö Zaawansowane.
2. Kliknñè przycisk Zmienne Ĉrodowiskowe.
3. Zaznaczyè pozycjö PATH i kliknñè przycisk Edytuj. Dodaè
ĈcieĔkö do katalogu bin na koþcu bieĔñcej wartoĈci zmiennej,
oddzielajñc jñ Ĉrednikiem:
; <
Łcieška_sdk>/bin
Edytowanie ĈcieĔki w Windows pokazano na rysunku 2.1.
4. Kliknñè przycisk OK, aby zamknñè okno dialogowe.
Aby przetestowaè instalacjö, naleĔy otworzyè nowñ konsolö Win-
dows (Start/Uruchom/cmd) i wpisaè polecenie
adt
.
UWAGA
NaleĔy otworzyè nowe okno konsoli, aby zostaäy uwzglödnione
nowe ustawienia zmiennej PATH.
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 45
Rysunek 2.1. Umieszczanie narzödzi wiersza poleceþ na systemowej
ĈcieĔce w Windows
Powinny pojawiè siö nastöpujñce wyniki:
usage:
adt -package SIGNING_OPTIONS <air-file> <app-desc>
FILE_ARGS
adt -prepare <airi-file> <app-desc> FILE_ARGS
adt -sign SIGNING_OPTIONS <airi-file> <air-file>
adt -checkstore SIGNING_OPTIONS
adt -certificate -cn <name> ( -ou <org-unit> )?
( -o <org-name> )? ( -c <country> )?
<key-type> <pfx-file> <password>
adt -help
SIGNING_OPTIONS: -storetype <type> ( -keystore <store> )?
( -storepass <pass> )? ( -keypass <pass> )? ( -providerName
<name> )? ( -tsa <url> )?
FILE_ARGS: <fileOrDir>* (( -C <dir> <fileOrDir>+ ) |
( -e <file> <path> ))* -C dir
46
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
Oznacza to, Ĕe narzödzia sñ skonfigurowane prawidäowo.
JeĈli pojawi siö komunikat, Ĕe nie znaleziono pliku, naleĔy:
x Upewniè siö, Ĕe katalogi bin, lib i runtime znajdujñ siö w ka-
talogu
<
Łcieška_SDK>
.
x Upewniè siö, Ĕe ĈcieĔka do katalogu
<
Łcieška_SDK>
jest doäñ-
czona do zmiennej Ĉrodowiskowej
PATH
.
x Upewniè siö, Ĕe przed wydaniem polecenia zostaäo otwarte
nowe okno konsoli.
Mac
Istnieje kilka sposobów dodawania AIR SDK do ĈcieĔki syste-
mowej, w zaleĔnoĈci od uĔywanej powäoki oraz metody okre-
Ĉlania zmiennych uĔytkownika.
PoniĔej wyjaĈniono, jak zmodyfikowaè zmiennñ Ĉrodowiskowñ
PATH
w powäoce bash. W tym celu naleĔy wykonaè poniĔsze
czynnoĈci:
1. Otworzyè program Terminal (/Applications/Utilities/Terminal).
PrzejĈè do katalogu macierzystego, wpisaè polecenie
cd
i naci-
snñè klawisz Enter.
2. Wydaè polecenie
ls -la
, aby sprawdziè, czy obecny jest
jeden z dwóch plików z ustawieniami powäoki.
3. Poszukaè pliku o nazwie .profile lub .bashrc.
4. JeĈli nie ma Ĕadnego z tych plików, utworzyè plik .profile za
pomocñ polecenia
touch .profile
.
5. Otworzyè plik .profile lub .bashrc w edytorze tekstu.
6. Poszukaè wiersza o mniej wiöcej takiej zawartoĈci:
export PATH=$PATH:/usr/local/bin
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 47
7. Na koþcu tego wiersza dodaè ĈcieĔkö do katalogu
<
Łcieš
´
ka_SDK>
/bin. JeĈli na przykäad ĈcieĔkñ do katalogu bin jest
/airsdk/bin, polecenie eksportu powinno wyglñdaè mniej wiö-
cej tak:
export PATH=$PATH:/usr/local/bin:/airsdk/bin
Poszczególne pozycje ĈcieĔki powinny byè rozdzielone dwu-
kropkami.
8. JeĈli plik jest pusty, dodaè do niego nastöpujñcy wiersz:
export PATH=$PATH:/airsdk/bin
9. Zapisaè i zamknñè plik.
10. Wydaè polecenie
source .profile
(albo
source .bashrc
,
jeĈli zmodyfikowano plik .bashrc), aby wczytaè nowe usta-
wienia.
11. Sprawdziè, czy nowe ustawienia zostaäy uwzglödnione, przez
wpisanie
echo $PATH
i naciĈniöcie klawisza Enter. ćcieĔka do
katalogu
<
Łcieška_SDK>
/bin powinna pojawiè siö w wynikach
polecenia.
12. W celu przetestowania instalacji otworzyè okno terminala
i wydaè polecenie
adt
.
Powinny pojawiè siö nastöpujñce wyniki:
usage:
adt -package SIGNING_OPTIONS <air-file> <app-desc>
FILE_ARGS
adt -prepare <airi-file> <app-desc> FILE_ARGS
adt -sign SIGNING_OPTIONS <airi-file> <air-file>
adt -checkstore SIGNING_OPTIONS
adt -certificate -cn <name> ( -ou <org-unit> )?
( -o <org-name> )? ( -c <country> )?
<key-type> <pfx-file> <password>
adt -help
SIGNING_OPTIONS: -storetype <type> ( -keystore
<store> )? ( -storepass <pass> )? ( -keypass <pass> )?
48
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
( -providerName <name> )? ( -tsa <url> )? FILE_ARGS:
<fileOrDir>* (( -C <dir> <fileOrDir>+ ) | ( -e <file>
<path> ))* -C
Oznacza to, Ĕe narzödzia sñ skonfigurowane prawidäowo.
JeĈli pojawi siö komunikat, Ĕe nie znaleziono pliku, naleĔy:
x Upewniè siö, Ĕe katalogi bin, lib i runtime znajdujñ siö w kata-
logu
<
Łcieška_SDK>
.
x Upewniè siö, Ĕe ĈcieĔka do katalogu
<
Łcieška_SDK>
jest pra-
widäowo doäñczona do zmiennej Ĉrodowiskowej
PATH
.
x Upewniè siö, Ĕe przed wydaniem polecenia zostaäo otwarte
nowe okno terminala albo Ĕe przetworzono plik konfiguracyj-
ny poleceniem
source
.
Tworzenie prostej aplikacji AIR
przy u
życiu HTML-a i JavaScriptu
Po zainstalowaniu Adobe AIR i Adobe AIR SDK jesteĈmy gotowi
do napisania pierwszej aplikacji AIR.
Utworzymy bardzo prosty przykäad: „Witaj, Ĉwiecie”. PomyĈlne
zbudowanie i przetestowanie aplikacji bödzie oznaczaè, Ĕe nasze
Ĉrodowisko programistyczne jest prawidäowo skonfigurowane do
budowania bardziej zäoĔonych i funkcjonalnych aplikacji AIR.
Tworzenie plików aplikacji
KaĔda aplikacja Adobe AIR skäada siö przynajmniej z dwóch
plików. Pierwszy to gäówny plik treĈci. Jest to podstawowy plik
HTML lub SWF, który zostanie wyĈwietlony (wykonany) zaraz po
uruchomieniu aplikacji.
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 49
Drugi plik jest nazywany plikiem deskryptora aplikacji. Jest to plik
XML, który zawiera metadane aplikacji uĔywane przez Ĉrodowi-
sko Adobe AIR.
Utwórzmy te pliki na uĔytek naszej aplikacji. W tym celu naleĔy:
1. Utworzyè nowy folder o nazwie AIRHelloWorld.
2. W tym folderze utworzyè dwa nowe pliki o nazwie AIRHello-
World.html i AIRHelloWorld.xml.
3. Otworzyè oba pliki w ulubionym edytorze tekstu lub kodu
HTML (albo w Ĉrodowisku IDE).
Pliki deskryptora aplikacji
Plik deskryptora aplikacji to plik XML, który jest wymagany przez
kaĔdñ aplikacjö Adobe AIR. Zawiera on ogólne metadane (takie jak
nazwa i opis aplikacji) uĔywane przez Adobe AIR, a takĔe informa-
cje dotyczñce sposobu, w jaki aplikacja powinna byè uruchamiana.
OkreĈla siö w nim gäówny plik aplikacji oraz poczñtkowy tryb
wyĈwietlania okna.
Najpierw przyjrzymy siö caäemu plikowi deskryptora (AIRHello-
World.xml) naszej aplikacji, a nastöpnie omówimy jego poszczególne
elementy.
UWAGA
Przykäadowy plik deskryptora aplikacji znajduje siö w pakiecie
AIR SDK w folderze templates.
NaleĔy otworzyè plik AIRHelloWorld.xml i wpisaè nastöpujñcy tekst:
<?xml version="1.0" encoding="utf-8" ?>
<application
xmlns="http://ns.adobe.com/air/application/1.0">
<id>com.oreilly.AIRHelloWorld</id>
<filename>AIRHelloWorld</filename>
50
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
<name>AIR Hello World</name>
<description>Prosta aplikacja AIR</
description> <version>1.0</version>
<initialWindow>
<content>AIRHelloWorld.html</content>
<title>AIR Hello World</title>
<systemChrome>standard</systemChrome>
<transparent>false</transparent>
<visible>true</visible>
<minimizable>true</minimizable>
<maximizable>true</maximizable>
<resizable>true</resizable>
</initialWindow>
</application>
TreĈè pliku jest doĈè oczywista, ale omówimy jñ wiersz po wierszu,
aby dokäadnie zrozumieè znaczenie poszczególnych elementów.
<application xmlns="http://ns.adobe.com/air/application/1.0">
Przestrzeþ nazw okreĈla wersjö Adobe AIR przyjötñ przez aplikacjö
— w tym przypadku 1.0.
Przyjrzyjmy siö nastöpnemu elementowi:
<id>com.oreilly.AIRHelloWorld</id>
Element
id
jest waĔny; okreĈla on unikatowy identyfikator aplikacji.
Adobe AIR uĔywa identyfikatorów do odróĔniania poszczególnych
aplikacji.
Jak widaè, uĔyto odwrotnego formatu domenowego, który czytel-
nicy mogñ znaè z jözyków programowania takich jak Java, Action-
Script i niektóre szkielety JavaScript. MoĔna utworzyè wäasny iden-
tyfikator z nazwy aplikacji i nazwy domeny.
Nastöpna sekcja elementów okreĈla ogólne metadane aplikacji:
<filename>AIRHelloWorld</filename>
<name>AIR Hello World</name>
<description>Prosta aplikacja AIR</
description> <version>1.0</version>
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 51
Poszczególne elementy sñ opisane w tabeli 2.2.
Tabela 2.2. Elementy metadanych aplikacji
Element
Opis
filename
Nazwa natywnego pliku aplikacji, który zostanie utworzony.
name
Nazwa aplikacji. Ta nazwa b
ýdzie widoczna dla systemu
operacyjnego i dla u
żytkownika.
description
Element opcjonalny. Opis aplikacji, który zostanie pokazany
u
żytkownikowi podczas procesu instalacji.
version
Element wymagany. Okre
ļla wersjý aplikacji (také jak „1.0”, „v1” itd.).
Nastöpny element to tag
initialWindow
, który zawiera elementy
okreĈlajñce sposób wykonania aplikacji przez Ĉrodowisko urucho-
mieniowe:
<initialWindow>
<content>AIRHelloWorld.html</content>
<title>AIR Hello World</title>
<systemChrome>standard</systemChrome>
<transparent>false</transparent>
<visible>true</visible>
<minimizable>true</minimizable>
<maximizable>true</maximizable>
<resizable>true</resizable>
</initialWindow>
Element
content
jest wymagany i wskazuje gäówny plik aplikacji,
w tym przypadku plik HTML.
UWAGA
Plik deskryptora aplikacji i gäówny plik treĈci muszñ znajdowaè
siö w tym samym folderze.
Element
initialWindow
zawiera kilka innych elementów, które
okreĈlajñ poczñtkowe parametry okna oraz styl aplikacji w mo-
mencie jej uruchomienia (tabela 2.3).
52
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
Tabela 2.3. Elementy initialWindow
Element
Opis
title
Tytu
ĥ gĥównego okna aplikacji. Element opcjonalny.
systemChrome
Styl systemowy, którego powinna u
żywaë aplikacja
(
standard
lub
none
).
transparent
Wskazuje, czy t
ĥo aplikacji powinno byë przezroczyste. Ta opcja
ma zastosowanie tylko wtedy, gdy element
systemChrome
ma
warto
ļë
none
. Element opcjonalny. Warto
ļë domyļlna to
false
.
visible
Wskazuje, czy aplikacja b
ýdzie widoczna zaraz po uruchomieniu.
Przydaje si
ý, jeļli aplikacja musi przeprowadzië jakéļ skomplikowané
inicjalizacj
ý, zanim wyļwietli interfejs użytkownika. Element
opcjonalny. Warto
ļë domyļlna to
false
.
minimizable
Wskazuje, czy aplikacja mo
że byë minimalizowana. Element
opcjonalny. Warto
ļë domyļlna to
true
.
maximizable
Wskazuje, czy aplikacja mo
że byë maksymalizowana.
Element opcjonalny. Warto
ļë domyļlna to
true
.
resizable
Wskazuje, czy mo
żna zmieniaë rozmiar okna aplikacji.
Element opcjonalny. Warto
ļë domyļlna to
true
.
W naszym przykäadzie uĔyjemy stylu okien systemu operacyjnego.
UWAGA
ZauwaĔmy, Ĕe element
visible
ma domyĈlnñ wartoĈè
false
.
Oznacza to, Ĕe jeĈli bezpoĈrednio nie ustawimy go na
true
,
uruchomiona aplikacja nie bödzie miaäa interfejsu uĔytkownika.
W takim przypadku trzeba bödzie ustawiè wäaĈciwoĈè
visible
na
true
metodñ programowñ.
MoĔe to byè przydatne, jeĈli aplikacja zaraz po uruchomieniu
musi przeprowadziè jakñĈ skomplikowanñ inicjalizacjö lub
rozmieĈciè elementy. W takim przypadku moĔna pozwoliè jej
na wykonanie tych operacji i dopiero wtedy wyĈwietliè inter-
fejs uĔytkownika.
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 53
To wszystko, co jest potrzebne w pliku deskryptora naszej aplikacji.
Teraz jesteĈmy gotowi do utworzenia gäównego pliku HTML
aplikacji.
Tworzenie g
ĥównego pliku aplikacji
Gäówny plik aplikacji jest wczytywany w momencie uruchamiania
aplikacji. MoĔe to byè albo skompilowany plik Flash (SWF), albo
plik HTML.
W tym rozdziale utworzymy bardzo prosty plik HTML, aby spraw-
dziè, czy nasze Ĉrodowisko programistyczne jest skonfigurowane
prawidäowo. Bardziej zaawansowane zastosowania AIR API zosta-
nñ omówione w rozdziaäach 3. i 4.
<html>
<head>
<title>AIRHelloWorld</title>
<script>
function init()
{
runtime.trace("wywo
Īano funkcjĂ init");
}
</script>
</head>
<body onload="init()">
<div align="center">Witaj,
Łwiecie</div>
</body>
</html>
Jak widaè, jest to bardzo prosty plik HTML, który po wczytaniu
i inicjalizacji wyĈwietla napis „Witaj, Ĉwiecie” oraz wywoäuje funk-
cjö JavaScriptu.
Warto zwróciè uwagö na kilka wierszy:
<body onload="init()">
Ten wiersz wskazuje, Ĕe uĔywamy standardowego zdarzenia
onload
elementu
body
jako punktu wejĈcia do kodu JavaScript
naszej aplikacji.
54
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
<script>
function init()
{
...
}
</script>
W tych wierszach uĔywamy standardowej funkcji JavaScriptu do
przechwycenia zdarzenia
onload
.
Dost
ýp do wywoĥaħ API Adobe AIR
W funkcji JavaScriptu znajduje siö kod, który moĔe nie byè
znajomy:
runtime.trace("wywo
Īano funkcjĂ init");
Jest to jedyny specyficzny dla AIR kod w caäej aplikacji. WäaĈci-
woĈè
runtime
jest doäñczana do obiektu okna przez Adobe AIR
i zapewnia punkt wejĈcia do mechanizmu Adobe AIR oraz jego
wywoäaþ API. Funkcja
trace
to wywoäanie API najwyĔszego
poziomu, które przyjmuje äaþcuch i wyĈwietla go w wierszu pole-
ceþ (jeĈli aplikacja zostaäa uruchomiona z wiersza poleceþ).
W jözyku JavaScript dostöp do wywoäaþ API charakterystycznych
dla AIR (w tym do wywoäaþ Flash Playera) odbywa siö za poĈred-
nictwem wäaĈciwoĈci
runtime
. Omówimy to bardziej szczegóäowo
w dalszej czöĈci ksiñĔki.
UWAGA
Sprawdzenie wäaĈciwoĈci
runtime
to prosty sposób ustalenia,
czy aplikacja HTML/JavaScript dziaäa w Ĉrodowisku Adobe
AIR. Aby sprawdziè tö wäaĈciwoĈè, naleĔy uĔyè nastöpujñcego
kodu:
if(window.runtime)
{
// aplikacja dzia
áa w Ğrodowisku AIR
}
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 55
Skoro mamy juĔ plik deskryptora aplikacji i gäówny plik HTML,
moĔemy przetestowaè dziaäanie aplikacji w Ĉrodowisku urucho-
mieniowym.
Testowanie aplikacji
Choè niektóre Ĉrodowiska IDE do pisania kodu HTML (na przy-
käad Adobe Dreamweaver) obsäugujñ bezpoĈrednie uruchamianie
i testowanie aplikacji AIR, my skupimy siö na narzödziu ADL
wchodzñcym w skäad pakietu SDK. W ten sposób czytelnicy lepiej
zrozumiejñ caäy proces. Ponadto ADL zapewnia najwiökszñ ela-
stycznoĈè, jeĈli chodzi o integracjö procesu tworzenia aplikacji
z innymi Ĉrodowiskami IDE, edytorami i obiegami pracy.
Uruchamianie aplikacji za pomoc
é ADL
Pierwszym etapem testowania aplikacji jest uruchomienie jej
w Ĉrodowisku AIR i upewnienie siö, Ĕe:
x w pliku deskryptora aplikacji nie ma Ĕadnych bäödów;
x aplikacja uruchamia siö;
x kod HTML jest wyĈwietlany prawidäowo;
x kod JavaScript dziaäa w oczekiwany sposób.
Choè moglibyĈmy spakowaè caäñ aplikacjö, a póĒniej jñ zainstalo-
waè, byäoby to Ĕmudne i utrudniäo proces modyfikowania kodu
oraz testowania nowych wersji. Na szczöĈcie pakiet Adobe AIR SDK
zawiera narzödzie wiersza poleceþ o nazwie ADL, które umoĔli-
wia uruchomienie aplikacji AIR bez jej instalacji.
Aby przetestowaè aplikacjö, naleĔy:
1. Otworzyè okno terminala (w Macu) albo okno konsoli
(w Windows).
56
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
2. PrzejĈè do katalogu, który zawiera pliki AIRHelloWorld.html
i AIRHelloWorld.xml.
3. Uruchomiè program ADL za pomocñ poniĔszego polecenia,
przekazujñc nazwö pliku deskryptora aplikacji:
adl AIRHelloWorld.xml
Aplikacja powinna uruchomiè siö w standardowym oknie systemu
operacyjnego (rysunek 2.2).
Rysunek 2.2. Aplikacja AIRHelloWorld uruchomiona za pomocñ
programu ADL w systemie Windows Vista
JeĈli aplikacja nie uruchomi siö prawidäowo albo jeĈli wystñpi
bäñd, naleĔy sprawdziè, czy:
x pakiet SDK zostaä skonfigurowany w taki sposób, Ĕe system
moĔe odnaleĒè narzödzia ADL;
x polecenie ADL zostaäo wydane w katalogu, w którym znajduje
siö plik AIRHelloWorld.xml;
x plik deskryptora aplikacji zawiera poprawny skäadniowo
kod XML;
x informacje w pliku deskryptora aplikacji sñ prawidäowe
(szczególnñ uwagö naleĔy zwróciè na atrybuty
application
i element
initialWindow
);
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 57
x pliki AIRHelloWorld.html i AIRHelloWorld.xml znajdujñ siö
w tym samym katalogu.
Po rozwiñzaniu ewentualnych problemów i pomyĈlnym urucho-
mieniu aplikacji moĔemy zbadaè, jak uzyskaè informacje od apli-
kacji w czasie jej dziaäania.
Przechwytywanie danych wyj
ļciowych aplikacji
Kiedy aplikacja jest uruchamiana z wiersza poleceþ za poĈrednic-
twem ADL, moĔna uzyskaè jej dane wyjĈciowe i informacje dia-
gnostyczne na kilka róĔnych sposobów.
B
ĥýdy JavaScriptu
Wszystkie bäödy spowodowane wykonywaniem JavaScriptu w apli-
kacji uruchomionej za poĈrednictwem ADL sñ przekazywane na
standardowe wyjĈcie ADL.
Zmodyfikujmy aplikacjö tak, aby w czasie wykonania generowaäa
bäñd JavaScriptu. TreĈè pliku AIRHelloWorld.html naleĔy zmieniè
w nastöpujñcy sposób:
<html>
<head>
<title>AIRHelloWorld</title>
<script>
function init()
{
runtime2.trace("wywo
Ĩano funkcjĀ init");
}
</script>
</head>
<body onload="init()">
<div align="center">Witaj,
Łwiecie</div>
</body>
</html>
58
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
ZmieniliĈmy funkcjö
init
w taki sposób, aby próbowaäa uzyskaè
dostöp do nieistniejñcej wäaĈciwoĈci o nazwie
runtime2
:
runtime2.trace("wywo
Īano funkcjĂ init");
Zapiszmy aplikacjö i wykonajmy jñ za poĈrednictwem ADL:
adl AIRHelloWorld.xml
Po uruchomieniu aplikacji w wierszu poleceþ powinien pojawiè siö
nastöpujñcy komunikat o bäödzie:
ReferenceError: Can't find variable: runtime2
init at app:/AIRHelloWorld.html : 8
init at app:/AIRHelloWorld.html : 8
onload at app:/AIRHelloWorld.html : 13
Komunikat opisuje bäñd (w tym przypadku polegajñcy na tym, Ĕe
nie odnaleziono zmiennej o nazwie
runtime2
) i pokazuje, w któ-
rym wierszu on wystñpiä (8) oraz jaki byä stos wywoäaþ. Informacje
te pomagajñ odnaleĒè ewentualne bäödy w aplikacji.
Zdarzajñ siö równieĔ sytuacje, Ĕe aplikacja nie dziaäa prawidäowo,
ale nie zgäasza Ĕadnych bäödów. W takich przypadkach warto
przechwyciè informacje o stanie dziaäajñcej aplikacji.
Adobe AIR zawiera funkcjö, która umoĔliwia wysyäanie informacji
z aplikacji na standardowe wyjĈcie.
runtime.trace
Jak juĔ wspomnieliĈmy, Adobe AIR oferuje mechanizm do przesy-
äania äaþcuchów z JavaScriptu do wiersza poleceþ.
Funkcja
trace
wäaĈciwoĈci
runtime
przyjmuje äaþcuch, który jest
wypisywany na standardowym wyjĈciu ADL. Oto przykäad jej
uĔycia:
runtime.trace("To zostanie wys
Īane na standardowe wyjŁcie");
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 59
Przydaje siö to do Ĉledzenia stanu aplikacji bez przerywania dzia-
äania kodu.
Kiedy przekaĔemy do funkcji
trace()
obiekt inny niĔ äaþcuch,
zostanie wywoäana jego funkcja
toString()
. Obiekt
Object
Java-
Scriptu ma domyĈlnñ implementacjö
toString()
, ale niektóre klasy
(takie jak
Array
) implementujñ bardziej kontekstowe funkcje
toString()
.
Oto przykäad Ĉledzenia tablicy, która zawiera róĔne typy danych:
var a = ["a", 1, {foo:"bar"}];
runtime.trace(a);
Kod ten spowoduje wyĈwietlenie poniĔszych danych w wierszu
polecenia ADL:
a,1,[object Object]
OczywiĈcie, moĔna implementowaè wäasne metody
toString()
w niestandardowych klasach JavaScriptu albo przesäaniaè funkcje
toString()
istniejñcych klas, aby uzyskaè wyniki bardziej specy-
ficzne dla danej klasy.
Pakowanie i wdra
żanie aplikacji AIR
Wiemy juĔ, jak budowaè, testowaè i debugowaè aplikacjö AIR, wiöc
jesteĈmy gotowi do utworzenia pliku AIR, który umoĔliwi wdra-
Ĕanie i dystrybucjö aplikacji.
Co znajduje si
ý w pliku AIR?
Plik AIR to pakiet w formacie ZIP, który säuĔy do dystrybuowania
aplikacji AIR. Zawiera wszystkie pliki niezbödne do zainstalowania
i uruchomienia aplikacji AIR, a Ĉrodowisko Adobe AIR uĔywa go
do utworzenia i zainstalowania aplikacji w systemie uĔytkownika.
60
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
Plik AIR jest tworzony przez narzödzie ADT z pakietu AIR
SDK i uĔywany do rozpowszechniania aplikacji wĈród innych
uĔytkowników.
UWAGA
Instalacja pliku AIR wymaga, aby w systemie uĔytkownika byäo
juĔ zainstalowane Ĉrodowisko Adobe AIR.
Plik AIR zawiera przynajmniej dwa elementy: plik deskryptora
aplikacji oraz gäówny plik aplikacji. MoĔna jednak doäñczyè do niego
inne pliki, ikony, katalogi i zasoby, które zostanñ zainstalowane wraz
z aplikacjñ. Pliki te bödñ dostöpne dla uruchomionej aplikacji.
Potrzebny teĔ bödzie certyfikat do cyfrowego podpisania aplikacji.
Podpisywanie plików AIR
Adobe AIR wymaga, aby wszystkie aplikacje AIR byäy podpisane
cyfrowo. MoĔna to zrobiè na dwa sposoby.
Podpisywanie za pomoc
é samodzielnie podpisanego certyfikatu
ProgramiĈci mogñ uĔyè ADT, aby cyfrowo podpisaè plik AIR za
pomocñ samodzielnie podpisanego certyfikatu. W tym celu naleĔy
wygenerowaè samodzielnie podpisany certyfikat, a nastöpnie wy-
korzystaè go do podpisania pliku AIR. Samodzielnie podpisane pliki
AIR nie zapewniajñ bezpieczeþstwa i nie pozwalajñ sprawdziè, czy
autor pliku rzeczywiĈcie jest tym, za kogo siö podaje. Podczas in-
stalowania aplikacji Ĉrodowisko Adobe AIR ostrzeĔe uĔytkownika,
Ĕe wydawca aplikacji nie moĔe byè zweryfikowany.
UWAGA
Nie moĔna zmieniè typu certyfikatu podczas aktualizowania
aplikacji.
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 61
Pliki AIR podpisane za pomocñ samodzielnie podpisanych certyfi-
katów przydajñ siö gäównie podczas tworzenia aplikacji. JeĈli apli-
kacja ma byè rozpowszechniana publicznie, trzeba podpisaè jñ za
pomocñ certyfikatu wystawionego przez zaufany i dobrze znany
urzñd certyfikacji (CA).
Podpisywanie za pomoc
é certyfikatu wystawionego przez CA
ADT obsäuguje równieĔ podpisywanie aplikacji za pomocñ certy-
fikatu wystawionego przez zaufany urzñd CA. Dziöki temu Ĉro-
dowisko Adobe AIR moĔe zweryfikowaè wydawcö aplikacji i po-
informowaè o tym uĔytkownika w oknie instalacyjnym.
UWAGA
Wiöcej informacji o podpisywaniu certyfikatów AIR, w tym listö
urzödów CA wystawiajñcych certyfikaty zgodne z Adobe AIR,
moĔna znaleĒè pod adresem: http://www.adobe.com/go/learn_
´
air_html.
Oba typy certyfikatów — podpisane samodzielnie i wystawione
przez CA — pozwalajñ Ĉrodowisku Adobe AIR sprawdziè, czy
plik AIR nie zostaä przez kogoĈ zmodyfikowany.
PoniewaĔ nie bödziemy rozpowszechniaè tworzonej wäaĈnie apli-
kacji, podpiszemy nasz plik AIR za pomocñ samodzielnie pod-
pisanego certyfikatu.
Tworzenie pliku AIR za pomoc
é ADT
Tworzenie samodzielnie podpisanego pliku AIR skäada siö z dwóch
etapów:
1. NaleĔy uĔyè ADT do utworzenia samodzielnie podpisanego
certyfikatu.
62
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
2. Korzystajñc z ADT, naleĔy utworzyè plik AIR podpisany za
pomocñ samodzielnie podpisanego certyfikatu.
Generowanie samodzielnie podpisanego certyfikatu
Przed podpisaniem pliku AIR za pomocñ samodzielnie podpisanego
certyfikatu musimy wygenerowaè certyfikat.
Aby wygenerowaè samodzielnie podpisany certyfikat za pomocñ
ADT, naleĔy uĔyè nastöpujñcych opcji wiersza polecenia:
adt -certificate -cn NAZWA TYPKLUCZA NAZWAPLIKU HAS
ĩO
Opcje te sñ wyjaĈnione w tabeli 2.4.
Tabela 2.4. Opcje podpisywania w programie ADT
Opcja wiersza polecenia
Opis
NAZWA
Nazwa nowego certyfikatu.
TYPKLUCZA
Typ klucza u
żytego w certyfikacie,
1024-RSA
albo
2048-RSA
.
NAZWAPLIKU
Nazwa pliku, w którym zostanie zapisany certyfikat.
HAS
ĩO
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.
Rozdzia
ĥ 2. Pierwsze kroki w Adobe AIR _ 63
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 DO
ĩíCZANEPLIKI
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
.
64
_ Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy
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:
x pakiet SDK jest skonfigurowany prawidäowo, a narzödzie
ADT znajduje siö na ĈcieĔce systemowej;
x polecenie ADT zostaäo wydane w katalogu, w którym znaj-
duje siö plik AIRHelloWorld.xml;
x plik deskryptora aplikacji zawiera poprawny skäadniowo
kod XML;
x informacje w pliku deskryptora aplikacji sñ prawidäowe
(szczególnñ uwagö naleĔy zwróciè na atrybuty
application
i element
content
);
x pliki AIRHelloWorld.html, test_cert.p12 oraz AIRHelloWorld.xml
znajdujñ siö w tym samym katalogu;