# &appname;-Handbuch V&manversion;

## Einführung

Der &app;-Assistent hilft Ihnen Schritt für Schritt dabei, einen Fehlerbericht zu erstellen und abzuschicken. Der auf diese Weise erzeugte Fehlerbericht enthält alle notwendigen Informationen, um einen aufgetretenen Fehler reproduzieren und beheben zu können.

## Erste Schritte

### &appname; starten

Sie können &app; auf eine der folgenden Weisen starten:

Befehlszeile

- Führen Sie folgenden Befehl aus: `bug-buddy`

Dateimanager-Fenster

- Doppelklicken Sie auf eine Core-Datei.

Absturzdialogfeld

- Wählen Sie die Option Einen Fehlerbericht senden.

### Beim Start der &app;-Anwendung

Wenn Sie die &app;-Anwendung starten, wird folgendes Fenster angezeigt:

#### &appname;-Fenster

Zeigt das Bug Buddy-Fenster.

Das &app;-Fenster enthält verschiedene Seiten, auf denen Sie Informationen für den Fehlerbericht eintragen können. Auf der ersten Seite wird eine Begrüßung angezeigt.

Das &app;-Fenster enthält die folgenden Schaltflächen:

Info

- Öffnet das Info-Dialogfeld zu &appname;, aus dem Sie Versions-, Copyright- und Entwicklerangaben entnehmen können.

Abbrechen

- Diese Schaltfläche löst eine Bestätigungsabfrage aus, bei der Sie folgende Wahlmöglichkeiten haben:

  - Klicken Sie auf Nein, um am aktuellen Fehlerbericht weiterzuarbeiten.

  - Klicken Sie auf Ja, um den aktuellen Fehlerbericht zu verwerfen und &app; zu beenden.

Zurück

- Springt zur vorhergehenden &app;-Seite.

Weiter

- Springt zur nächsten &app;-Seite.

## Verwendung

Der Ablauf beim Erzeugen und Abschicken eines Fehlerberichts gliedert sich wie folgt:

1. Einstellen der Fehlerdiagnoseoptionen

2. Eingabe der Fehlerbeschreibung

3. Eingabe der E-Mail-Konfigurationsangaben

4. Bestätigen der Angaben im Fehlerbericht

5. Abschicken des Fehlerberichts

### So stellen Sie die Fehlerdiagnoseoptionen ein

#### Einblenden/Ausblenden der Fehlerdiagnoseoptionen

Wenn Sie die Fehlerdiagnoseoptionen anzeigen lassen möchten, klicken Sie auf der Seite Willkommen bei &appname; auf die Schaltfläche Fehlerdiagnoseoptionen anzeigen.

Um die Fehlerdiagnoseoptionen auszublenden, klicken Sie auf der Seite Willkommen bei &appname; auf die Schaltfläche Fehlerdiagnoseoptionen verbergen.

#### So entfernen sie Fehlerdiagnoseinformationen aus einem Fehlerbericht

&app; nimmt automatisch folgende Fehlerdiagnoseinformationen in den Fehlerbericht auf:

Core-Datei

- Eine Core-Datei ist ein Abbild der Daten, die zum Fehlerzeitpunkt im Core-Speicher des Rechners enthalten waren.

Funktionsprotokoll (Backtrace)

- In einem Funktionsprotokoll ist die aktuelle von einer Anwendung aufgerufene Funktionshierarchie in Klartext beschrieben.

Wenn Sie nicht möchten, dass Fehlerdiagnoseinformationen im Fehlerbericht erscheinen, wählen Sie einfach die Option nichts aus der Dropdown-Liste Fehlerdiagnose aus.

#### So nehmen Sie eine Core-Datei in den Fehlerbericht auf

Um manuell eine Core-Datei in den Fehlerbericht aufzunehmen, gehen Sie wie folgt vor:

1. Wählen Sie aus der Dropdown-Liste Fehlerdiagnose die Option Core-Datei.

2. Geben Sie im Feld Core-Datei den Namen der Core-Datei ein. Mit der Schaltfläche Durchsuchen können Sie auch nach der Core-Datei suchen.

3. Klicken Sie auf Starten, um den Fehlerdiagnosevorgang für die angegebene Core-Datei zu starten.

   Um den Fehlerdiagnosevorgang anzuhalten, klicken Sie auf Stopp.

#### So nehmen Sie ein Funktionsprotokoll in den Fehlerbericht auf

Um manuell ein Funktionsprotokoll der abgestürzten Anwendung in den Fehlerbericht aufzunehmen, gehen Sie wie folgt vor:

1. Wählen Sie aus der Dropdown-Liste Fehlerdiagnose die Option Abgestürztes Programm.

