În acest capitol vor fi puse bazele pentru a putea începe dezvoltarea aplicaţiilor Adobe AIR cu ajutorul Flex Builder sau cu SDK-ul Flex. Capitolul cuprinde:

• Instalarea Adobe AIR
• Configurarea Kitului de Dezvoltare Flex (Flex SDK) şi utilitarelor linie de comandă
• Crearea primei Dvs. aplicaţii AIR cu ajutorul Flex SDK şi Flex Builder 3
• Testarea aplicaţiilor AIR
• Semnarea, înpachetarea şi publicarea aplicaţiilor AIR

După ce veţi termina de citit acest capitol, veţi putea configura mediul de dezvoltare pentru aplicaţii AIR şi veţi avea o bază solidă pentru a începe dezvoltarea, testarea şi publicarea aplicaţiilor AIR.

De ce am nevoie pentru a putea dezvolta aplicaţii AIR?

Aveţi nevoie de o serie de instrumente şi utilitare pentru a putea începe dezvoltarea aplicaţiilor AIR.

Runtime-ul Adobe AIR

Runtime-ul Adobe AIR este necesar pentru a testa iconiţele aplicaţiilor şi pentru a instala aplicaţii AIR. Îl puteţi descărca gratuit de aici: http://www.adobe.com/go/getair.

Totuşi, nu este o precondiţie necesară pentru dezvoltarea aplicaţiilor AIR.

Kitul de Dezvoltare Adobe Flex (Flex SDK)

SDK-ul Flex, gratuit şi cu cod deschis, conţine un set de instrumente, biblioteci şi alte fişiere necesare dezvoltării, testării, compilării şi publicării aplicaţiilor AIR (sau pentru browser) pe bază de Flex. Conţine în special utilitare de linie de comandă ce permit dezvoltarea, testarea şi publicarea aplicaţiilor AIR din linia de comandă, ceea ce permite dezvoltarea în oricare editor text sau IDE (mediu integrat de dezvoltare).

SDK-ul Flex 3 conţine suport pentru AIR 1.0 însă nu şi pentru AIR 1.1. Pentru dezvoltarea în AIR 1.1 trebuie să folosiţi versiunea 3.0.2 a SDK-ului Flex.

O puteţi descărca de aici: http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+3

Lansarea SDK-ului Flex versiunea 3.1 este planificată pentru mijlocul lunii august 2008 şi va conţine suport complet pentru AIR 1.1.

Această carte presupune că veţi folosi versiunea 3.0.2 a SDK-ului Flex.

Kitul de Dezvoltare Adobe AIR

Kitul de dezvoltare Adobe AIR SDK este folosit pentru dezvoltarea aplicaţiilor AIR pe bază de HTML şi JavaScript, şi conţine utilitare de linie de comandă, exemple şi alte resurse. În general, SDK-ul Flex conţine toate fişierele din SDK-ul AIR, însă sunt două cazuri când aţi putea dori să le descărcaţi pe ambele:

1. SDK-ul AIR conţine fişiere şi biblioteci pentru dezvoltare folosind HTML şi JavaScript. Dacă aplicaţia Dvs. pe bază de Flex conţine şi resurse HTML, atunci probabil veţi dori să descărcaţi şi SDK-ul AIR.

   Pe parcursul acestei cărţi vom folosi fişiere din SDK-ul AIR.

2. Dacă SDK-ul AIR este adus la zi separat de SDK-ul Flex, atunci puteţi descărca SDK-ul AIR şi să aduceţi la zi de sine-stătător copiind fişierele din SKD-ul AIR în SDK-ul Flex.

   La momentul scrierii acestei cărţi acest pas nu este necesar.

Puteţi descărca SDK-ul AIR gratuit de aici: http://www.adobe.com/go/getairsdk.

Flex Builder 3 sau un alt IDE Flash sau text

Dacă veţi folosi SDK-ul Flex pentru a dezvolta aplicaţii AIR pe bază de Flex, atunci tot de ce aveţi nevoie este un editor de texte pentru a crea fişierele Dvs. MXML şi ActionScript. Puteţi dezvolta fişierele sursă în oricare editor text (cum ar notepad sau VIM) şi ulterior puteţi folosi SDK-ul flex pentru a compila, testa şi împacheta aplicaţiile Dvs. Flex.

Totuşi dacă planificaţi să efectuaţi o dezvoltare extensivă în Flex sau doriţi o experienţă mai bogată de dezvoltare, ar fi recomandat să utilizaţi un IDE special creat pentru dezvoltarea aplicaţiilor Flex/Flash.

Adobe Flex Builder 3 este un IDE cu funcţionalităţi extinse, pe bază de IDE Eclipse, ce conţine atât suport pentru crearea aplicaţiilor pentru browser, cât şi pentru crearea aplicaţiilor AIR pe bază de Flex. Flex Builder oferă un set de funcţionalităţi ce uşurează şi fac mai plăcută dezvoltarea. Astfel de funcţionalităţi sunt:

• Generarea proiectelor şi fişierelor şablon ale aplicaţiei.
• Dezvoltarea interfeţei grafice folosind Vederea Design.
• Editor de texte cu funcţionalităţi extinse, cu intrespecţie şi auto-completare.
• Lansare, depanare şi profilarea aplicaţiilor direct din IDE.
• Împachetarea fişierului distributiv al aplicaţiei AIR.
• Extinderea IDE-ului cu ajutorul pluginurilor pentru Eclipse.

În continuare vă vom expune modalităţile de a dezvolta aplicaţii AIR atât doar folosind SKD-ul, cât şi cu ajutorul Flex Builder.

Flex Builder este disponibil atât ca IDE de sine-stătător cât şi ca plugin pentru Eclipse. Puteţi descărca o versiune gratuită de încercare de aici: http://www.adobe.com/go/flex_trial

Sisteme de Operare Susţinute

Deşi e posibilă dezvoltarea şi împachetarea aplicaţiilor AIR de pe practic oricare platformă (inclusiv Linux) folosind SKD-ul Flex, totuşi testarea şi publicarea aplicaţiilor AIR e posibilă pe sistemele de operare susţinute de Adobe AIR.

