Ginipad
Un ambiente di sviluppo per Java scritto in Java

Home

Screenshots

Download

Installazione

Istruzioni

Documentazione

Links

Contatta

Ringraziamenti

 

MokaByte

 

Istruzioni

Ginipad è stato progettato per offrire il massimo grado di funzionalità nel modo più semplice ed intuitivo possibile. Bastano cinque minuti per prendere confidenza con l'ambiente e le sue funzioni. Questa sezione fornisce una tabella riassuntiva dei principali comandi, un esempio d'uso delle funzionalità più comuni e una guida ai pannelli di controllo per l'impostazione delle preferenze. Nella sezione Download, sotto la voce "materiale aggiuntivo" è disponibile una slideshow Power Point che permette di conoscere il prodotto nel più breve tempo possibile.

Caratteristiche principali

  • 1) Pochi pulsanti facili da identificare
  • 2) Possilità di lavorare su più di un documento
  • 3) Editor con Syntax Higlight
  • 4) Indice navigabile di metodi, campi e classi interne
  • 5) Autocompletamento delle dichiarazioni
  • 6) Hiperlink verso gli errori

Tavola Riassuntiva dei comandi

File
New (Ctrl-N) Crea un nuovo sorgente Java.
Open (Ctrl-O) Carica un sorgente da disco.
Save As (Ctrl-S) Salva il documento corrente.
  Close (Ctrl-W) Chiude il documento corrente.
  Open All   Apre in una volta sola gli ultimi otto sorgenti.
  Exit   Chiude il programma.
Edit
Cut (Ctrl-X) Taglia il testo selezionato.
Copy (Ctrl-C) Copia il testo selezionato.
Paste (Ctrl-V) Incolla il testo contenuto nella clipboard.
  Select All (Ctrl-A) Seleziona tutto il contenuto dell'editor.
Undo (Ctrl-Z) Annulla l'ultima modifica.
Redo (Ctrl-Y) Ripristina l'ultima modifica.
Find (Ctrl-F) Apre la finestra di dialogo "Find".
Replace (Ctrl-R) Apre la finestra di dialogo "Replace".
Tools
Compile (Ctrl-SHIFT-C) Compila il documento corrente.
Run (Ctrl-SHIFT-R) Esegue il documento corrente.
Stop   Interrompe l'esecuzione del processo corrente.
  Format source code (CTRL-SHIFT-F) Esegue una formattazione del codice.
Console
Hide Tree   Nasconde il componente ad albero.
Show Tree   Mostra il componente ad albero.
Hide Console   Nasconde la console.
Show Console   Mostra la console.
Show Panels   Mostra tutti i pannelli.
Full Screen   Espande l'editor a pieno schermo.
Clear Console   Ripulisce la console.
Dialog
Preferences   Apre la finestra delle preferenze.
Help   Apre la finestra di Help.
About   Apre la finestra di About.

Scrivere, Compilare, Correggere, Eseguire

Avviare il programma. La schermata di avvio si presenterà come segue:

Premere il tasto     (o la combinazione CTRL-N): apparirà una finestra di dialogo. Impostare i controlli come in figura e premere OK.

A questo punto digitare il sorgente:

public class HelloWorld {
  public static void main(String argv[]) {
    System.out.println("Hello World!")
  }
}  

Premere il tasto  (o la combinazione CTRL-S) e salvare il sorgente su disco con il nome "HelloWorld.java" 

Premere il tasto  (o la combinazione SHIFT-CTRL-C) per compilare. Al termine della compilazione, la console dovrebbe segnalare un errore: un click sul messaggio di errore farà sì che venga messa in evidenza la riga da correggere:

Aggiungere il punto e virgola alla fine della riga segnalata:

public class HelloWorld {

  public static void main(String argv[]) {
    System.out.println("Hello World!");
  }
}
 

Ricompilare. L'operazione andrà a termine dopo pochi secondi. Premere il tasto  (o la combinazione SHIFT-CTRL-R) per avviare il programma appena compilato. La console mostrerà il seguente output:

Formattazione del codice

Durante l'editing di sorgenti java, talvolta è necessario indentare o deindentare interi blocchi di codice. Per facilitare l'operazione, il Ginipad offre un'apposita funzionalità. E' sufficiente evidenziare le righe da modificare, e quindi premere il tasto TAB se si desidera indentare, o la combinazione SHIFT-TAB se si desidera deindentare.

Ginipad inoltre dispone di una funzionalità di formattazione automatica del codice, attivabile con la voce "Format source code", presente nel menu "Tools", o con la combinazione di tasti CTRL-SHIFT-F. Il formattatore di codice allinea automaticamente le parentesi, elimina gli spazi in eccesso e corregge l'indentazione del codice seguendo le impostazioni dell'utente: questo permette di mantenere uniforme lo stile di presentazione del codice. Per maggiori informazioni, consultare la sezione "Personalizzazione" di questa guida.

