Contents

创建有用的错误报告

Contents

在 GitHub 上创建问题
提供最简可复现的代码示例
提供一些 Flutter 诊断信息
以详细模式运行命令
提供最新的日志
提供崩溃报告

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

要报告 Flutter 崩溃或错误，请在 flutter/flutter 项目中创建问题。
要报告网站问题，请在 flutter/website 项目中创建问题。

创建一个最简的 Flutter 应用来展示您遇到的问题，并将其粘贴到 GitHub 问题中。

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

或者，您可以使用DartPad，它能够创建和运行小型 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