2. Geben Sie im Feld Programmdatei den Namen der Programmdatei der betreffenden Anwendung ein. Alternativ dazu können Sie auch mit der Durchsuchen-Schaltfläche nach der Programmdatei der Anwendung suchen.

   Der Name der Programmdatei der Anwendung entspricht dem Befehl, mit dem Sie die betreffende Anwendung von der Befehlszeile aus starten.

3. Geben Sie im Feld Prozesskennung die PID (Process Identifier) der Anwendung ein. Zur Feststellung des PID-Werts können Sie beispielsweise die Anwendung Systemüberwachung verwenden.

4. Klicken Sie auf Starten, um den Fehlerdiagnosevorgang für die angegebene Programmdatei zu starten.

   Um den Fehlerdiagnosevorgang anzuhalten, klicken Sie auf Stopp.

#### So kopieren Sie Fehlerdiagnoseinformationen in die Zwischenablage

Zum Kopieren von Fehlerdiagnoseinformationen in die Zwischenablage klicken Sie auf Kopieren.

#### So speichern Sie Fehlerdiagnoseinformationen in eine Datei

Um die Fehlerdiagnoseinformationen in eine Datei zu speichern, klicken Sie auf Speichern.

### So geben Sie die Fehlerbeschreibung ein

Klicken Sie auf der Seite Willkommen bei &appname; auf Weiter, um zur Seite Fehlerbeschreibung zu gelangen.

Geben Sie dort folgende Informationen ein:

Zusammenfassung

- Geben Sie einen kurzen Satz ein, der das Problem klar und präzise zusammenfasst. Diese Zusammenfassung erscheint später im Betreff der Fehlerberichts-E-Mail.

Description of Problem

- Geben Sie eine Beschreibung des aufgetretenen Problems ein. Hierzu gehören auch eventuell aufgetretene Fehler- und Warnmeldungen.

Steps to reproduce the problem

- Geben Sie hier in kurzen Sätzen Schritt für Schritt an, was genau Sie getan haben, bevor der Fehler auftrat.

Actual Results

- Geben Sie hier ein, was genau passiert, wenn Sie die unter Steps to reproduce the problem beschriebenen Schritte ausführen.

Expected Results

- Geben Sie hier ein, was stattdessen korrekterweise geschehen sollte.

How often does this happen

- Beschreiben Sie hier, wie oft das Problem auftritt, wenn Sie die zuvor erfassten Fehlerduplizierungsschritte ausführen.

Additional Information

- Hier haben Sie Platz für zusätzliche Informationen, die den Entwicklern weiterhelfen könnten. Beispiel:

  - Der genaue Wortlaut der angezeigten Fehlermeldungen

  - Name und Version Ihres Fenstermanagers

  - Alternative Vorgehensweisen, die ebenfalls zum ursprünglich beabsichtigten Ziel führen und bei denen der Fehler nicht auftritt

  - Ggf. Verweise auf ein relevantes Bildschirmfoto

    Fügen Sie bitte keine Bildschirmfotos als Anlagen an &app;-Fehlerberichte an. Der Entwickler kann sich erforderlichenfalls immer noch später an Sie wenden und Sie um ein entsprechendes Bildschirmfoto bitten.

  - Beispieldateien, die sich nicht korrekt oder überhaupt nicht laden lassen

  - Ggf. Vermutungen zur Ursache des Problems und Lösungsvorschläge

### So geben Sie die E-Mail-Konfigurationsangaben ein

Klicken Sie auf der Seite Fehlerbeschreibung auf Weiter, um zur Seite E-Mail-Konfiguration zu gelangen.

Geben Sie dort folgende Informationen ein:

Name

- Geben Sie Ihren vollständigen Namen ein.

E-Mail

- Geben Sie Ihre E-Mail-Adresse ein.

  Auf diese Weise kann der Entwickler mit Ihnen in Kontakt treten, wenn er weitere Informationen benötigt oder es eine Problemlösung gibt.

### So bestätigen Sie die Angaben im Fehlerbericht

Klicken Sie auf der Seite E-Mail-Konfiguration auf Weiter, um zur Seite Bestätigung zu gelangen.

&app; zeigt Ihnen nun noch einmal den Fehlerbericht im Detail an. Sie können an dieser Stelle ggf. noch erforderliche Änderungen vornehmen.

### So schicken Sie den Fehlerbericht ab

Um den Fehlerbericht abzuschicken, klicken Sie auf der Seite Bestätigung auf Bericht abschicken. Es erscheint eine Bestätigungsabfrage. Klicken Sie auf Abschicken, um den Fehlerbericht endgültig abzuschicken.

&app; zeigt die Seite Vorgang abgeschlossen an. Dies bedeutet, dass der Fehlerbericht erfolgreich abgeschickt wurde. Klicken Sie auf Schließen, um das &app;-Fenster zu schließen.