Adobe AIR 1.1 e susţinut de următoarele sisteme de operare:

• Microsoft Windows XP SP2
• Microsoft Windows XP Ediţia Tablet PC
• Microsoft Windows Vist Home, Premium, Business, Ultimate şi Enterprise (inclusiv ediţiile pe 64 de biţi)
• Microsoft Windows 2000 SP4
• Windows 2003 Server
• Mac OS 10.4.11 (Intel şi PowerPC)
• Mac OS 10.5.2 (Intel şi PowerPC)

Instalarea Adobe AIR

Deşi prezenţa runtime-ului AIR instalat nu este necesară, totuşi e utilă pentru a rula alte aplicaţii şi pentru a testa pachetul final de publicare a aplicaţiilor.

Instalarea runtime-ului este foarte simplă şi necesită descărcarea şi rularea Instalatorului Adobe AIR.

1. Descărcaţi instalatorul Adobe AIR de aici: http://www.adobe.com/go/getair.
2. Lansaţi instalatorul. Pe sisteme Mac trebuie mai întâi să montaţi fişierul *.dmg care conţine instalatorul.
3. Urmaţi instrucţiunile de instalare.

Cel mai uşor mod de a verifica dacă aţi instalat corect runtime-ul AIR este să încercaţi să instalaţi o aplicaţie AIR. Puteţi face acest lucru fie descărcând o aplicaţie AIR, fie urmând instrucţiunile din acest capitol pentru crearea unei aplicaţii AIR simple.

Dezinstalarea Adobe AIR

Procesul dezinstalării Adobe AIR diferă în funcţie de sistemul Dvs. de operare.

Dezinstalarea în Windows

Puteţi dezinstala Adobe AIR la fel cum dezinstalaţi oricare altă aplicaţie în Windows. Alegeţi Adobe AIR în secţiunea Add/Remove Programs în Panoul de Control (Control Panel).

Dezinstalarea pe sistemele Mac

Instalatorul adaugă o aplicaţie de dezinstalare la momentul instalării. Pentru a dezinstala Adobe AIR lansaţi dezinstalatorul numit Adobe AIR Uninstaller. Acesta poate fi găsit în dosarul /Applications/Utilities.

Configurarea SDK-ului Flex şi a utilitarelor linie de comandă

SDK-ul Flex conţine instrumente, exemple şi cod sursă ce permit dezvoltarea, testarea şi publicarea aplicaţiilor din linia de comandă (deci din oricare editor text sau IDE). Menţionăm utilitarele linie de comandă pe care le vom utiliza (enumerate în tabelul 2-1):

Tabelul 2-1 Utilitare Linie de Comandă folosite pentru dezvoltarea aplicaţiilor AIR

Utilitar	Descriere
ADL	Lansează aplicaţii AIR fără necesitatea instalării acestora.
ADT	Semnează şi împachetează aplicaţii AIR în fişiere distributive *.air.
AMXMLC	Un wrapper (înveliş) pentru compilatorul linie de comandă al Flexului, care leagă biblioteci ActionScript pentru dezvoltarea aplicaţiilor AIR.

Instalarea SDK-ului Adobe Flex 3

După cum am menţionat mai devreme, SDK-ul Adobe Flex 3 conţine un set de utilitare linie de comandă necesare pentru dezvoltarea, testarea şi împachetarea aplicaţiilor AIR pe bază de Flex, direct din linia de comandă.

Pentru a permite executarea ulitarelor din orice locaţie vom instala SDK-ul în calea sistemului de operare (system path).

Instalarea SDK-ului

Utilitarele linie de comandă se găsesc în dosarul bin din SDK.

1. Descărcaţi SDK-ului Adobe Flex 3 de aici: http://www.adobe.com/go/flex3_sdk.
2. SDK-ul este un fişier ZIP. Decompresaţi-l.
3. Copiaţi conţinutul SDK-ului într-o locaţie permanentă în sistemul Dvs. (ne vom referi la această locaţie astfel: *<SDK_Path>*).
4. La momentul dat, SDK-ul trebui să conţină următoarele dosare: *<SDK_Path>/bin, <SDK_Path>/frameworks, <SDK_Path>/lib şi <SDK_Path>/runtimes*, etc... Utilitarele linie de comandă - ADL, ADT şi AMXMLC se găsesc în dosarul bin.

Adăugarea Utilitarelor Linie-de-Comandă în Calea Sistemului de Operare

Tot ce vă rămâne să faceţi este să adăugaţi calea spre dosarul *<SDK_Path>/bin* în variabila PATH a sistemului de operare pentru a putea rula utilitarele linie-de-comandă de oriunde din sistem.

Instrucţiunile diferă în dependenţă de sistemul de operare pe care-l rulaţi.

Windows

Dacă rulaţi un sistem Windows îndepliniţi următorii paşi:

1. Deschideţi fereastra de dialog System Properties şi alegeţi tabul Advanced. Puteţi găsi acest dialog sub numele System în Panoul de Control. Pe sistemul Vista: Control Panel > System > Advanced Settings.

2. Apăsaţi butonul Environment Variables....

3. În secţiunea variabilelor de sistem (System Variables), alegeţi entitatea PATH şi apăsaţi butonul *Edit. Adăugaţi calea spre dosarul <SDK_Path>/bin* la sfârşitul valorii variabilei, separând-o de valorile precedente cu un „punct-virgulă”:

   ; <SDK_Path>\bin
   

   De exemplu dacă aţi instalat SDK-ul în dosarul *c:flexsdk\*, veţi introduce:

   ; c:\flexsdk\bin\
   

4. Apăsaţi butonul OK pentru a închide panourile.

   [IMAGE] Figura 2-1. Adăugarea utilitarelor linie-de-comandă în calea sistemului de operare în Windows

