報告並追蹤錯誤

您可以透過使用Google 問題追蹤器報告問題和請求新功能來幫助改進 Android。 Google Issue Tracker 是 Google 用於追蹤 AOSP 問題和功能請求的工具。問題追蹤器可在 Google 外部使用,供需要與 Google 團隊就特定問題和功能進行協作的外部公眾和合作夥伴用戶使用。

要了解 Google 問題追蹤器的基礎知識,請參閱Google 問題追蹤器

報告錯誤

要回報 AOSP 錯誤:

  1. 所有未解決的錯誤作為搜尋的基礎,使用問題追蹤器的搜尋欄位查看是否有人已經報告了您的問題或功能。不要忘記搜尋已關閉和已修復的錯誤。為了幫助您找到最受歡迎的結果,請按星數對結果進行排序。有關使用搜尋欄位的詳細信息,請參閱問題搜尋
  2. 如果您發現問題並且它對您很重要,請為其加註星標!某個問題的星數有助於 Google 確定其優先順序。
  3. 如果沒有人報告您的問題,請建立一個新錯誤。

    1. 請參閱本文檔中與您的錯誤相關的組件部分。 Bug 元件標識了 Bug 適用的 Android 區域。

      • 如果錯誤與安全性相關,請參閱安全性
      • 如果bug與AOSP相關,請參閱平台
      • 如果Bug與開發者工具相關,請參考Android開發者工具
      • 如果錯誤引用了不正確的文檔,請參閱文檔
    2. 填寫提供的範本:

      • 如果問題是錯誤,請在評論中包含重現該錯誤的步驟。僅指出某些內容不起作用的評論可能需要更多資訊。您提供的詳細資訊(包括日誌檔案甚至補丁集)可以幫助 Google 解決您的問題。
      • 如果問題是功能請求,請提供有關提議功能的明確詳細信息,包括解決的問題和設計注意事項。
    3. 單擊創建。該錯誤報告是為了供 Google 審核而創建的。

若要了解如何追蹤錯誤狀態,請參閱追蹤錯誤狀態

錯誤組件

以下四個部分旨在幫助您使用正確的元件搜尋和報告錯誤。

安全

如果您發現影響 Android 或 Pixel 裝置中元件安全的問題,請依照報告安全性問題中的說明提交錯誤。此外,安全漏洞也符合Android 和 Google 裝置獎勵計畫的資格。

平台

如果您遇到影響 Android 平台某個方面的問題或功能請求,請透過點擊相關元件區域旁的錯誤圖示來提交錯誤:

瀏覽所有平台問題

瀏覽錯誤提交錯誤
無障礙
藝術
瀏覽器
CTS
框架
圖形
核心(GKI)
媒體
即時應用程式
利伯核
聯網
系統
通用系統映像
文字
事物
穿

Android 開發者工具

如果您遇到影響 Android 開發人員工具某個方面的問題或功能請求,請透過點擊下表中相關元件區域旁的錯誤圖示來提交錯誤。

瀏覽所有開發人員工具問題

瀏覽錯誤細節提交錯誤
亞行
安卓工作室Android Studio 錯誤的特定訊息
C++ Android Studio 中的問題
模擬器或系統映像模擬器錯誤的特定訊息
搖籃Gradle bug 的特定訊息
應用程式變更特定於“應用更改”錯誤的訊息
皮棉
NDK NDK 編譯器或建置系統問題。不適用於 API 請求或錯誤。 API 是作業系統的一部分,與它們相關的請求應提交到上述平台元件之一(如果您不知道是哪個,請使用框架)。
分析器
噴射背包 (androidx)
Jetpack (androidx) 測試
遊戲SDK

文件

如果您遇到影響 Android 文件某個方面的問題或功能請求,請透過點擊相關元件區域旁的錯誤圖示來提交錯誤:

瀏覽錯誤提交錯誤
developer.android.com (應用程式開發人員文件)
source.android.com (AOSP 文件)

DMA 互通性請求

如果您想提交 Android 的 DMA 互通性請求,請使用相關元件區域:

提出請求瀏覽請求
建立新的公共請求公眾要求
建立新的私人請求

追蹤錯誤狀態

新建立的錯誤始終標記為New狀態。 AOSP 維護人員透過更改錯誤狀態並可能將其分配給某人來定期審查和分類錯誤。錯誤被分為以下三類之一:

  • 需要更多資訊。錯誤報告沒有足夠的資訊供某人確定錯誤的優先順序或正確分析錯誤。錯誤報告將放在清單中( New + Hotlist:NeedsInfo ),直到您提供所要求的資訊。一段時間後,如果沒有提供其他信息,該錯誤將被賦予一個狀態,表明不會對其採取行動。

  • 該錯誤已分配給某人,並且可以選擇重新確定優先順序。該錯誤報告已被認為是對合法問題的充分詳細的報告。錯誤的優先順序已正確確定或重新確定了優先順序。最後,該錯誤被分配給特定的貢獻者進行評估和分析。

    通常,錯誤會保持「已指派」狀態,直到有人打算解決該錯誤為止,此時該錯誤將被指派為「已接受」狀態。但是,受讓人可能不會將錯誤的狀態變更為「已接受」 ,而只是修復錯誤並指派「已修復」「已修復」(已驗證)狀態。

  • 該錯誤不會被採取行動。出於多種原因,錯誤屬於此類別,例如該錯誤是另一個錯誤的重複,該錯誤無法修復,或者該錯誤代表了按預期工作的功能。

追蹤錯誤狀態:

  1. 開啟錯誤並查看優先順序、狀態和評論欄位。有關優先順序和狀態的說明,請參閱問題欄位
  2. (可選)回覆評論欄位中的任何問題或評論。

標有“已修復”(已驗證)狀態的錯誤將包含在 Android 的未來版本中。

特定狀態的附加資訊

以下是一些錯誤狀態的進一步說明(除了問題追蹤器問題欄位文件中提供的資訊之外):

  • 無法修復(預期行為): AOSP 維護者已確定所描述的行為不是錯誤,而是預期行為。此狀態通常也稱為「按預期工作 (WAI)」。對於功能請求,AOSP 維護人員已確定該請求不會在 Android 中實現。

  • 無法修復(不可行):解決問題所需的變更不太可能。此狀態也用於報告無法在 AOSP 中處理的問題,通常是因為它與自訂設備或外部應用程式相關,或者報告者將問題追蹤器誤認為是幫助論壇。

  • 已修復(已驗證):此錯誤已修復,並包含在正式版本中。

  • 已修復:此錯誤已在原始程式碼樹中修復(或實現了功能),但可能尚未包含在正式版本中。