La mia prima applicazione flex da sviluppatore - Prima Parte

Dopo aver pubblicato nella sezione “Manuali” la guida per creare la nostra prima applicazione non da sviluppatori, è arrivato il momento di cominciare in diverse puntate a descrivere come usare il codice sorgente che scarichiamo dal sito ESRI per realizzare la nostra applicazione personalizzata.

L’attuale versione del Flex Viewer è la 3.0.

flexviewer-3.0-src.zip

Per lavorare con il codice sorgente abbiamo bisogno di alcuni strumenti essenziali:

1) Ambiente di sviluppo Adobe  Flash Builder 4.5 minimo meglio se Adobe Flash Builder 4.6.

Una versione di prova la trovate al seguente link https://www.adobe.com/cfusion/tdrc/index.cfm?product=flash_builder

2) Scaricare Adobe Flex SDK 4.6 dal sito Adobe (se avete installato come ambiente di sviluppo il Flash Builder 4.6 è già integrato nell’installazione!)

http://www.adobe.com/devnet/flex/flex-sdk-download.html

3) Scaricare nel la sezione “Download source code for viewer” il codice sorgente della nostra web application.

 http://help.arcgis.com/en/webapps/flexviewer/ 

3) Scaricare le API FlEX attualmente alla versione 3.0 dal seguente link

http://links.esri.com/flex-api/latest-download

4) Installare il Flash Player relativo al browser che vogliamo usare

Se non avete molta confidenza con l’ambiente di sviluppo Flash Builder prima di intraprendere questa esperienza con il visualizzatore Flex ESRI, vi consiglio di “giocare” qualche giorno con il Flash Builder creando dei progetti di prova scaricando i vari manuali ed esempi che si trovano in rete.
Una volta pronti, e preso confidenza con l’ambiente di sviluppo, procediamo con la nostra prima applicazione !!

La prima cosa da fare è creare  la nostra cartella di lavoro sul nostro disco (ad esempio c:\FlasBuilderProject) dove andiamo a salvare tutti i nostri progetti. La cartella di lavoro, che viene chiamata nell’ambiente di sviluppo Workspace, è il contenitore della nostra applicazione. In questa cartella andremo ad importare il progetto, compilarlo, inserire i diversi file ecc..
Creata la cartella apriamo il nostro ambiente di sviluppo Flash Builder. Se è la prima volta che lo aprite potrebbe apparire una finestra per la selezione della workspace.  Selezionare la cartella precedentemente creata. Se non viene proposto nulla dall’interfaccia del Flash Builder nel menù “File” selezioniamo “Switch Workspace”, dal menù proposto selezioniamo la voce “Other…” e attraverso il tasto “Browse…” selezioniamo la nostra cartella di lavoro.

Alla riapertura dell’applicativo vediamo che nella finestra  “Package Explorer” non compare nulla, non vi preoccupate è normale, abbiamo solo impostato la nostra cartella di lavoro ma non ancora importato il progetto. 

Per importare il progetto selezionare nel menù “File” la voce “Import Flash Builder Project…”

Dalla finestra proposta selezioniamo la voce “File” (selezionata di default) e attraverso il tasto “Browse…” selezioniamo il file contente il codice sorgente in formato zip precedentemente scaricato dal sito ESRI (ArcGIS-ArcGISViewerForFlex-flexviewer-3.0-src-0-g86c98bc.zip).

 Nella schermata proposta viene mostrato quale sarà il progetto importato e il metodo di importazione. Solitamente si importa una nuova copia del progetto estraendola dal file zip nella cartella di lavoro attuale. Nel nostro caso sarà creata una cartella “FlexViewer”  nella nostra workspace, che ricordiamo  collocata in “c:\FlasBuilderProject” e pertanto  avremo  “c:\FlasBuilderProject\FlexViewer”.

Clicchiamo sul tasto “finish” per concludere l’importazione.

Dopo aver importato il progetto viene richiesta la scelta della versione dell’SDK da usare per la fase di compilazione.

Vi ricordo che l’attuale  versione del Flex Viewer, ossia la versione 3.0, è stata compilata con l’SDK 4.6.

Dalla schermata proposta selezionare “Use a specific SDK:” e selezionare “Flex 4.6.0” oppure se non presente in lista cliccare su “Configure Flex SDKs…” per impostarlo.

Termianata la compilazione vediamo che sono presenti diversi errori!

Questo accade perché non abbiamo ancora agganciato la libreria contente le API Flex rilasciate da ESRI (arcgis_api_for_flex_3_0.zip).

Estraimo la cartella e preleviamo il file “agslib-3.0-2012-06-06.swc” presente nella sottocartella “ArcGis_Flex” à “Libs”.

Copiare questo file, anche trascinandolo direttamente nell’ambiente di sviluppo, nella cartella “libs” del nostro progetto. Dopo averlo copiato automaticamente sarà ricompilato il progetto.

Terminata la compilazione siamo pronti per lanciare per la prima volta la nostra applicazione tramite il tasto “Run”  presente nell’ambiente di sviluppo.

Ecco a voi la vostra prima applicazione da codice!!

Nei prossimi post vedremo come configurare, personalizzare ed esportare la nostra applicazione da esporre.