5. Pentru a testa succesul operaţiunii deschideţi o consolă Windows (Start > Run > Console) şi introduceţi următoarea comandă:

   adt.

   În rezultat trebuie să primiţi ceva similar următoarelor:

   No arguments were found
   usage:
     adt -checkstore SIGNING_OPTIONS
     adt -certificate -cn <name> ( -ou <org-unit> )? ( -o <org-name> )? ( -c <country> )? <key-type> <pfx-file> <password>
     adt -help
     adt -migrate SIGNING_OTIONS <air-file-in> <air-file-out>
     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 -version
   
   SIGNING_OPTIONS: -storetype <type> ( -keystore <store> )? ( -storepass <pass> )? ( -keypass <pass> )? ( -providerName <name> )? ( -tsa <url> )?
   FILE_ARGS: <fileOrDir>* (( -C <dir> <fileOrDir>+ ) | ( -e <file> <path> ))*
   

   Acum aveţi toate instrumentele necesare configurate corect.

Verificaţi următoarele lucruri dacă aţi eşuat în configurarea căilor:

• Asiguraţi-vă că aţi copiat conţinutul dosarelor din SDK, menţinând căile relative între ele.
• Asiguraţi-vă că aţi inclus corect în variabila de mediu PATH - calea spre dosarul *<SDK_Path>*.
• Asiguraţi-vă că aţi deschis o fereastră nouă de consolă înainte de rularea comenzii.

Mac şi Linux

Există o serie de posibilităţi de adăugare a călii SDK-ului AIR în variabila PATH, în funcţie de shell-ul utilizat şi de modul în care specificaţi variabilele de mediu.

Următoarele instrucţiuni demonstrează cum poate fi modificată variabila de mediu PATH dacă folisiţi shell-ul „bash”:

1. Deschideţi Terminalul (pe Mac OS X poate fi găsit aici: /Applications/Utilities/Terminal).

2. Asiguraţi-vă că sunteţi în dosarul „home” introducând cd şi confirmând cu Enter.

3. Verificaţi dacă unu din cele două fişiere este prezent. Introcueţi comanda:

   ls -la.

4. Căutaţi un fişier numit .profile sau .bashrc.

5. Dacă nu-l aveţi pe niciunul din ele, creaţi fişierul .profile cu ajutorul comenzii:

   touch .profile.

6. Deschideţi fişierul .profile sau .bashrc cu un editor de texte.

7. Căutaţi o linie similară următoareia:

   export PATH=$PATH:/usr/local/bin
   

