background image

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.

background image

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

background image

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

background image

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.

background image

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.

background image

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

ë

background image

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.

background image

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.

background image

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.

background image

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 binlib i runtime z pakietu SDK.

NaleĔy  zachowaè  wzglödne  poäoĔenie  ĈcieĔek  do  ka-
talogów binlib 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.

background image

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.

background image

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

background image

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 binlib 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

background image

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> )?

background image

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 binlib 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.

background image

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>

background image

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>

background image

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).

background image

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.

background image

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.

background image

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

}

background image

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).

background image

56

Adobe AIR dla programistów JavaScript. Leksykon kieszonkowy

 

2. PrzejĈè do katalogu, który zawiera pliki AIRHelloWorld.html

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

);

background image

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>

background image

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");

background image

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.

background image

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.

background image

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.

background image

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

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.

background image

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

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

.

background image

Czytaj dalej...

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.htmltest_cert.p12 oraz AIRHelloWorld.xml

znajdujñ siö w tym samym katalogu;