# Iniziare ad usare &kdevelop;

Come iniziare ad usare &kdevelop; dopo averlo installato? Siccome è una applicazione complessa, se l'utente non ha mai usato questo tipo di ambiente di sviluppo integrato, la curva di apprendimento potrebbe risultare piuttosto drastica.

Si cercherà di ammorbidirla analizzando una semplice applicazione C++ per KDE. Si effettuerà una (rapida) panoramica su:

- Come si presenta l'IDE &kdevelop;.
- Configurazione iniziale
- Come creare un nuovo progetto
- Come lavorare con i documenti
- Come compilare una applicazione in un progetto
- Come aggiungere classi e altri dettagli al progetto
- Come si effettua il debug di una applicazione
- Alcuni strumenti per costruire la documentazione del programma o la documentazione utente.

## Un primo sguardo a &kdevelop;

### In superficie

Quando si avvia &kdevelop; per la prima volta, verrà visualizzata una schermata simile a questa:

Aspetto iniziale di &kdevelop;

### Area di lavoro e linguette degli strumenti

Inizialmente &kdevelop; userà la cosiddetta interfaccia utente IDEAl, dove l'area di lavoro ha la massima dimensione possibile ed è circondata a sinistra, destra e in basso da vari pulsanti simili a linguette. Facendo clic su una di queste linguette verrà aperta una cosiddetta vista strumenti che permette di svolgere un particolare compito.

### Menu e barre degli strumenti

In alto è presente la normale barra dei menu e diverse barre degli strumenti, alcune inizialmente vuote. Verranno riempite quando si aprirà un progetto.

### Barra di stato

Infine è presente nella parte bassa della finestra una barra di stato che fornisce brevi informazioni su vari compiti.

### Come ricevere aiuto

Oltre al menu Aiuto, che fornisce supporto per questioni specifiche, si possono ottenere alcune brevi informazioni dalla barra di stato e da due tipi di aiuto.

### Cosa fa questa voce di menu?

Quando si posiziona il cursore sopra una voce di menu verrà generalmente visualizzata una breve informazione nella barra di stato. In molti casi ripeterà il nome della selezione, mentre in alcuni altri saranno fornite ulteriori informazioni sullo scopo del comando del menu.

### Qual è il nome di questo elemento?

Quando si posiziona il cursore su un elemento, verrà visualizzato per qualche secondo un aiuto contenente il suo nome. É utile per orientarsi velocemente nella barra degli strumenti o nelle viste strumenti della modalità IDEAl quando è stata impostata la sola visualizzazione delle icone.

### Cosa fa questo elemento?

Per molti elementi dell'IDE sono disponibili ulteriori informazioni attraverso gli aiuti estesi. Selezionare Aiuto Che cos'è? o premere &Shift;F1 e selezionare l'elemento con il cursore, che verrà visualizzato con un punto interrogativo. Con questo metodo si possono anche aprire i menu e fare clic su una voce specifica (sia attiva che disattivata) per visualizzare le eventuali informazioni aggiuntive.

### Cosa è presente nei menu

Ci sono dieci menu selezionabili nella barra dei menu. La maggior parte di essi viene riempita quando è stato caricato un progetto, mentre altri quando viene aperto almeno un documento. In breve, essi permettono i seguenti tipi di azioni.

File

- ### Azioni comuni

  Queste azioni sono molto standard. Permettono di creare, aprire, salvare, stampare, chiudere i file e uscire dall'applicazione &kdevelop;.

  ### Annulla le modifiche

  Permette di annullare le modifiche ricaricando i contenuti originali del file.

Modifica

- Questo menu è utile solo se è presente un documento aperto.

  ### Azioni comuni

  Fornisce le normali azioni annulla/rifai e taglia/copia/incolla, oltre a permettere di selezionare blocchi di testo in vari modi.

  ### Trova e Sostituisci

  Nel menu Modifica è presente uno strumento per le ricerche molto potente. In aggiunta alle normali azioni di ricerca e sostituzione limitate al documento aperto può anche effettuare ricerche e sostituzioni globali che vengono effettuate su tutti i file del progetto.

  ### Modifica avanzata del testo

  In futuro sarà possibile riformattare il documento e completare automaticamente le parti di testo incomplete in vari modi.

Visualizza

- Come il menu Modifica, questo menu è utile solo quando è presente un documento aperto: saranno disponibili (assieme ad altre) le seguenti azioni:

  ### Cronologia

  Permette di muoversi avanti e indietro attraverso i vari documenti visitati

  ### Traccia degli errori

  Naviga tra le linee di codice che contengono errori rilevati durante l'ultimo processo di compilazione.

  ### Gestione degli strumenti di vista

  Seleziona o nasconde gli strumenti di vista

  ### Azioni relative all'editor

  Alcune voci del menu Visualizza controllano l'aspetto dell'editor in uso. Nel caso del componente &kate; (editor avanzato incorporato) saranno disponibili i seguenti comandi:

  - Controllo del ritorno a capo automatico nella finestra del documento.

  - Mostrare o nascondere diversi bordi della finestra del documento: numeri di linea, icone e contrassegni.

  - Controllo della visualizzazione delle sezioni annidate (temporaneamente nascoste) nel codice sorgente.