8. Adăugaţi calea spre dosarul *`/bin* la sfârşitul linii. De exemplu dacă */bin'* se află la adresa /airsdk/bin, atunci calea exportată trebui să arate în felul următor:

   export PATH=$PATH:/usr/local/bin:/airsdk/bin
   

   Asiguraţi-vă că intrările sunt separate cu „:”.

9. Dacă fişierul este gol adăugaţi următoarul text:

   export PATH=$PATH:/airsdk/bin
   

10. Salvaţi şi închideţi fişierul.

11. Rulaţi comanda source .profile pentru a încărca setările noi (sau .bashrc dacă acela este fişierul editat).

12. Pentru a testa dacă instalarea a fost realizată cu succes deschideţi fereastra Terminal şi introduceţi:

    adt.

    Trebuie să primiţi ceva similar următoarelor:

    No arguments were found
    usage:
      adt -checkstore SIGNING_OPTIONS
      adt -certificate -cn <name> ( -ou <org-unit> )? ( -o <org-name> )? ( -c <country> )? <key-type> <pfx-file> <password>
      adt -help
      adt -migrate SIGNING_OTIONS <air-file-in> <air-file-out>
      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 -version
    
    SIGNING_OPTIONS: -storetype <type> ( -keystore <store> )? ( -storepass <pass> )? ( -keypass <pass> )? ( -providerName <name> )? ( -tsa <url> )?
    FILE_ARGS: <fileOrDir>* (( -C <dir> <fileOrDir>+ ) | ( -e <file> <path> ))*
    

Aceasta înseamnă că aveţi toate instrumentele necesare configurate corect.

If you get an error check the following:

• Asiguraţi-vă că aţi copiat conţinutul dosarelor din SDK, menţinând căile relative între ele.
• Asiguraţi-vă că aţi inclus corect în variabila de mediu PATH - calea spre dosarul *<SDK_Path>*.
• Asiguraţi-vă că fie aţi deschis o fereastră nouă de Terminal, fie aţi executat source pe fişierul de configurare.

Verificarea versiunii Adobe AIR

După ce aţi instalat şi configurat SDK-ul Flex, puteţi verifica şi confirma versiunea runtime-ului Adobe AIR inclus în SDK cu următoarea comandă:

adt -version

Dacă SDK-ul conţine o versiune AIR 1.1 sau superioară, rezultatul trebuie să fie ceva similar următoruia:

adt version "1.1.0.5780"

Dacă SDK-ul conţine o versiune AIR mai veche de 1.1, argumentul -version nu este susţinut şi veţi primi un rezultat:

unexpected argument -version

Construirea unei aplicaţii AIR

Procesul dezvoltării unei aplicaţii AIR pe bază de Flex poate fi separat în patru etape primare:

1. Crearea fişierului descriptiv al aplicaţiei.
2. Designul şi dezvoltarea aplicaţiei.
3. Testarea şi depanarea aplicaţiei.
4. Semnarea şi crearea distributivului AIR.

Fişierul descriptiv al aplicaţiei AIR

Fişierul descriptiv al aplicaţiei este un fişier XML necesar tuturor aplicaţiilor AIR. El conţine meta-date despre aplicaţie (nume, descriere etc.) şi informaţii despre modul de lansare şi afişare a aplicaţiei.

Dacă folosiţi Flex Builder, acesta va genera un fişier descriptiv complet documentat. SDK-ul Flex conţine şi el un fişier şablon documentat complet, ce poate fi găsit în SDK aici: *''air/templates/descriptor-template.xml*.

Ambele exemple de mai jos vor folosi următorul fişier descriptiv:

<?xml version="1.0" encoding="utf-8" ?>
<application xmlns="http://ns.adobe.com/air/application/1.1">

    <id>com.oreilly.SalutLume</id>
    <filename>SalutLume</filename>
    <name>Salut Lume</name>
    <version>.85</version>

    <initialWindow>
        <content>SalutLume.swf</content>
        <systemChrome>standard</systemChrome>
        <transparent>false</transparent>
        <visible>true</visible>
    </initialWindow>

</application>

Pentru a afla mai multe informaţii despre opţiunile fişierului descriptiv consultaţi documentaţia Adobe AIR sau documentul generat de Flex Builder.

Tabelul 2-2 enumeră toate elementele de nivel superior şi valorile lor respective:

Tabelul 2-2 Elementele fişierului descriptiv a aplicaţiei „Salut Lume”

Element	Descriere
id	Elementul id reprezintă un text (eng. string) destinat calculatorului (utilizatorul nu are acces direct la el) folosit ca identificator unic al aplicaţiei cu autorul acesteia (determinat de certificatul cu care a fost semnată aplicaţia). Este recomandabil să folosiţi o notaţie revers-domeniu similară celei din package-urile ActionScript.
filename	Numele nativ al fişierului executabil ce va fi creat după ce aplicaţia va fi instalată.
name	Numele aplicaţiei aşa cum îl vor putea citi utilizatorii finali.
version	Un text accesibil runtime-ului la lansare ce poate fi folosit pentru a afla versiunea aplicaţiei.

Elementul intialWindow conţine elemente suplimentare ce descriu modul de construcţie a ferestrei la lansarea aplicaţiei. Tabelul 2-3 enumeră elementele şi valorile acceptate de acestea.

Tabelul 2-3 Sub-elementele elementul „initialWindow”

Element	Descriere
content	Specifică fişierul-conţinut de rădăcină a aplicaţiei. În general acesta este fişierul principal al aplicaţiei.
systemChrome	Specifică modul de afişare a ferestrelor şi anume dacă aplicaţia va folosi sau nu cromul sistemului de operare (marginea ferestrei, taskbarul)
transparent	Dacă valoarea elementului systemChrome e „false”, acest element specifică runtime-ul va afişa fonul aplicaţiei. Acesta permite crearea aplicaţiilor cu forme nestandarte.
visible	Specifică vizibilitatea aplicaţiei la startare. Valoarea implicită e „false”, ceea ce înseamnă că aplicaţia nu va fi vizibilă. Acest lucru este util dacă e necesară preintiţializarea aplicaţiei înainte de afişarea UI-ului.

Fişierele AIR

Un fişier *.air reprezintă un distributiv arhivat într-un pachet ZIP folosit pentru distribuirea apicaţiilor AIR. Acesta conţine toate fişierele necesare instalării şi rulării unei aplicaţii AIR şi Adobe AIR îl foloseşte pentru a crea şi instala aplicaţia AIR în sistemul utilizatorului.

Dacă folosiţi SDK-ul Flex sau AIR, fişierele AIR sunt create de utilitarul ADT inclus în SDK-uri.

Un fişier AIR necesită minimum două fişiere: fişierul descriptiv al aplicaţiei şi fişierul rădăcină al aplicaţiei. Puteţi include şi alte fişiere, iconiţe, dosare şi resurse ce vor fi adăugate în fişierul AIR şi vor fi instalate împreună cu aplicaţia. Ulterior, la rulare, aceste fişiere vor fi accesibile runtime-ului.

Veţi avea nevoie şi de un certificat pentru a vă semna aplicaţia.

Semnarea digitală a fişierelor AIR

Toate fişierele AIR trebuie să fie semnate digital şi sunt două moduri de a o face.

Semnarea digitală asigură un nivel de securitate:

• Asigură că fişierul nu a fost alterat în perioada dintre creare şi instalare.
• Dacă fişierul AIR este semnat folosind un certificat dintr-o sursă credibilă (de exemplu Certificate Authority), atunci Adobe AIR poate verifica autorul fişierul AIR.

ADT oferă două modalităţi de a semna fişierele AIR. Puteţi să le auto-semnaţi cu un certificat propriu ce oferă un nivel minim de securitate sau puteţi să-l semnaţi cu un certificat digital emis de o autoriate de încredere, ceea ce oferă un nivel mai ridicat de securitate.

Auto-semnarea cu un certificat propriu

Programatorii pot folosi ADT pentru a auto-semna un fişier AIR cu un certificat propriu. Auto-semnarea se face prin generarea unui certificat auto-semnat şi semnarea fişierului AIR cu acesta. Deşi auto-semnarea fişierelor oferă posibilitatea depistării alterărilor aplicaţiei, aceasta nu oferă posibilitatea verificării identităţii autorului. La instalarea unei atare aplicaţii, runtime-ul vă va preveni că autorul aplicaţiei nu poate fi verificat.

Fişierele auto-semnate sunt destinate în primă instanţă pentru dezvoltare şi testare. Dacă planificaţi să distribuiţi aplicaţia, se recomandă semnarea acesteia cu un certificat emis de o autoritate respectată bine-cunoscută şi de încredere (Certification authority, CA).

Semnarea cu un certificat emis de o Autoritate de Certificare

ADT oferă posibilitatea semnării aplicaţiilor cu certificate verificate emise de Autorităţi de Certificare, ceea ce permite ulterior verificarea autorilor aplicaţiei, cu reflectarea informaţiei corespunzătoare în ecranul de instalare.

Construirea unei aplicaţii AIR „Hello World”

Secţiunea vă va ghida prin câţiva paşi necesari pentru crearea unei aplicaţii simple de tip Hello World. Îndeplinirea acestor paşi vă va ajuta să verificaţi corectitudinea funcţionării mediului de dezvoltare AIR.

După crearea acestei simple aplicaţii veţi fi familiarizat cu:

• Scrierea codului de bază MXML pentru o aplicaţie AIR
• Testarea şi depanarea aplicaţiei
• Împachetarea aplicaţiei într-un fişier distributiv AIR ce poate fi publicat pentru a fi instalat pe alte calculatoare

Paşii ce trebuie urmaţi pentru scrierea şi depanarea aplicaţiei diferă în funcţie de ce folosiţi pentru dezvoltare - Flex Builder sau SDK-ul Flex. În continuare vom analiza ambele scenarii.

Construirea Aplicaţiei AIR cu Ajutorul SDK-ului Flex

După cum am menţionat anterior SDK-ul conţine toate instrumentele necesare pentru construirea, testarea şi publicarea aplicaţiilor AIR pe bază de Flex direct din linia de comandă. Acest lucru înseamnă (printre altele) că puteţi crea aplicaţii AIR din practiv oricare editor sau IDE ce poate edita fişiere text.

Secţiuea expune procedura pentru crearea unei aplicaţii AIR pe bază de Flex cu ajutorul Flex SDK. Secţiunea următoarea, analogic, descrie crearea unei aplicaţii din Flex Builder.

Înainte de a începe, convingeţi-vă că aţi urmat întocmai instrucţiunile de instalare a SDK-ului şi că aţi confirmat instalarea acestuia cu succes în sistemul Dvs.

1. Creaţi un dosar nou în sistemul Dvs. de fişiere. Acesta va conţine toate fişierele sursă ale proiectului. Ne vom referi la acest dosar ca „dosarul proiectului”.

2. Copiaţi fişierul descriptiv şablon din SDK (*''air/templates/descriptor-template.xml*) în dosarul proiectului şi redenumiţi-l în application.xml.

3. Nu e necesară configurarea tuturor elementelor din fişierul descriptiv, deci putem să le ignorăm pe acelea de care nu avem nevoie acum. Deschideţi fişierul application.xml şi editaţi-l în aşa fel încât să conţină următoarele valori (puteţi înlocui întregul şablon cu următorul exemplu):

   <?xml version="1.0" encoding="utf-8" ?>
   <application xmlns="http://ns.adobe.com/air/application/1.1">
       <id>com.oreilly.SalutLume</id>
       <filename>SalutLume</filename>
       <name>Salut Lume</name>
       <version>.85</version>
       <initialWindow>
           <content>SalutLume.swf</content>
           <systemChrome>standard</systemChrome>
           <transparent>false</transparent>
           <visible>true</visible>
       </initialWindow>
   </application>
   

4. Salvaţi schimbările din acest fişier.

În acest moment suntem gata să începem a scrie codul propriu-zis al aplicaţiei noastre.

1. Creaţi un nou fişier în dosarul proiectului, numiţi-l SalutLume.mxml şi deschideţi-l într-un editor text.

2. Introduceţi următorul cod în acest fişier:

   <?xml version="1.0" encoding="utf-8"?>
   <mx:WindowedApplication 
       xmlns:mx="http://www.adobe.com/2006/mxml" 
       layout="absolute">
       <mx:Label text="Salut Lume" horizontalCenter="0" verticalCenter="0"/>
   </mx:WindowedApplication>
   

   Acesta defineşte codul sursă MXML pentru aplicaţie:

   • Componenta WindowedApplication e o subclasă a componentei Flex Application, reprezintă o aplicaţie ce rulează într-o fereastră nativă a desktopului şi oferă evenimente şi API-uri suplimentare pentru interacţiunea cu aceastră fereastră.
   • Componenta Label e folosită pentru a afişa textul „Salut Lume”.

3. Salvaţi fişierul.

Acum suntem gata să compilăm fişierele sursă pentru a obţine un fişier SWF. Vom face acest lucru folosind comanda amxmlc inclusă în SDK-ul Flex. Comanda e un wrapper a compilatorului mxmlc (de asemenea prezent în SDK) care leagă bibliotecile Flex cu clasele şi componentele Adobe AIR.

1. Deschideţi aplicaţia de Terminal pe Mac sau Linux, sau o Consolă de comandă în Windows.

2. Navigaţi spre dosarul proiectului.

3. Rulaţi următoarea comandă:

   amxmlc SalutLume.mxml

4. Trebuie să vedeţi în fereastră un rezultat similar următorului text:

   Loading configuration file /Users/mesh/bin/flex/frameworks/air-config.xml
   /Users/mesh//SalutLume_sdk/SalutLume.swf (249753 bytes)
   

   Acest lucru indică faptul că aplicaţia a fost compilată cu succes. Dacă aveţi erori, corectaţi-le în codul sursă şi compilaţi din nou aplicaţia.

Acum avem trei fişiere în dosarul proiectului: SalutLume.mxml, SalutLume.swf şi application.xml. SalutLume.swf şi application.xml constituie în sine aplicaţia AIR şi sunt gata de a fi rulate şi testate.

Acum putem testa aplicaţia folosind utilitarul ADL inclus în SDK:

1. Deschideţi aplicaţia de Terminal pe Mac sau Linux, sau o Consolă de comandă în Windows.

2. Asiguraţi-vă că sunteţi în dosarul proiectului.

3. Executaţi următoarea comandă:

   adl application.xml

4. Se va lansa aplicaţia într-o fereastră nativă a sistemului de operare.

   [IMAGE] Figura 2-3 Aplicaţia „Salut Lume”

Dacă aveţi erori, asiguraţi-vă că fişierul application.xml conţine informaţia necesară şi executaţi din nou.

Capturarea rezultatelor de ieşire în timpul rulării

La rularea aplicaţiilor în linia de comandă cu ajuoturl ADL, toate erorile de rulare precum şi date din ActionScript trimise prin metoda trace vor fi afişate în consola în care a fost lansată aplicaţia.

Să modificăm aplicaţia în aşa fel încât ea să trimită un text liniei de comandă la lansarea aplicaţiei. Modificaţi codul sursă al SalutLume.mxml în modul următor:

<?xml version="1.0" encoding="utf-8"?>
<mx:WindowedApplication 
    xmlns:mx="http://www.adobe.com/2006/mxml" 
    layout="absolute"
    creationComplete="onCreationComplete()"
    >

    <mx:Script>
        <![CDATA[
            private function onCreationComplete():void
            {
                trace("Interfaţa Aplicaţiei a fost Creată");
            }
        ]] >
    </mx:Script>

    <mx:Label text="Salut Lume" horizontalCenter="0" verticalCenter="0"/>

</mx:WindowedApplication>

Am înregistrat un listener pentru evenimentul difuzat de componenta WindowedApplication. La momentul difuzării acestuia am apelat funcţia trace pentru a imiprima un text în consola liniei de comandă.

Salvaţi fişierul şi rulaţi cu ajutorul ADL:

adl application.xml

După lansarea aplicaţiei veţi vedea în consolă următorul text:

Interfaţa Aplicaţiei a fost Creată

Această funcţionalitate poate fi folosită pentru testarea aplicaţiei în timpul rulării acesteia.

Împachetarea şi Publicarea aplicaţiei AIR cu ajutorul ADT

Acum ştim cum să creăm şi să testăm o aplicaţie AIR cu ajutorul SDK-ului şi suntem gata să creăm fişierul AIR ce va permite publicarea şi distribuirea aplicaţiei.

Vom semna fişierul nostru AIR cu un certificat auto-semnat deoarece nu intenţionăm să redistribuim aplicaţia creată.

Crearea Fişierului AIR cu ajutorul ADT

Crearea unu fişier AIR auto-semnat presupune îndeplinirea următorilor paşi:

1. Executarea ADT pentru a crea un certificat auto-semnat.
2. Executarea ADT pentru a crea fişierul AIR (semnat digital cu certificatul creat în punctul 1).

Generarea un Certificat Auto-semnat

Înaintea semnării aplicaţiei AIR cu un certificat trebuie mai întâi să-l generăm.

Cu ajutorul următoarei comenzi putem crea un astfel de certificat:

adt -certificate -cn NUMECOMUN TIPCHEIE FISIER PAROLA

Tabelul 2-4 enumeră şi descrie opţiunile comenzii linie-de-comandă.

Tabelul 2-4. ADT - Opţiuni de Semnare

Opţiune Commandă	Descriere
NUMECOMUN	Numele comun asociat noului certificat.
TIPCHEIE	Tipul cheii folosit în certificat (1024-RSA sau 2048-RSA).
FISIER	Numele fişierului unde va fi salvat certificatul.
PAROLA	Codul de acces pentru a putea utiliza certificatul.

Pentru a genera un certificat auto-semna îndepliniţi următorii paşi:

1. Deschideţi Terminalul (Mac OS X / Linux) sau Consola (Windows).

2. Asiguraţi-vă că sunteţi în dosarul proiectului.

3. Executaţi următoarea comandă:

   adt -certificate -cn nume_oarecare 1024-RSA test_cert.p12 parola_mea

În acest exemplu am denumit certificatul „nume_oarecare” şi i-am pus codul de acces „parola_mea”.

Această comandă generează un certificat auto-semnat şi îl depozitează într-un fişier numit test_cert.p12.

Acum trebuie să aveţi în dosarul proiectului un fişier numit test_cert.p12, pe care-l puteţi folosi pentru a semna digital fişierele Dvs. AIR.

Generarea Fişierului AIR

Folosiţi instrumentul de linie de comandă ADT inclus în SDK pentru a crea fişiere AIR. Îl puteţi folosi în modul următor:

adt -package OPTIUNISEMNARE NUMEFISIERAIR FISEREDEINCLUS

Pentru a crea un fişier AIR semnat cu un certificat auto-semnat, îndepliniţi următoarele:

1. Deschideţi Terminalul (Mac OS X / Linux) sau Consola (Windows).

2. Asiguraţi-vă că sunteţi în dosarul proiectului.

3. Executaţi următoarea comandă:

   adt -package -storetype pkcs12 -keystore test_cert.p12 SalutLume.air application.xml SalutLume.swf

4. La executarea comenzii date va trebui să introduceţi codul de acces pentru certificatul cu care urmează să fie semnat fişierul AIR. Introduceţi parola certificatului (în cazul nostru: parola_mea) şi confirmaţi.

În dosarul proiectului trebuie să fie creat fişierul SalutLume.air. Dacă acesta nu a fost creat sau aţi primit careva erori, verificaţi următoare:

• Asiguraţi-vă că aţi configurat corect SDK-ul, şi că instrumentul ADT poate fi găsit în calea sistemului de operare.
• Asiguraţi-vă că executaţi comanda ADT în dosarul proiectului.
• Asiguraţi-vă că fişierul descriptiv al aplicaţiei este valid.
• Asiguraţi-vă că aveţi în dosarul proiectului fişierele SalutLume.swf, test_cert.p12, şi application.xml.
• Asiguraţi-vă că aţi introdus aceeaşi parolă ca şi la generarea certificatului.

La momentul dat aveţi un fişier AIR valid ce poate fi folosit pentru a instala aplicaţia Dvs.

Construirea Aplicaţiei AIR cu Adobe Flex Builder 3

Flex Builder 3 e un IDE cu funcţionalităţi extensive destinat dezvoltării în ActionScript şi Flex, şi include suport complet pentru dezvoltarea, testarea, depanarea şi împachetarea aplicaţiilor AIR.

Crearea aplicaţiilor AIR în Flex Builder este similară creării aplicaţiilor Flex pentru Web.

Dacă nu dispuneţi încă de Flex Builder, puteţi descărca o versiune de încercare complet funcţională de aici: http:///www.adobe.com/go/flex_trial/

1. Deschideţi Flex Builderul.
2. Alegeţi `File > New > Flex Project' (Fişier > Nou > Proiect Flex). Va apare fereastra de dialog "New Flex Project" (Proiect Nou Flex).
3. Introduceţi numele SalutLume în Project Name (Nume proiect). Alegeţi locaţia unde urmează a fi salvate fişierele Dvs. (puteţi folosi locaţia implicită alegând Use default location (Foloseşte locaţia implicită)). Asiguraţivă că opţiunea Application type (Tipul aplicaţiei) e setată cu valorea Desktop application (runs in Adobe AIR) (Aplicaţie Desktop (rulează în Adobe AIR)).
4. Apăsaţi Finish (Terminare). (Dacă apăsaţi Next (Următorul pas) puteţi configura şi alte setări ale proiectului, însă nu avem nevoie să le modificăm pentru acest exemplu).

