informatyka adobe air dla programistow javascript leksykon kieszonkowy mike chambers ebook

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

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

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

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

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

);

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

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.

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

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

.

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.html, test_cert.p12 oraz AIRHelloWorld.xml

znajdujñ siö w tym samym katalogu;


Wyszukiwarka

Podobne podstrony:
Adobe AIR dla programistow JavaScript Leksykon kieszonkowy airlek
informatyka vba dla excela 2010 leksykon kieszonkowy miroslaw lewandowski ebook
informatyka php5 bezpieczne programowanie leksykon kieszonkowy jacek ross ebook
VBA dla Excela 2010 Leksykon kieszonkowy vbe1lk
informatyka windows 7 komendy i polecenia leksykon kieszonkowy witold wrotek ebook
VBA dla Excela 2010 Leksykon kieszonkowy 2
VBA dla Excela 2010 Leksykon kieszonkowy vbe1lk
VBA dla Excela 2010 Leksykon kieszonkowy
informatyka jquery leksykon kieszonkowy david flanagan ebook
informatyka asembler leksykon kieszonkowy dawid farbaniec ebook
informatyka java ee 6 leksykon kieszonkowy arun gupta ebook
informatyka mac os x leopard pl leksykon kieszonkowy chuck toporek ebook

więcej podobnych podstron