建立有用的錯誤報告
在哪裡提交 Flutter 及相關網站的錯誤報告和功能請求。
本文件中的說明詳細介紹了為崩潰和其他異常行為提供最具參考價值的錯誤報告所需的當前步驟。每一步都是可選的,但它們將極大地提高問題診斷和解決的速度。我們非常感謝您盡力提供儘可能多的反饋。
在 GitHub 上建立 Issue
#- 要報告 Flutter 崩潰或錯誤,請在 flutter/flutter 專案中建立一個 Issue。
- 要報告網站相關問題,請在 flutter/website 專案中建立一個 Issue。
提供最小化可復現程式碼示例
#建立一個能夠展示您所面臨問題的最小化 Flutter 應用,並將其貼上到 GitHub Issue 中。
您可以使用 flutter create bug 命令建立它,並更新 main.dart 檔案。
或者,您也可以使用 DartPad,它支援建立和執行小型的 Flutter 應用。
如果問題超出了單個檔案的範疇(例如涉及原生通道的問題),您可以將完整的復現程式碼上傳到單獨的倉庫並提供連結。
提供 Flutter 診斷資訊
#- 在您的專案目錄中執行
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
以詳細模式(Verbose mode)執行命令
#僅當您的問題與 flutter 工具本身相關時,才遵循以下步驟。
- 所有 Flutter 命令都接受
--verbose標誌。如果將其附加到 Issue 中,此命令的輸出可能有助於診斷問題。 - 將該命令的結果附加到 GitHub Issue 中。

提供最新的日誌
#- 當前連線裝置的日誌可以透過
flutter logs獲取。 - 如果崩潰是可以復現的,請清除日誌(Mac 上為 ⌘ + k),復現崩潰,並將新生成的日誌複製到附加在錯誤報告中的檔案中。
- 如果您遇到了框架丟擲的異常,請包含第一個此類異常中虛線之間(包括虛線)的所有輸出。

提供崩潰報告
#- 當 iOS 模擬器崩潰時,崩潰報告會生成在
~/Library/Logs/DiagnosticReports/中。 - 當 iOS 真機崩潰時,崩潰報告會生成在
~/Library/Logs/CrashReporter/MobileDevice中。 - 找到與崩潰對應的報告(通常是最新的),並將其附加到 GitHub Issue 中。