Paşii precedenţi vor crea un proiect AIR denumit SalutLume. De asemenea, Flex va auto-genera două fişiere în sub-dosarul /src al proiectului Dvs.

Tabelul 2-3 Fişiere Auto-generate de Flex Builder pentru Proiectul AIR

Fişier	Descriere
SalutLume-app.xml	Fişierul descriptiv al aplicaţiei - conţine toate opţiunile posibile documentate complet.
SalutLume.mxml	Fişierul sursă - pentru conţinutul principal al aplicaţiei - reprezintă principalul fişier al proiectului.

În continuare vom modifica informaţiile din fişierul descriptiv folosind setările expuse în secţiunea de mai sus ”Fişierul Descriptiv al Aplicaţiei AIR”.

1. Deschideţi fişierul SalutLume-app.xml.

2. Puteţi înlocui întregul conţinut al fişierului cu documentul XML de mai jos sau puteţi introduce valorile în fişierul descriptiv existent:

   <?xml version="1.0" encoding="utf-8" ?>
   <application xmlns="http://ns.adobe.com/air/application/1.1">
       <id>com.oreilly.SalutLume</id>
       <filename>SalutLume</filename>
       <name>Salut Lume</name>
       <version>.85</version>
       <initialWindow>
           <content>SalutLume.swf</content>
           <systemChrome>standard</systemChrome>
           <transparent>false</transparent>
           <visible>true</visible>
       </initialWindow>
   </application>
   

   NOTĂ

   Asiguraţi-vă că tagul „application” conţine versiunea AIR 1.1. Trebuie să arate în modul următor:

   <application xmlns="http://ns.adobe.com/air/application/1.1">

   
   

   Dacă aţi optat pentru modificarea fişierului descriptiv auto-generat atunci acesta va conţine atât informaţia de mai sus cât şi toate elementele comentate (ascunse) pe care nu le vom utiliza.