Progetto

- Tutto il lavoro in &kdevelop; si basa sui progetti, che raccolgono file di codice sorgente, file per la gestione della compilazione e altre informazioni in una directory . In questo menu si può controllare quale progetto usare, le sue proprietà e altre azioni relative alla sua gestione. In particolare:

  ### Apri Progetto

  Permette di creare nuovi progetti, aprirne di nuovi e importare progetti di altri ambienti.

  ### Opzioni progetto

  Permette di definire un insieme di varie proprietà del progetto

  ### Gestione delle classi

  Aggiunge nuove classi al progetto e permette di attraversare l'albero di ereditarità di una classe.

  ### Distribuzione del progetto

  Aiuta a costruire pacchetti di distribuzione del progetto.

Compila

- Questo menu è dedicato alla compilazione e alla documentazione del progetto. Si può quindi usare quando è presente un progetto aperto. Fornisce le seguenti azioni:

  ### Compilare, effettuare il link, eseguire

  Permette di compilare ed effettuare il link dell'intero progetto o parti di esso ed eseguire l'applicazione dall'interno dell'IDE.

  ### Preparazione alla compilazione

  Queste operazioni dipendono dal sistema make usato per il progetto. Nel caso di progetti automake, esse permettono di eseguire `Makefile.cvs` e `configure`.

  ### Installare l'applicazione

  Permette di installare l'applicazione sia nelle directory locali che nelle directory di sistema accessibili solo all'utente root.

  ### Documentazione API

  Costruisce o rimuove la documentazione API del progetto basata su doxygen in base alle opzioni del progetto

Debug

- Anche se questo menu viene riempito una volta che un progetto è aperto, è ovviamente utile solo se il progetto è stato precedentemente compilato con le informazioni di debug (può essere impostato in Progetto Opzioni progetto.... Sono presenti le seguenti azioni:

  ### Azioni normali del debugger

  La prima parte del menu Debug costituisce una interfaccia grafica al debugger &GNU; GDB. Permette di avviare e interrompere l'applicazione nel debugger e procedere in diverse modalità passo-per-passo.

  ### Breakpoint

  &kdevelop; permette di impostare i breakpoint (punti di interruzione) in diversi modi nei sorgenti dell'applicazione. Uno viene effettuato usando la voce Attiva/disattiva breakpoint.

  ### Debug avanzato

  Le altre voci del menu Debug compiono analisi più sofisticate. Usare &Shift;F1 per ottenere ulteriori informazioni sul loro funzionamento.

Finestra

- È un menu piuttosto standard. Si possono selezionare varie finestre aperte e chiudere una o più finestre contenenti documenti. Si può anche selezionare un gruppo di finestre da chiudere in un colpo solo.

Strumenti

- &kdevelop; è altamente configurabile. Si può selezionare il proprio editor preferito per i documenti e fornire plugin esterni per estendere le capacità di base dell'IDE. Il menu Strumenti controlla tutte queste impostazioni.

  ### Editing avanzato

  La parte alta del menu Strumenti viene fornita del plugin dell'editor in uso. Si può selezionare l'editor preferito in Impostazioni Configura KDevelop Editor. Quando è stato selezionato un documento, questa porzione del menu visualizzerà i comandi di editing specifici del componente editor usato.

  ### Gestione pagine web

  Se la finestra del documento attivo contiene una pagina HTML (⪚ visualizzata selezionando la Documentazione), il menu Strumenti visualizzerà ulteriori voci per la gestione delle pagine Web.

  ### Altri strumenti

  Normalmente saranno presenti molte altre voci a seconda degli strumenti disponibili. Usare &Shift;F1 per ottenere ulteriori infomazioni.

Impostazioni

Aiuto

## Un po' di configurazione

(--- da scrivere ---)

## Come iniziare un nuovo progetto — la procedura guidata per le applicazioni

(--- da scrivere ---)

## Lavorare con i documenti

(--- da scrivere ---)

### Come automatizzare alcune battiture

(--- da scrivere ---)

## Come compilare un progetto

(--- da scrivere ---)

### Cosa indicano i messaggi

(--- da scrivere ---)

## Come estendere un progetto — il gestore Automake

(--- da scrivere ---)

### Una rapida occhiata al meccanismo di Automake

(--- da scrivere ---)

### Come inserire le icone in una directory separata

(--- da scrivere ---)

### Come aggiungere nuove classi

(--- da scrivere ---)

Fare attenzione quando si decide i nomi dei file delle classi. È molto difficile modificarli in seguito.

### Cosa c'è in un sottoprogetto?

(--- da scrivere ---)

#### Concentrare il lavoro — il target attivo

(--- da scrivere ---)

### Alcune operazioni per ristrutturare un progetto

(--- da scrivere ---)

## Come effettuare il debug

(--- da scrivere ---)

## Note sulla documentazione

(--- da scrivere ---)