WikiUp

Premessa

  1. Un compilatore java (JDK) in versione 1.6 o superiori
  2. Un IDE per lo sviluppo del codice: Eclipse
  3. Un DBM locale: MySQL
  4. Un sistema di version control e gestione dei sorgenti: SVN

In questo documento si farà riferimento diretto all'installazione dell'ambiente di sviluppo Asup su una macchina con sistema operativo Windows. Tutti i software necessari sono comunque disponibili anche per piattaforme alternative (Linux e Apple) che possono pertanto essere liberamente utilizzate. I dettagli per l'installazione su ambienti diversi da Windows si possono trovare sui siti di distribuzione dei singoli prodotti.

Installazione della JDK

Per lo sviluppo Asup è necessario installare sulla macchina un compilatore Java in versione 1.6 o successive. E' probabile che sul vostro sistema sia già installato un runtime JRE (Java Runtime Environment), è comunque consigliabile procedere con l'installazione di un compilatore vero e proprio, denomimato JDK (Java Developer Kit). Il compilatore può essere scaricato liberamente dal sito Oracle. alla pagina;

http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html

Selezionare la versione adatta al proprio sistema operativo e seguire le istruzioni relative alla vostra piattaforma operativa.

Installazione IDE di sviluppo (Eclipse) e relativi componenti

Per l'installazione della parte IDE, è stato scelto di utilizzare Pulse, un prodotto che consente di definire configurazioni centralizzate per l'ambiente di sviluppo Eclipse condivisibili tra utenti diversi. Pulse è disponibile per vari sistemi operativi (Windows, Linux e Apple) ed è pensato per l'allineamento degli IDE di sviluppo anche tra piattaforme di diverso tipo (una volta creata una configurazione, questa può essere riportata tale e quale su tutti i sistemi per cui esiste una versione di Pulse senza bisogno di setting specifici per la piattaforma specifica).

Vediamo i passi necessari per l'installazione dell'ambiente di sviluppo Eclipse Dalla pagina:

http://www.poweredbypulse.com/all_os.php

scaricare sul proprio sistema il setup del client Pulse adatto alla propria piattaforma operativa. La versione del client Pulse di riferimento è la 4, disponibile per Windows, Linux e Mac.

  1. Installare il client Pulse scaricato dall'URL precedente. Le modalità di installazione sono specifiche in funzione del sistema e si possono trovare nella stessa pagina da cui è stato scaricato l'installatore.
  2. Finita l'installazione avviare il client Pulse selezionando nel menù di avvio la voce "Pulse Explorer". Alla partenza viene mostrata un dialog che chiede la creazione di un nuovo utente o il login con un utente già assegnato. Selezionare la seconda opzione e al prompt di sistema inserire l'utente asupdevelopers@gmail.com e la password oppulivsasup. Questo è l'utente comune creato per lo sviluppo Asup, ed è lo stesso utente con cui è possibile accedere allo spazio su cloud Google dedicato alla condivisione di documenti relativi al progetto Asup.
  3. Nella finestra principale di Pulse Explorer. In basso a sinistra c'è una sezione denominata "My Profiles" che dovrebbe contenere le configurazioni di eclipse che si è deciso di condividere tra gli sviluppatori del progetto Asup. Selezionare con il tasto destro del mouse la voce "Eclipse 3.7 IDE for Asup" e selezionare la voce install.
  4. A questo punto dovrebbe partire una procedura guidata che effettuerà l'installazione sulla macchina locale del profilo eclipse selezionato. La procedura di installazione prevede il download di almeno 200 mb di dati e pertanto potrebbe richiedere parecchi minuti per il suo completamento.
  5. Alla fine della procedura di installazione, nel menù Pulse presente nel menù di avvio comparirà la voce "Eclipse 3.7 IDE for Asup". Selezionandola si ottiene l'avvio dell'IDE Eclipse già preimpostato con tutti i moduli aggiuntivi necessari allo sviluppo Asup.