3. Salvaţi fişierul File > Save (Fişier > Salvare).

Acum putem testa aplicaţia pentru a ne asigura că am creat un fişier descriptiv valid. Pentru a face acest lucru putem pur şi simplu să depanăm aplicaţia.

1. Alegeţi Run > Debug SalutLume (Rulare > Depanare SalutLume)

   Aplicaţia trebuie să se lanseze fără erori.

   Dacă aveţi erori asiguraţi-vă că aţi introdus corect în fişierul descriptiv toată informaţia şi că fişierul reprezintă un document XML valid. Odată ce aţi făcut acest lucru, testaţi din nou aplicaţia pentru a confirma corectitudinea fişierului.

După ce am creat fişierul descriptiv valid suntem gata să construim restul exemplului.

Proiectul AIR a fost configurat şi putem începe să introducem codul MXML pentru aplicaţia noastră:

1. 1. Deschideţi fişierul auto-generat SalutLume.mxml. Acesta trebuie să arate similar următorului cod:

      <?xml version="1.0" encoding="utf-8"?>

2. Adăugaţi o componentă de tip „label” (etichetă):

       <?xml version="1.0" encoding="utf-8"?>
       <mx:WindowedApplication 
           xmlns:mx="http://www.adobe.com/2006/mxml" 
           layout="absolute">
           <mx:Label text="Salut Lume" horizontalCenter="0" verticalCenter="0"/>
       </mx:WindowedApplication>
   

   Acesta defineşte codul sursă MXML pentru aplicaţie:

   • Componenta WindowedApplication e o subclasă a componentei Flex Application, reprezintă o aplicaţie ce rulează într-o fereastră nativă a desktopului şi oferă evenimente şi API-uri suplimentare pentru interacţiunea cu aceastră fereastră.
   • Componenta Label e folosită pentru a afişa textul „Salut Lume”.

