共用方式為

提出 Bug 報告的時機與方式為何？

  • 發行項

提示

使用 Visual Studio 中的 [ 回報問題] 功能表項 – 這會傳送診斷資訊與您的 Bug 報告，以協助解決問題。

Visual Studio 2019 或 Visual Studio 2017 和 Visual Studio for Mac 有詳細的指示。

您可以在 Visual Studio 開發人員社群 網站上搜尋現有的報表。

如果...

您有一組您認為工程師能夠用來重現問題的步驟。

OR

您可以仔細描述問題的可見徵兆，特別是如果您也可以描述與問題相關的一些精確情況。[1]

協助快速且有效率地解決 Bug 的最佳做法

  1. 搜尋 Visual Studio 開發人員社群 和 Web，尋找可能直接解決問題的現有 Bug 報告或使用建議。[2][3]

  2. 盡可能清楚且簡潔地描述問題，包括所發生情況的描述，以及預期會發生的問題。

  3. 包含任何相關的堆疊追蹤、錯誤訊息正文或當機記錄檔（如果您使用 回報問題 功能，則可以自動包含這些追蹤）。 [4]

  4. 記下螢幕快照附件中顯示為純文字的任何重要錯誤訊息。

  5. 包含小型獨立測試案例，以盡可能少的程式代碼重現 Bug。 如果您無法重現全新項目的問題（使用其中一個內建範本所建立），請壓縮示範問題的專案，並將它附加至 Bug 報告。 在附加範例專案之前，請盡可能簡單。[5][6]

  6. 描述遇到 Bug 的環境，包括作業系統和 Xamarin 版本以及任何相依性。

其他詳細資料

  1. ^在理想情況下，「可見徵兆」的描述應該包含足夠的詳細數據，以便其他客戶確認他們是否看到相同的問題（相同的錯誤訊息、相同的效能降低、損毀的相同堆疊追蹤等等）。 對於「確切的情況」，一個很好的例子是，如果你可以說這樣的話：「我通常遇到問題75%的時間，但如果我改變這一件事，那麼我可以完全避免問題。另一個類似「精確情況」的範例是，如果降級為舊版 Xamarin 會停止問題。

  2. ^ 如您所預期，錯誤文字的代碼段（或任何其他唯一的描述性文字）通常是最佳搜尋字詞。 如果現有的 Bug 報告不完整，則歡迎新增詳細數據或提出新的更好的 Bug 報告。

  3. ^ 另一個好問題是，是否有任何 Java、 Objective-C或 Swift 應用程式回報相同的問題。 如果是，則問題很可能是 Android 或 iOS 本身的一部分，而不是 Xamarin 的一部分。

  4. ^ 要包含的一些資訊範例：

    1. 針對建置項目時發生的錯誤，請在錯誤報告中包含完整的 診斷建置輸出 。

    2. 針對從 Visual Studio 建置或偵錯 iOS 專案時發生的錯誤，請在發生錯誤後執行 說明 > Xamarin > Zip 記錄 ，並在錯誤報告中包含產生的.zip檔案。

    3. 如需 Android 或 iOS 應用程式中的例外狀況或當機，請包含 Xamarin.Android 和 Xamarin.iOS 應用程式的相關偵錯記錄。

  5. ^ 如果您的特定問題可能，有一個選項是將原始解決方案中的少數檔案新增至全新的解決方案，以重新建立問題。 Xamarin 小組通常能夠在較大的測試案例上調查問題（假設重現的步驟已清楚說明），但較簡單的測試案例可讓 Bug 快速解決的最佳機會。

  6. ^如果無法藉由將少量檔案新增至全新的解決方案來重現問題，您可以壓縮並附加完整應用程式的整個解決方案資料夾。 請刪除bin、 objComponents和 packages 資料夾，讓 zip 檔案更小。 （IDE 和建置程式通常會視需要還原或重新建立這些資料夾的內容。您也可以視需要從專案刪除盡可能多的程式碼和資源檔，只要產生的解決方案仍示範原始問題。