创建有用的错误报告
本文档中的说明详细介绍了当前为崩溃和其他不良行为提供最具操作性 Bug 报告所需的步骤。每个步骤都是可选的,但将极大地提高诊断和解决问题的速度。我们感谢您提供尽可能多的反馈。
在 GitHub 上创建 Issue
#- 要报告 Flutter 崩溃或 Bug,请在 flutter/flutter 项目中创建 Issue。
- 要报告网站问题,请在 flutter/website 项目中创建 Issue。
提供最小可复现代码示例
#创建一个能展示您遇到的问题的最小 Flutter 应用,并将其粘贴到 GitHub Issue 中。
您可以使用 flutter create bug
命令来创建它,然后更新 main.dart
文件。
或者,您也可以使用 DartPad,它能够创建和运行小型 Flutter 应用。
如果您的问题超出了单个文件的范围,例如您在使用原生通道时遇到问题,您可以将复现代码的完整内容上传到单独的代码库并进行链接。
提供一些 Flutter Diagnostics
#- 在项目目录中运行
flutter doctor -v
命令,并将结果粘贴到 GitHub Issue 中。
[✓] 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
标志。如果附加到 Issue 中,此命令的输出可能有助于诊断问题。 - 将命令的输出附加到 GitHub Issue。
提供最新的日志
#- 使用
flutter logs
命令访问当前连接设备的日志。 - 如果崩溃是可复现的,请清除日志(Mac 上的 ⌘ + k),重现崩溃,然后将新生成的日志复制到一个文件中并附加到 Bug 报告中。
- 如果您遇到框架抛出的异常,请包含第一个此类异常的虚线之间的所有输出。
提供崩溃报告
#- 当 iOS 模拟器崩溃时,会在
~/Library/Logs/DiagnosticReports/
生成崩溃报告。 - 当 iOS 设备崩溃时,会在
~/Library/Logs/CrashReporter/MobileDevice
生成崩溃报告。 - 找到与崩溃对应的报告(通常是最近的),并将其附加到 GitHub Issue。