3. Salvaţi fişierul.

Suntem gata să testăm aplicaţia.

1. Alegeţi Run > Debug SalutLume (Rulare > Depanare SalutLume)

   Aplicaţia trebuie să starteze şi va arăta similar Figurii 2-2 (cu cromul ferestrelor dependent de sistemul de operare pe care e rulată aplicaţia).

   [IMAGE] Figura 2-2 Aplicaţia „Salut Lume”

Verificaţi următoarele dacă nu aţi reuşit să lansaţi aplicaţia:

• Verificaţi dacă nu aveţi erori de compilare. Acestea sunt afişate în panoul „Problems” (Probleme) ce poate fi accesat de aici: Windows > Problems (Ferestre > Probleme).
• Erorile la rulare vor fi afişate în panoul „Console” (Consolă). Acesta poate fi accesat aici: Windows > Console (Ferestre > Consolă).
• Dacă obţineţi o eroare de rulare în timpul depanării aplicaţiei, Flex Builder va trece la profilul „Depanare” de unde veţi putea să depanaţi aplicaţia în curs de rulare. Puteţi seta manual puncte de întrerupere (breakpoints). Însă ambele subiecte sunt în afara temelor abordate de această carte.

Corectaţi erorile şi depanaţi încă o dată aplicaţia. Dacă rulează fără probleme atunci suntem gata să împachetă aplicaţia într-un fişier AIR distributiv.

Împachetarea şi Distribuirea Aplicaţiei „Salut Lume”

După cum am menţionat mai devreme în secţiunea „Împachetarea şi Publicarea Aplicaţiilor AIR” - toate aplicaţiile AIR sunt distribuite în fişiere AIR. Un fişier AIR reprezintă un pachet arhivat ce conţine toate fişierele şi informaţia necesare instalării unei aplicaţii AIR în sistemul utilizatorului.

IDE-ul Flex Builder are suport integrat pentru crearea şi semnarea fişierelor AIR.

Trebuie să îndepliniţi următorii paşi pentru a crea un fişier AIR în Flex Builder:

