# Eclipse (Italiano)

Eclipse è un progetto open source basato su una community, con l'obiettivo di fornire una piattaforma di sviluppo universale. Il progetto Eclipse è conosciuto soprattutto per il suo ambiente di sviluppo integrato (IDE) e multipiattaforma. I pacchetti per Arch Linux (e questa guida) si riferiscono specificamente all'ambiente di sviluppo.

L'IDE di Eclipse è scritto per la maggior parte in Java ma può essere usato per sviluppare applicazioni in molti altri linguaggi, tra cui Java, C/C++, PHP e Perl. L'IDE fornisce anche supporto per la sottoversione SVN (vedere sotto) e la gestione dei processi (per questo scopo usa la sua TOTO list integrata o il pacchetto aggiuntivo eclipse-mylyn).

## Installazione

È molto facile installare Eclipse SDK in Arch Linux:

    # pacman -S eclipse

Questo pacchetto di base supporta già lo sviluppo di applicazioni Java.

## Plugins

Ci sono due modi di installare un plugin per Eclipse:

- usando pacman per installare i plugin presenti nei repository di Arch (vedere Eclipse plugin package guidelines per ulteriori informazioni);
- usando il plugin manager di Eclipse per scaricare e installare plugin dai repository originali; in questo caso è necessario trovare i repository necessari dal sito dei plugin, quindi su Eclipse selezionare Help -> Install New Software..., compilare il campo Work with con il repository, selezionare il plugin da installare nella lista e seguire le istruzioni.

Attenzione:

- Installando con il plugin manager, è consigliato eseguire Eclipse come root: in questo modo i plugin saranno installati in `/usr/share/eclipse/plugins/`; installando come utente normale verranno memorizzati nella cartella `~/.eclipse/` e non verranno più riconosciuti dopo un eventuale aggiornamento di Eclipse.
- Si raccomanda comunque di non utlizzare Eclipse come root per l'uso normale.

### Supporto C/C++

#### Eclipse CDT

- Homepage del progetto: http://www.eclipse.org/cdt/
- Disponibile in [extra]: eclipse-cdt[broken link: replaced by eclipse-cpp]

### Supporto Perl

#### EPIC

- Homepage del progetto: http://www.epic-ide.org/
- Disponibile in AUR: eclipse-epicAUR[broken link: archived in aur-mirror]

### Supporto PHP

#### Eclipse PDT

- Homepage del progetto: http://www.eclipse.org/pdt/
- Disponibile in AUR: eclipse-pdtAUR

#### PHPEclipse

- Homepage del progetto: http://www.phpeclipse.com/
- Disponibile in [community]: eclipse-phpeclipseAUR

#### Aptana PHP

Vedere Aptana Studio più avanti nella pagina.

### Supporto Python

#### PyDev

- Homepage del progetto: http://pydev.org/
- Disponibile in AUR: eclipse-pydevAUR

### Web development (HTML, CSS, JavaScript...)

#### Aptana Studio

- Homepage del progetto: http://www.aptana.org/
- Per il plugin di Eclipse, utilizzare il plugin manager
- Per la versione indipendente, il pacchetto è disponibile in AUR: aptana-studioAUR

### Supporto SVN

#### Subclipse

- homepage del progetto: http://subclipse.tigris.org/
- Disponibile in [community]: eclipse-subclipseAUR
- Come utilizzare la SVN con Eclipse

#### Eclipse Subversive

- Homepage del progetto: http://www.eclipse.org/subversive/
- Disponibile in AUR: eclipse-subversiveAUR

### Supporto Git

#### EGit

- Homepage del progetto: http://www.eclipse.org/egit/
- Disponibile in AUR: egitAUR[broken link: archived in aur-mirror]

## Aggiornamenti

- Eclipse e i plugin installati con pacman vengono aggiornati con pacman stesso
- Per i plugin installati con il plugin manager di Eclipse, è necessario avviare Eclipse e selezionare Help -> Check for Updates (se i plugin sono stati installati come root, anche l'aggiornamento deve essere controllato e installato come root).

Perché i plugin siano aggiornati, occorre controllare di avere abilitato i repository in Window -> Preferences -> Install/Update -> Available Software Sites: i repository dei plugin si trovano sui siti di riferimento dei rispettivi progetti. Per aggiungere, modificare e rimuovere i repository è sufficiente utilizzare i pulsanti a destra del pannello Available Software Sites. Per Eclipse 3.7 (Indigo), assicurarsi di aver abilitato questa repository:

    http://download.eclipse.org/releases/indigo

Per ricevere notifiche di aggiornamento, andare su Window -> Preferences -> Install/Update -> Automatic Updates. Se si vogliono ricevere le notifiche anche per i plugin installati come root, bisogna esportare la lista dei relativi repository con Export, quindi reimportarla utilizzando Import come utente normale.

## Abilitare l'integrazione di javadoc

### Versione online

Se la propria macchina è costantemente connessa a Internet, si può utilizzare la documentazione online fornita da Sun. Per fare ciò:

1. Andare su Window/Preferences, quindi scegliere Java/Installed JREs.
2. Ce ne dovrebbe essere uno chiamato "java" con il tipo "Standard VM". Selezionarlo e scegliere Edit.
3. Selezionare l'elemento `/opt/java/jre/lib/rt.jar` sotto "JRE system libraries:", quindi scegliere "Javadoc Location...".
4. Compilare il campo "Javadoc location path:" con "http://java.sun.com/javase/6/docs/api/".

### Versione offline

Se non si vuole utilizzare la documentazione online la si può memorizzare localmente.

1. Scaricare "Java SE 6 Documentation" dal sito http://java.sun.com/javase/downloads/index.jsp
2. Seguire le istruzioni per il download del file "jdk-6-doc.zip".
3. Andare su Window/Preferences, quindi scegliere Java/Installed JREs.
4. Ce ne dovrebbe essere uno chiamato "java" con il tipo "Standard VM". Selezionarlo e scegliere Edit.
5. Selezionare l'elemento `/opt/java/jre/lib/rt.jar` sotto a "JRE system libraries:", quindi scegliere "Javadoc Location...".
6. Selezionare la voce "Javadoc in archive"
7. Compilare il campo "Archive path:" con il percorso del file scaricato precedentemente.

## Risoluzione dei problemi

### Crash di autocompletamento e javadoc render

Per qualche motivo, libxul potrebbe crashare. Per ovviare al problema, si può provare ad installare libwebkit[broken link: replaced by webkitgtk2] e aggiungere le seguenti linee al proprio file `/usr/share/eclipse/eclipse.ini`:

    -Dorg.eclipse.swt.browser.UseWebKitGTK=true

Se questo non funziona (o non si desidera utilizzare libwebkit) si può tentare un'altra soluzione:

  1. Scaricare http://releases.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.0.11/runtimes/xulrunner-1.9.0.11.en-US.linux-i686.tar.bz2
  2. Decomprimerlo in /home/<Username>/.xulrunner (o in un'altra destinazione a piacere)
  3. Aggiungere questa linea al file di configurazione di Eclipse `/usr/share/eclipse/eclipse.ini`:

    -Dorg.eclipse.swt.browser.XULRunnerPath=/home/<Username>/.xulrunner

  A questo punto il prroblema dovrebbe essere risolto.

### Crash al primo avvio o scegliendo "Help -> Welcome"

Seguire le istruzioni sopra.

Category:

- Development (Italiano)

Hidden category:

- Pages with broken package links