Einen Softwarefehler auf dem Mac mit Schritt-für-Schritt-Screenshots dokumentieren

Diese Anleitung zeigt, wie du für einen reproduzierbaren Softwarefehler Screenshot-Nachweise sammelst. Du erfasst die Umgebung, definierst erwartetes und tatsächliches Ergebnis, nimmst die erforderlichen Aktionen auf, bereinigst die Nachweise und prüfst den Bericht vor dem Senden noch einmal.

Kurz gesagt: Ein hilfreicher Fehlerbericht verbindet einen klaren Ausgangszustand, genaue Reproduktionsschritte, erwartetes und tatsächliches Ergebnis, Häufigkeit, Umgebungsangaben und einen Nachweis des ersten sichtbaren Fehlers.

Zuerst die Umgebung erfassen

Die Umgebung zeigt dem Prüfer, unter welchen Bedingungen der Fehler auftritt. Erfasse App-Version, macOS-Version, Gerätetyp, Konto- oder Berechtigungszustand und jede Einstellung, die das Verhalten verändert.

Die Angaben müssen genau genug sein, um die Bedingungen nachzustellen. „Neueste Version“ wird nach der nächsten Veröffentlichung unklar. „Shotomatic 1.8.2 unter macOS 15.5“ bleibt später verständlich.

Erfasse bei Bedarf:

• App- und Build-Version
• macOS-Version
• Mac-Modell oder Prozessorarchitektur
• Kontotyp oder Tarif
• Browser und Browserversion
• angeschlossenen Bildschirm oder Eingabegerät
• relevante Berechtigungen und Funktionseinstellungen
• Netzwerkzustand

Erwartetes und tatsächliches Ergebnis nennen

Das Ergebnispaar beschreibt das Problem, bevor der Prüfer die Schritte liest. Schreibe einen Satz dazu, was geschehen sollte, und einen dazu, was stattdessen geschieht.

Nutze beobachtbare Ergebnisse statt einer Diagnose. „Die Schaltfläche für den PDF-Export reagiert nicht“ ist ein Nachweis. „Der Exportdienst ist defekt“ setzt eine unbestätigte Ursache voraus.

Zum Beispiel:

Erwartet: Nach Auswahl von „PDF exportieren“ öffnet sich ein Speicherdialog.

Tatsächlich: Nach Auswahl von „PDF exportieren“ schließt sich das Menü. Es erscheint kein Speicherdialog und es wird keine Datei erstellt.

Ergänze die Häufigkeit beim Ergebnis. Gib an, ob das Problem jedes Mal, gelegentlich oder nur nach einer bestimmten vorherigen Aktion auftritt.

Von einem bekannten Ausgangspunkt reproduzieren

Ein bekannter Ausgangspunkt entfernt versteckte Voraussetzungen aus dem Bericht. Schließe und öffne die App, erstelle frische Testdaten oder setze die betreffende Einstellung zurück, bevor du die Folge aufnimmst.

Bestätige den Fehler einmal aus diesem Zustand, bevor du ihn dokumentierst. Wenn das Problem nicht mehr auftritt, halte die Änderung fest, statt aus der Erinnerung selbstsichere Schritte zu formulieren.

Einen Screenshot pro erforderlicher Aktion aufnehmen

Jeder Screenshot sollte dem Prüfer helfen, die nächste Aktion zu wiederholen oder den Fehler zu erkennen. Nimm Ausgangszustand, jeden erforderlichen Klick oder jede Eingabe, den ersten falschen Zustand und jede Fehlermeldung auf, die für die Diagnose relevant ist.

Lass Aktionen weg, die das Ergebnis nicht beeinflussen. Ein Fenster zu verschieben oder ein nicht benötigtes Feld zu öffnen erzeugt nur Rauschen, solange diese Aktion den Fehler nicht auslöst.