Una volta terminata l'installazione dell'ambiente di sviluppo Eclipse, è necessario entrare nell'IDE ed effettuare manualmente alcune operazioni di setup che non possono essere automatizzate nel setup.

Setup dell'ambiente di sviluppo

In questa sezione verranno elencate le operazioni di setup necessarie per la preparazione dell'ambiente di sviluppo. Si da per scontata una conoscenza di base dell'ambiente Eclipse e dei suoi componenti fondamentali (workspace, perspective, view ecc ecc)

Primo avvio di Eclipse e selezione del workspace

Al primo avvio, Eclipse chiede di specificare la cartella di sistema da usare come workspace. Visto che il progetto Asup è composto da una serie di sottoprogetti, si consiglia di creare un nuovo workspace e tenere tutti i progetti relativi ad Asup in questo workspace, in modo da non confonderli con progetti già preesistenti. A piacere, è possibile specificare come default il workspace appena creato in modo da evitare che ai successivi avvii Eclipse chieda quale workspace utilizzare.

Si consiglia di assegnare al nuovo workspace il nome "JavaAsupProject"; questo semplificherà in parte le successive operazioni di setup, che sono state create tenendo come riferimento un workspace con questo nome.

Setup del sistema di versioning SVN

Il plugin SVN per il controllo di versione è già installato nel profilo Pulse fornito per lo sviluppo.

  1. In Eclipse, selezionare la perspective "SVN"
  2. Nel tab "SVN Repositories" creare il collegamento al server SVN selezionando l'icona "New repository location"
  3. Nel dialog di creazione repository SVN, immettere come URL l'indirizzo https://gilberto.smea.it/asup/svn
  4. Inserire il vostro utente e password di registrazione sul server SVN (se non ne avete uno, chiedete che vi venga creato. E' necessario che ogni utente abbia sual server SVN una password univoca per identificare i sorgenti e le modifiche rilasciate da quell'utente nel sistema di versioning).

Importazione e creazione dei progetti in Eclispe.

Il progetto Asup è composto da una serie di moduli operativi. Per ognuno di questo moduli esiste un progetto Eclipse, pertanto per preparare l'ambiente di sviluppo è necessario andare sul server SVN e scaricare tutti i moduli di sviluppo che compongono Asup.

  1. In Eclipse posizionarsi nella perspective "SVN" e selezionare il server SVN di Asup creato nel punto precedente.
  2. Verrà mostrato un albero che elenca tutti i sottoprogetti che compongono Asup (circa 20 al momento della scrittura di questo documento, ma in continuo aumento).
  3. Selezionare tutte le voci tranne "ROOT" e "REVISIONS" (che sono voci strutturali inserite dal server SVN)
  4. Cliccare con il tasto destro del mouse su una qualsiasi delle voci selezionate e nel popup scegliere l'azione "Find/Check Out as.."
  5. Nel dialog che varrà mostrato selezionare l'opzione "Find projects in the children of the selected resources" e premere il tasto "Finish"

L'operazione di importazione potrebbe richiedere parecchi minuti, alla fine nel workspace dovrebbero comparire i progetti eclipse relativi ad Asup.

Installazione di un DBM locale

Per lo sviluppo e il funzionamento di Asup è necessaria la disponibilità sulla macchina di sviluppo di un DB engine locale accessibile da Java attraverso un driver JDBC. Il driver JDBC è disponibile per praticamente tutti i DB manager più noti pertanto è in teoria possibile installare sulla macchina locale uno qualsiasi di questi prodotti.

Per uniformità si consiglia comunque l'installazione del DB engine MySQL, un prodotto molto noto e ben collaudato disponibile per tutte le possibili piattaforme operative. Sul sito del produttore di MySQL:

http://www.mysql.it

è possibile scaricare il pacchetto MySQL per tutte le piattaforme e trovare le istruzioni dettagliata su come installare il prodotto sulla propria piattaforma operativa (Windows, Linux o Mac).

