# Manuale di &appname; V&manversion;

## Introduzione

La procedura guidata di &app; spiega in dettaglio come creare e inviare una notifica di errore. La notifica di errore deve contenere tutte le informazioni necessarie per riprodurre e correggere il problema.

## Per iniziare

### Avviare &appname;

Per avviare &app; sono disponibili i seguenti metodi:

Riga di comando

- Eseguire il comando seguente: `bug-buddy`

Finestra del File manager

- Fare doppio clic su un file core.

Finestra di dialogo del crash

- Selezionare l'opzione Crea una nuova notifica d'errore.

### Avvio di &appname;

All'avvio di &app; viene visualizzata la finestra seguente.

#### Finestra di &appname;

Mostra la finestra di Bug Buddy.

La finestra di &app; presenta alcune pagine in cui è possibile inserire le informazioni sull'errore. La prima pagina contiene un messaggio di benvenuto.

La finestra di &app; contiene i seguenti pulsanti:

Informazioni

- Mostra la finestra di dialogo Informazioni su &appname;, che contiene il numero di versione, l'informativa di copyright e i nomi degli sviluppatori di &app;.

Annulla

- Mostra una richiesta di conferma:

  - Fare clic su No per tornare alla notifica d'errore.

  - Fare clic su Sì per annullare la notifica d'errore e uscire da &app;.

Indietro

- Mostra la pagina precedente di &app;.

Avanti

- Mostra la pagina successiva di &app;.

## Uso

Per creare e inviare una notifica d'errore, procedere come segue:

1. Impostare le opzioni di debug

2. Inserire la descrizione dell'errore

3. Inserire le informazioni di configurazione della posta

4. Confermare il contenuto della notifica d'errore

5. Inviare la notifica d'errore

### Impostare le opzioni di debug

#### Mostrare o nascondere le opzioni di debug

Per visualizzare le opzioni di debug, fare clic sul pulsante Mostra informazioni di debug nella pagina Benvenuto in &appname;.

Per nascondere le opzioni di debug, fare clic sul pulsante Nascondi informazioni di debug nella pagina Benvenuto in &appname;.

#### Rimuovere informazioni di debug dalla notifica d'errore

&app; aggiunge automaticamente i seguenti tipi di informazioni di debug alla notifica d'errore:

file core

- Il file core contiene una copia dei dati memorizzati nella memoria interna del computer.

backtrace

- Il backtrace contiene una rappresentazione dettagliata in formato testo della gerarchia di funzioni chiamate da un'applicazione.

Se non si intende inserire queste informazioni di debug nella notifica d'errore, selezionare niente nella casella di riepilogo Debug.

#### Allegare un file core alla notifica d'errore

Per allegare manualmente un file core alla notifica d'errore, procedere come segue:

1. Selezionare File core nella casella di riepilogo Debug.

2. Inserire il nome del file core nel campo corrispondente. In alternativa, per ricercare il file core, fare clic su Sfoglia.

3. Fare clic sul pulsante Avvia per eseguire il debug del file core specificato.

   Per annullare il processo di debug, fare clic sul pulsante Stop.

#### Allegare un backtrace alla notifica d'errore

Per allegare manualmente alla notifica d'errore un backtrace per l'applicazione interrotta, procedere come segue:

1. Selezionare applicazione che è andata in crash nella casella di riepilogo Debug.

2. Inserire il nome del file binario dell'applicazione nel campo File binario. In alternativa, per ricercare il file binario dell'applicazione, fare clic su Sfoglia.

   Il nome del file binario corrisponde al comando da digitare sulla riga di comando per avviare l'applicazione.

3. Inserire l'identificativo del processo (pid) nel campo ID del processo. Per conoscere l'identificativo del processo è possibile usare l'applicazione Monitor di sistema.

4. Fare clic sul pulsante Avvia per iniziare il debug del file binario specificato.

   Per annullare il processo di debug, fare clic sul pulsante Stop.

#### Copiare le informazioni di debug negli appunti

Per copiare le informazioni di debug negli appunti, fare clic su Copia.

#### Salvare le informazioni di debug in un file

Per salvare le informazioni di debug in un file, fare clic su Salva.

### Inserire la descrizione dell'errore

Per visualizzare la pagina Descrizione dell'errore, fare clic su Avanti nella pagina di benvenuto.

Nella pagina Descrizione dell'errore, inserire le seguenti informazioni:

Summary

- Inserire una descrizione sintetica del problema. Il testo di questo campo viene copiato nell'intestazione Oggetto della notifica d'errore inviata.

Description of Problem

- Inserire una descrizione del problema. Includere anche gli eventuali avvertimenti o messaggi di errore.

Steps to reproduce the problem

- Usando una forma concisa, inserire l'esatta descrizione delle operazioni eseguite per produrre l'errore.

Actual Results

- Descrivere ciò che accade quando si eseguono le operazioni indicate nella sezione che indica come riprodurre il problema.

Expected Results

- Descrivere ciò che dovrebbe accadere quando si eseguono le operazioni indicate nella sezione che indica come riprodurre il problema.

How often does this happen

- Indicare la frequenza con cui il problema si verifica dopo aver eseguito le operazioni descritte.

Additional Information

- Inserire eventuali informazioni aggiuntive che possano essere utili agli sviluppatori. Ad esempio:

  - Una copia esatta dei messaggi di errore

  - Il nome e il numero di versione del gestore di finestre

  - Metodi alternativi per eseguire l'operazione richiesta senza generare lo stesso errore

  - Un riferimento a un'immagine rilevante, se disponibile

    Non allegare direttamente le immagini alle notifiche di &app;. Se necessario, gli sviluppatori potranno contattare direttamente l'utente per richiedere un'immagine che descriva il problema.

  - I file che non vengono caricati o che non vengono caricati correttamente

  - Eventuali suggerimenti sulle possibili cause del problema o sulle possibili soluzioni

### Inserire informazioni di configurazione della posta

Per visualizzare la pagina Configurazione della posta, fare clic su Avanti nella pagina Descrizione dell'errore.

Nella pagina Configurazione della posta, inserire le seguenti informazioni:

Nome

- Inserire il proprio nome e cognome.

Indirizzo email

- Inserire il proprio indirizzo di posta elettronica.

  Questo consentirà agli sviluppatori di contattare l'utente per richiedere ulteriori informazioni o per comunicare una possibile soluzione del problema.

### Confermare le informazioni della notifica d'errore

Per visualizzare la pagina Conferma, fare clic su Avanti nella pagina Configurazione della posta.

&app; mostra il contenuto della notifica d'errore. In questa pagina è possibile apportare eventuali modifiche alle informazioni inserite.

### Inviare la notifica d'errore

Per inviare la notifica d'errore, fare clic sul pulsante Invia notifica nella pagina Conferma. Viene visualizzata una richiesta di conferma. Fare clic su Invia per confermare l'invio della notifica.

&app; mostra la pagina Finito, per indicare che la notifica d'errore è stata inviata. Fare clic su Chiudi per chiudere la finestra di &app;.