内容
description bug_report

创建有用的错误报告

内容

本文档中的说明详细介绍了提供最可操作的崩溃和其他不良行为错误报告所需的当前步骤。每一步都是可选的，但将极大地提高诊断和解决问题的速度。我们感谢您努力向我们发送尽可能多的反馈。

在 GitHub 上创建问题

提供一个最小的可重现代码示例

创建一个显示您遇到的问题的最小 Flutter 应用程序，并将其粘贴到 GitHub 问题中。

要创建它，可以使用 flutter create bug 命令并更新 main.dart 文件。

或者，你可以使用 DartPad，它能够创建和运行小型 Flutter 应用。

如果你的问题超出了可以放在单个文件中解决的范围，例如，你遇到了原生通道问题，你可以将再现问题的完整代码上传到一个单独的代码库并提供链接。

提供一些 Flutter 诊断信息

  • 在你的项目目录中运行 flutter doctor -v，并将结果粘贴到 GitHub 问题中
[✓] Flutter (Channel stable, 1.22.3, on Mac OS X 10.15.7 19H2, locale en-US)
    • Flutter version 1.22.3 at /Users/me/projects/flutter
    • Framework revision 8874f21e79 (5 days ago), 2020-10-29 14:14:35 -0700
    • Engine revision a1440ca392
    • Dart version 2.10.3

[✓] Android toolchain - develop for Android devices (Android SDK version 29.0.2)
    • Android SDK at /Users/me/Library/Android/sdk
    • Platform android-30, build-tools 29.0.2
    • Java binary at: /Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java
    • Java version OpenJDK Runtime Environment (build 1.8.0_242-release-1644-b3-6222593)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS (Xcode 12.2)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Xcode 12.2, Build version 12B5035g
    • CocoaPods version 1.9.3

[✓] Android Studio (version 4.0)
    • Android Studio at /Applications/Android Studio.app/Contents
    • Flutter plugin version 50.0.1
    • Dart plugin version 193.7547
    • Java version OpenJDK Runtime Environment (build 1.8.0_242-release-1644-b3-6222593)

[✓] VS Code (version 1.50.1)
    • VS Code at /Applications/Visual Studio Code.app/Contents
    • Flutter extension version 3.13.2

[✓] Connected device (1 available)
    • iPhone (mobile) • 00000000-0000000000000000 • ios • iOS 14.0

在详细模式下运行命令

仅当你的问题与 flutter 工具相关时，才执行以下步骤。

  • 所有 Flutter 命令都接受 --verbose 标志。如果附加到问题中，此命令的输出可能有助于诊断问题。
  • 将命令的结果附加到 GitHub 问题中。 flutter verbose

提供最新的日志

  • 使用 flutter logs 访问当前连接设备的日志。
  • 如果崩溃可以重现，请清除日志（在 Mac 上按 ⌘ + k），重现崩溃并复制新生成的日志到附加到错误报告的文件中。
  • 如果你收到了框架抛出的异常，请包含第一个此类异常的虚线之间的所有输出。 flutter logs

提供崩溃报告

  • 当 iOS 模拟器崩溃时，会在 ~/Library/Logs/DiagnosticReports/ 中生成崩溃报告。
  • 当 iOS 设备崩溃时，会在 ~/Library/Logs/CrashReporter/MobileDevice 中生成崩溃报告。
  • 找到与崩溃相对应的报告（通常是最新报告），并将其附加到 GitHub 问题中。 crash report