1. Să specificaţi informaţii referitoare la fişierul AIR (inclusiv numele acestuia şi fişierele pe care le va include).
2. Să semnaţi fişierul AIR (fie cu un certificat auto-semnat, fie cu unul emis de o Autoritate de Certificare)

Crearea şi Semnarea fişierului AIR în Flex Builder

1. Asiguraţi-vă că proiectul Dvs. e selectat în panoul „Flex Navigator” şi alegeţi Project > Export Release Build...* (Proiect > Exportă Versiune pentru Publicare)

2. Această operaţiune va deschide fereastra „Export Release Builder” (Constructorul Versiunii de Export). Fişierul pentru export, implicit, va avea numele SalutLume.air şi va fi plasat în dosarul proiectului.

3. Apăsaţi butonul Next, şi veţi ajunge în secţiunea "Digital Signature" (Semnătură Digitală).

   Vom folosi un certificat auto-semnat pentru a semna aplicaţia noastră, întrucât aceasta nu este destinată punerii în producţie.

4. Asiguraţi-vă că radio-butonul Export and sign an AIR file with a digital certificate (Exportă şi semnează fişierul AIR cu un certificat digital) e selectat.

5. Trebuie să creăm un certificat nou pentru că e prima dată când exportăm aplicaţia. Apăsaţi butonul Create... (Creare).

   Dacă aţi creat o aplicaţie AIR şi un certificat anterior, selectaţi certificatul, introduceţi parola şi săriţi spre punctul 11.

6. Introduceţi numele Dvs. în câmpul Publisher name (Numele autorului).

7. Alegeţi tipul de criptare 1024-RSA.

8. Introcueţi parola în câmpurile Password şi Confirm password. Veţi folosi această parolă pentru a semna fişierele AIR cu certificatul generat.

9. Alegeţi o locaţie unde să salvaţi certificatul generat. Ne vom referi la această locaţie cu nuleme următor *<CERTIFICATE_PATH>*

10. Apăsaţi OK.

    Fereastra de dialog se va închide şi veţi ajunge înapoi la secţiunea Digital Signature iar informaţia certificatului generat va fi introdusă automat.

11. Dacă sunteţi conectat la Internet, asiguraţi-vă că aveţi selectată opţiunea Timestamp. În caz contrar deselectaţi-o.

    NOTĂ

    La semnarea fişierului AIR, Flex Builder va încerca să se conecteze la un server de timp (eng. timeserver) pentru a ştampila temporal fişierul AIR. Dacă conexiunea va eşua veţi fi înştiinţat despre eroare.

    Puteţi omite această eroare deselectând opţiunea ştampilării temporale.

    Dacă însă aţi dezactivat-o, aplicaţia AIR nu va mai putea fi instalată când/dacă expiră certificatul cu care a fost semnatăşi în general, în utilizarea pentru producţie nu este recomandată dezactivarea ştampilării temporale.

12. Apăsaţi butonul Next....

    Dacă aveţi erori verificaţi:

    • Că setările certificatului sunt configurate să-l folosească pe cel tocmai creat.
    • Că parola introdusă pentru certificatul dat îi corespunde.

    Veţi ajunge la secţiunea AIR File Contents (Conţinutul Fişierului AIR) unde veţi putea alege care fişiere să fie incluse în fişierul AIR.

13. Observaţi că atât fişierul descriptiv cât şi SalutLume.swf sunt selectate şi nu pot fi deselectate deoarece sunt necesare ambele pentru crearea fişierului AIR. Fişierul SalutLume.swf reprezintă aplicaţia compilată generată din fişierul sursă SalutLume.mxml.

    Dacă doriţi să includeţi careva fişiere suplimentare, copiaţi-le în dosarul proiectului şi adăugaţi-le în secţiunea dată. Acestea vor fi incluse în fişierul AIR şi vor fi copiate la instalare pe calculatorul utilizatorului pentru a putea fi accesate de aplicaţie la rulare.

14. Apăsaţi butonul Finish (Terminare). Acest pas va genera fişierul AIR numit SalutLume.air în locaţia indicată de Dvs.

Dacă aveţi runtime-ul Adobe AIR instalat puteţi instala aplicaţia lansând fişierul AIR creat.

Distribuirea şi Instalarea Aplicaţiei

Există două metode primare de destribuire a aplicaţiilor AIR.

1. Distribuirea fişierului AIR pe un server web, pe poşta electronică, pe DVD etc... E necesar ca utilizatorul să aibă instalat runtime-ul.

2. Folosirea insignei de instalare (install badge) dintr-o pagină web. Dacă pe caculatorul utilizatorului încă nu este instalat runtime-ul Adobe AIR, se va propune instalarea acestuia şi apoi se va începe instalarea aplicaţiei. Vom analiza subiectul în capitolul „reţetelor”.

   Puteţi afla mai multe despre instalarea cu insignă aici: http://www.adobe.com/devnet/air/articles/air_badge_install.html.

Setarea tipului MIME

La distribuirea fişierului pe un server web, luaţi seama asupra setării tipului corect MIME. Dacă acesta nu e setat corect browserului poate lua fişierul AIR drept un fişier ZIP (pe care poate să-l şi redenumească între timp) sau poate să afişeze biţi bruţi ai fişierului în browser, în loc s-ăl descarce pe calculatorul utilizatorului.

Tipul MIME corect pentru un fişier AIR este:

application/vnd.adobe.air-application-installer-package+zip

Pentru un server Apache, spre exemplu, veţi fi nevoit să adăugaţi următorul rând în fişierul de configurare al Apache-ului:

AddType application/vnd.adobe.air-application-installer-package+zip .air

Verificaţi documentaţia serverului Dvs. web pentru mai multe informaţii privind setarea tipurilor MIME.

Următorii paşi

La momentul dat trebuie să dispuneţi de cunoştinţele de bază necesare dezvoltării, testării şi publicării unei aplicaţii AIR. Puteţi începe să studiaţi API-urile AIR şi procedurile de dezvoltare a unor aplicaţii AIR mai complexe.