Freigeben über


Wann und wie sollte ich einen Fehlerbericht speichern?

Tipp

Verwenden Sie das Menüelement Problem melden in Visual Studio. Dadurch werden Diagnoseinformationen zusammen mit Ihrem Fehlerbericht gesendet, um das Problem zu beheben.

Es gibt ausführliche Anweisungen für Visual Studio 2019 oder Visual Studio 2017 und Visual Studio für Mac.

Sie können auf der Visual Studio-Entwicklercommunity-Website nach vorhandenen Berichten suchen.

Datei einen Fehler, wenn...

Sie haben eine Reihe von Schritten, von denen Sie glauben, dass die Ingenieure in der Lage sein werden, ein Problem zu reproduzieren.

oder

Sie können die sichtbaren Symptome des Problems sorgfältig beschreiben, insbesondere, wenn Sie auch einige genaue Umstände im Zusammenhang mit dem Problem beschreiben können. [1]

Bewährte Methoden zur schnellen und effizienten Behebung von Fehlern

  1. Durchsuchen Sie Visual Studio Entwicklercommunity und das Web nach vorhandenen Fehlerberichten oder Verwendungsvorschlägen, die das Problem möglicherweise direkt beheben.[2][3]

  2. Beschreiben Sie das Problem so klar und präzise wie möglich, einschließlich einer Beschreibung, was passiert ist und was erwartet wurde.

  3. Fügen Sie alle relevanten Stapelablaufverfolgungen, Fehlermeldungen oder Absturzprotokolle hinzu (wenn Sie das Feature Problem melden verwenden, können diese automatisch eingeschlossen werden). [4]

  4. Notieren Sie sich alle wichtigen Fehlermeldungen, die in Screenshotanlagen angezeigt werden, auch als Nur-Text.

  5. Fügen Sie einen kleinen, eigenständigen Testfall hinzu, der den Fehler mit so wenig Code wie möglich reproduziert. Wenn Sie das Problem nicht mit einem brandneuen Projekt reproduzieren können (das mit einer der integrierten Vorlagen erstellt wurde), zippen Sie ein Projekt, das das Problem veranschaulicht, und fügen Sie es an den Fehlerbericht an. Machen Sie das Beispielprojekt so einfach wie möglich, bevor Sie es anfügen. [5][6]

  6. Beschreiben Sie die Umgebung, in der der Fehler aufgetreten ist, einschließlich des Betriebssystems und der Versionen von Xamarin und aller Abhängigkeiten.

Zusätzliche Details

  1. ^ Idealerweise sollte die Beschreibung der "sichtbaren Symptome" genügend Details enthalten, damit andere Kunden bestätigen können, ob sie dasselbe Problem sehen (gleiche Fehlermeldungen, gleiche Leistungsbeeinträchtigung, gleiche Stapelverfolgung nach einem Absturz usw.). Für "präzise Umstände" wäre ein gutes Beispiel, wenn Sie etwas sagen können wie: "Normalerweise treffe ich das Problem zu 75% der Zeit, aber wenn ich diese eine Sache ändere, dann kann ich das Problem vollständig vermeiden." Ein weiteres ähnliches Beispiel für einen "präzisen Umstand" ist, wenn das Downgrade auf eine frühere Version von Xamarin das Problem beendet.

  2. ^ Wie zu erwarten, sind Codeausschnitte mit Fehlertext (oder ein anderer eindeutig beschreibender Text) in der Regel die besten Suchbegriffe. Wenn der vorhandene Fehlerbericht unvollständig ist, können Sie gerne Details hinzufügen oder einen neuen, besseren Fehlerbericht erstellen.

  3. ^ Eine weitere gute Frage ist, ob dasselbe Problem für alle Java-, Objective-Coder Swift-Apps gemeldet wurde. Wenn ja, dann ist das Problem sehr wahrscheinlich Teil von Android oder iOS selbst und nicht Teil von Xamarin.

  4. ^ Einige Beispiele für Informationen:

    1. Bei Fehlern, die beim Erstellen eines Projekts auftreten, fügen Sie die vollständige Diagnosebuildausgabe in den Fehlerbericht ein.

    2. Bei Fehlern, die beim Erstellen oder Debuggen eines iOS-Projekts in Visual Studio auftreten, führen > Sie hilfe Xamarin > Zip-Protokolle aus, nachdem Sie den Fehler erreicht haben, und fügen Sie die resultierende .zip-Datei in den Fehlerbericht ein.

    3. Für Ausnahmen oder Abstürze in Android- oder iOS-Apps fügen Sie bitte die entsprechenden Debugprotokolle für Xamarin.Android- und Xamarin.iOS-Apps ein.

  5. ^ Wenn möglich für Ihr bestimmtes Problem, besteht eine Option darin, das Problem neu zu erstellen, indem Sie eine kleine Anzahl von Dateien aus Ihrer ursprünglichen Lösung zu einer brandneuen Lösung hinzufügen. Das Xamarin-Team ist häufig in der Lage, Probleme auch in größeren Testfällen zu untersuchen (vorausgesetzt, die zu reproduzierenden Schritte sind klar erklärt), aber einfachere Testfälle bieten die beste Chance, dass der Fehler schnell behoben wird.

  6. ^ Wenn es nicht möglich ist, das Problem zu reproduzieren, indem Sie eine kleine Anzahl von Dateien zu einer brandneuen Lösung hinzufügen, können Sie den gesamten Lösungsordner für Ihre vollständige App zippen und anfügen. Löschen Sie die binOrdner , obj, Componentsund packages , um die ZIP-Datei zu verkleinern. (Die IDE und der Buildprozess stellen in der Regel den Inhalt dieser Ordner nach Bedarf wieder her oder erstellen sie neu.) Sie können auch beliebig viele Code- und Ressourcendateien aus dem Projekt löschen, solange die resultierende Lösung weiterhin das ursprüngliche Problem veranschaulicht.