Indice dei metodi.

Ginipad dispone di un comodo indice ad albero che offre una rappresentazione schematica del codice sorgente. L'albero viene aggiornato automaticamente ogni volta che l'utente ha terminato una fase di editing.

Un click su una foglia dell'albero permette di evidenziare la porzione di codice corrispondente all'interno dell'editor: in questo modo si ha sempre a disposizione un pratico sistema per navigare programmi di grosse dimensioni.

Simboli
File Sorgente
Classe
Interfaccia
Attributo
Metodo

I pulsanti "Fields" e "Operations" permettono di ridurre il dettaglio del grafico, eliminando, rispettivamente, gli attributi e i metodi dalla visualizzazione.

Navigazione del File System

Premendo il tab "My Computer", in alto a sinistra sopra l'indice ad albero dei metodi, viene visualizzato un pratico browser ad albero con il quale è possibile navigare il file system:

I sorgenti Java vengono messi in evidenza: con un doppio click del mouse è possibile aprirli direttamente nell'editor.

Find & Replace

Per attivare il pannello "Find" o "Find e Replace", attivare le voci "Find" o "Replace..." dal menu "Edit". Vediamo in dettaglio il funzionamento del Replace.

Digitare la stringa da cercare sul campo di testo in alto: il cursore si posizionerà automaticamente sulla prima occorrenza della stringa. Se si seleziona l'opzione "Case Sensitive", la ricerca terrà conto della differenza tra lettere maiuscole e minuscole. Digitando invio, il cursore si sposterà all'occorrenza successiva.

Nel campo di testo in basso digitare la stringa da sostituire e premere invio. Verrà visualizzato una finestra a scelta multipla che permetterà di specificare se si desidera rimpiazzare solo l'occorrenza attuale (Replace), se si desidera rimpiazzare tutto (Replace All), se si desidera passare all'occorrenza successiva (Next) o se si vuole terminare l'operazione (CANCEL):

Personalizzazione

Tutti i parametri del programma possono essere modificati attraverso un completo insieme di pannelli di controllo. Le impostazioni verranno automaticamente salvate nel profilo utente, in modo da poter essere recuperate al successivo avvio.

Oltre agli attributi visuali, è possibile prsonalizzare i parametri di formattazione del codice e quelli del compilatore. Per attivare la finestra delle preferenze, selezionare la voce "Preferences" dal menu "Edit"

Pannello Editor

Il pannello "Editor" offre la possibilità di personalizzare il font della Text Area, i colori del carattere principale e dello sfondo, e i colori delle diverse categorie sintattiche del Syntax Highlight. E' inoltre possibile attivare e disattivare il meccanismo di autocompletamento delle dichiarazioni.

  • Auto Completition Facility: permette di attivare-disattivare la funzionalità di completamento automatico delle chiamate.
  • Editor Font: presenta i controlli che permettono di impostare il font dell'editor, le sue dimensioni e lo stile (neretto-corsivo). Per un uso professionale, si consiglia di utilizzare un Font "monospaced" o "Courier", con una dimensione di 12 o 14, da portare a 18 in caso di video proiezione.
  • Editor Colors: permette di impostare i colori di sfondo (Background) e del carattere (Foreground).
  • Syntax Highlight: offre la possibilità di impostare i colori del syntax highlight.

Pannello Look and Feel

Il pannello Look & Feel permette di impostare alcuni parametri che regolano l'aspetto complessivo dell'Interfaccia Grafica.

  • Swing Look & Feel: Permette di impostare il Look & Feel tra quelli disponibli sul sistema ospite. Oltre ai Look and Feel standard, viene offerta la possibilità di impostare delle skin. Le skin disponibili per default sono "Modern", "Aqua" e "XPluna". Sono disponibili altre skin sul sito http://www.l2fprod.com/". Per aggiungerle all'elenco di quelle disponibili, copiare i file zip delle skin nella cartella "themePack" che si trova nella directory principale del Ginipad.
  • Next time start with different Mutlti Document Interface": permette di impostare l'interfaccia multi documento: oltre alla classica interfaccia a Tab, sono disponibili una modalità denominata Card ed una che fa uso di Internal Frame. Per mettere in atto la modifica è necessario riavviare il programma

    Card Internal Frame

  • Next time start with different Icon Set": permette di scegliere le dimensioni delle icone per i pulsanti. Di default vengono utilizzate icone di 16x16 pixel, ma è disponibile un set di pulsanti 24x24. Per mettere in atto la modifica è necessario riavviare il programma.

Pannello Console