In fase di installazione verrà chiesto di assegnare una password all'utente "root". Si consiglia di assegnare il valore "mimo2011", valore sul quale sono preimpostati tutti i settings di progetto rilasciati con Asup. E' comunque possibile assegnare all'utente root una password diversa da questa, oppure creare un utente specifico per Asup (utente che deve comunque posserere autorizzazioni di amministratore). In questo caso sarà però necessario andare a modificare maqnualmente i settings di progetto per inserire le credenziali create.

Setting dell'ambiente di sviluppo da eseguire dopo l'installazione

Nei punti successivi analizzeremo i setting da effettuare nell'ambiente di sviluppo per abilitare tutte le funzionalità. Questi settings non sono automatizzabili e vanno quindi effettuati a mano.

Settings del driver JDBC per accesso al database MySQL

  1. In Eclipse, selezionare la voce di menù "Windows --> Preferences"
  2. Nel dialog "Preferences" che si apre, selezionare la voce "SQLExplorer --> JDBC Drivers"
  3. Selezionare con il mouse (non con segno di spunta) la voce "MySQL Driver" e premere il pulsante "Edit" posto a destra.
  4. Nel dialog "Change Driver" che si apre, controllare che nel campo Name ci sia MySQL driver. In caso contrario tornare indietro e controllare di aver selezionato correttamente il driver da modificare.
  5. Selezionare il tab "Extra class Path" aggiungere un nuovo jar premendo il bottone "Add JARs" e selezionando il file "<%WORKSPACE%>\org.asup.mysql\lib\mysql-connector-5.1.13-bin.jar" dove con <%WORKSPACE%> si intende la directory che contiene il workspace del progetto Asup.
  6. Una volta aggiunto il jar come da punto precedente, selezionare il bottone "List Drivers". Se tutto va bene, nel campo "Driver Class Name" dovrebbe comparire la scritta "com.mysql.jdbc.Driver"
  7. Controllare che nel campo "Example URL" ci sia la stringa "jdbc:mysql://<hostname>No InterWiki reference defined in properties for Wiki called "<"!/<dbname>". Se non c'è, aggiungerla.
  8. Premere il tasto OK per ritornare al dialog JDBC Drivers e controllare che la voce "MySQL Driver" abbia il segno di spunta.

Creazione collegamento al database MySQL in SQLExplorer

  1. In Eclipse, selezionare la perspective "SQLExplorer"
  2. Nel tab "Connections" selezionare l'icona "Create new connection profile"
  3. Nel dialog che si apre, inserire nel campo Name il nome che si vuole dare alla connessione, ad esempio "MySQL locale"
  4. Selezionare il driver MySQL Driver (che deve essere preventivamente configurato, vedi paragrafo precedente)
  5. Nel campo URL inserire "jdbc:mysql://localhost"
  6. Inserite nel campo User il valore "root" e nel campo password il valore "mimo2011" (che sono user e pwd consigliati in fase di installazione del db MySQl. Se si sono usate credenziali diverse, inserire quelle).
  7. Selezionare il flag "AutoCommit" e premere OK per terminare.

Setting del plugin AntLR IDE

  1. In Eclipse, selezionare la voce di menù "Windows --> Preferences"
  2. Selezionare la voce "ANTLR" e poi "Builder"
  3. Premere il bottone "Add" sotto la sezione "Installed Packages".
  4. Nella finestra "Add ANTLR Package", selezionare il bottone "Directory" e selezionare la directory "<%WORKSPACE%>\org.asup.parser\lib" (dove al solito, con <%WORKSPACE%> si intende il workspace in cui è stato posto il progetto Asup
  5. Dopo la selezione i rimanenti campi del dialog dovrebbero essere compilati automaticamente. Chiudere la finestra e nella finestra che riprende il fuoco selezionare il bottone "Apply".
  6. Per il corretto funzionamento del plugin AntLR è necessario cancellare il bundle "org.asup.parser" e ricrearlo a partire dal SVN.

Add new attachment

Only authorized users are allowed to upload new attachments.
«