Wenn du Action Capture verwendest, beginne im sauberen Zustand und reproduziere das Problem in normalem Tempo. Shotomatic speichert den Zielzustand unmittelbar vor jedem akzeptierten Klick und markiert die Klickstelle. Die aufgenommene Folge ist damit eine erste Fassung der Reproduktionsschritte. Free-Sessions unterstützen fünf gespeicherte Schritte, Pro hebt das Schrittlängelimit auf.

Zustandsänderungen mit Text erklären

Kurzer Text sollte erklären, was der Screenshot allein nicht zeigen kann. Nenne das Bedienelement und den einzugebenden Wert und beschreibe den erwarteten Übergang nach der Aktion.

Schreibe Schritte in dieser Form:

1. Aktion: PDF exportieren auswählen.
2. Erwarteter Kontrollpunkt: Ein Speicherdialog wird geöffnet.
3. Beobachtetes Ergebnis: Das Menü schließt sich, aber es erscheint kein Dialog.

Vermeide Text, der nur eine sichtbare Markierung wiederholt, etwa „Hier klicken“. Die Klickmarkierung zeigt bereits den Ort. Der Satz sollte das Bedienelement benennen und sagen, worauf der Prüfer anschließend achten muss.

Private Informationen schützen

Private Angaben sollten entfernt werden, bevor der Bericht die Testumgebung verlässt. Nutze möglichst Beispielkonten und Testdaten. Die Quelldaten zu ersetzen ist sicherer, als sie später abzudecken.

Sind echte Daten unvermeidbar, schneide unwichtige Bereiche ab und zeichne Namen, E-Mail-Adressen, Nachrichten, Tokens, Lizenzangaben, Kundendatensätze und Benachrichtigungsvorschauen weich. Lass genug umgebende Oberfläche sichtbar, damit der Prüfer den Bildschirm erkennt.

Führe eine eigene Schwärzungsprüfung durch, um zwischen Zuschnitt, Weichzeichnung und Testdaten zu entscheiden.

Diese Struktur für Fehlerberichte verwenden

Die folgende Struktur hält den Bericht vollständig, ohne daraus eine lange Erzählung zu machen:

Titel:

Umgebung:
- App-/Build-Version:
- macOS/Gerät:
- Konto- oder Berechtigungszustand:
- Relevante Einstellungen:

Erwartetes Ergebnis:

Tatsächliches Ergebnis:

Häufigkeit:

Voraussetzungen:

Schritte zur Reproduktion:
1.
2.
3.

Nachweise:
- Screenshot für jede erforderliche Aktion
- Erster sichtbarer Fehler
- Fehlermeldung oder Log, falls relevant

Behelf:

Weitere Hinweise:

Das ist eine Schreibstruktur und keine importierbare Shotomatic-Vorlage. Kopiere sie in den Issue-Tracker oder das Supportsystem, das dein Team bereits nutzt.

Den Bericht vor dem Senden testen

Ein letzter Reproduktionslauf deckt fehlende Voraussetzungen auf. Beginne mit der im Bericht genannten Umgebung und folge ausschließlich den geschriebenen Schritten, ohne dich auf dein Gedächtnis zu verlassen.

Der Bericht ist fertig, wenn dieselbe Folge zum beschriebenen Ergebnis führt, jeder erforderliche Wert vorhanden ist und die Screenshots den richtigen Bildschirm in der richtigen Reihenfolge zeigen. Hängt ein Schritt von Timing oder Bewegung ab, ergänze eine kurze Aufnahme als Nachweis. Die geschriebene Folge bleibt die wichtigste Referenz.

Action Capture kann die Klickfolge sammeln. Der Bericht braucht trotzdem Umgebung, erwartetes und tatsächliches Ergebnis sowie Häufigkeit. Den allgemeinen Ablauf für Aufnahme und Bearbeitung erklärt Schritt-für-Schritt-Anleitung aus Klicks auf dem Mac erstellen.