Permette di impostare le combinazioni Font-Colore delle console di Ginipad.

  • Runtime Console Settings: permette di impostare le combinazioni Font-Colore della console di runtime.
    • Use Editor Font and Colors: utilizza le stesse combinazioni Font-Colore dell'Editor. Selezionando questa casella, gli altri controlli vengono disabilitati automaticamente.
    • Font: permette di impostare il tipo, le dimensioni e gli attributi del font.
    • Colors: permette di impostare i colori di sfondo (Background) e del carattere (Foreground).
  • Compiler Console Settings: permette di impostare le combinazioni Font-Colore della console del compilatore.
    • Use Editor Font and Colors: utilizza le stesse combinazioni Font-Colore dell'Editor. Selezionando questa casella, gli altri controlli, con l'esclusione di "Errors" e "Messages", vengono disabilitati automaticamente.
    • Font: permette di impostare il tipo, le dimensioni e gli attributi del font.
    • Colors: permette di impostare i colori di sfondo (Background) e del carattere (Foreground), dei messaggi di errore (Errors) e dei messaggi di servizio (Messages).

Pannello Tree

Permette di impostare il font e i colori dei browser ad albero che si trovano nel pannello di sinistra di Ginipad.

  • File Browser Settings: permette di impostare le combinazioni Font-Colore del file browser ad albero
    • Use Editor Font and Colors: utilizza le stesse combinazioni Font-Colore dell'Editor. Selezionando questa casella, gli altri controlli vengono disabilitati automaticamente.
    • Font: permette di impostare il tipo, le dimensioni e gli attributi del font.
    • Colors: permette di impostare i colori di sfondo (Background) e del carattere (Foreground).
  • Source Browser Settings: permette di impostare le combinazioni Font-Colore del browser di codice sorgente.
    • Use Editor Font and Colors: utilizza le stesse combinazioni Font-Colore dell'Editor. Selezionando questa casella, gli altri controlli vengono disabilitati automaticamente.
    • Font: permette di impostare il tipo, le dimensioni e gli attributi del font.
    • Colors: permette di impostare i colori di sfondo (Background) e del carattere (Foreground).

Pannello Code Format

Questo pannello permette di impostare le preferenze del formattatore automatico di codice.

  • Style: premette di scegliere tra due formati di allineamento delle parentesi (Compact Style ed Aligned Braces) e di impostare la profondità dell'indentazione. Le modifiche a questi parametri vengono visualizzate nel pannello a destra.
  • Line Wrap: se attivata, questa funzione fa in modo che le righe vengano spezzate quando superano una certa lunghezza.

Pannello Compilatore

Il pannello "Compiler" permette di impostare i parametri del compilatore javac. L'uso di questo pannello è consigliato solamente agli utenti più esperti.

  • Compiler Options: permette di impostare i principali flag del compilatore:
    • Optimize: il compilatore esegue alcuni passaggi di ottimizzazione del codice, che richiedono un tempo di compilazione leggermente maggiore del normale.
    • Show deprecated API: durante la compilazione verranno mostrate le informazioni relative alle classi del JDK che sono state dichiarate "deprecated", delle quali si sconsiglia l'uso.
    • Generate no warning: il compilatore non segnalerà i "warning", ossia le situazioni che, pur non costituendo a tutti gli effetti degli errori, richiedono una particolare attenzione.
    • Generate verbose Output: l'output del compilatore conterrà un gran numero di informazioni aggiuntive sulle varie fasi della compilazione.
    • Output directory: permette di impostare una directory di output diversa da quella del sorgente. Se si attiva questa opzione, sono disponibili due scelte: premendo il tasto , i files .class verranno piazzati in una directory /out relativa alla posizione del sorgente; premendo il tasto  è possibile specificare un percorso assoluto sul disco.
  • Assert Facility: questa sezione permette di impostare i parametri relativi alla gestione al costrutto "assert", introdotto nel linguaggio Java a partire dal JDK 1.4.
    • Enable 1.4 source code support: abilita il supporto alle assert. E' necessario abilitare questa voce se si vuole essere in grado di compilare sorgenti contenenti assert.
    • Enable assert on execution: abilita il controllo delle assert durante l'esecuzione. Se questa voce è disabilitata, le assert vengono ignorate.
    • Enable assert on system classes: abilita il controllo delle assert sulle classi di sistema (le librerie del JDK).
  • Additional Classpath: permette di ampliare il classpath, aggiungendo un elenco di directory, files Zip o Jar. Ogni voce dell'elenco può in seguito essere rimossa premendo il tasto "Remove".
  • JDK Location: permette di specificare la posizione del JDK all'interno del disco. Questo parametro viene impostato automaticamente al primo avvio, e solitamente non richiede di essere modificato.

Istruzioni

Caratteristiche Principali

Tavola riassuntiva dei Comandi

Scrivere, Compilare, Correggere, Eseguire

Formattazione del Codice

Indice dei Metodi

Navigazione del File System

Find & Replace

Personalizzazione

 

MokaByte® è un marchio registrato da MokaByte s.r.l.
Java®, Jini® e tutti i nomi derivati sono marchi registrati da Sun Microsystems.
Tutti i diritti riservati. E' vietata la riproduzione anche parziale.
Per comunicazioni inviare una mail a info@mokabyte.it