回報及追蹤錯誤

您可以使用 Google Issue Tracker 回報問題並要求新增功能,協助我們改善 Android。Google Issue Tracker 是 Google 用來追蹤 AOSP 問題和功能要求的工具。Issue Tracker 可供 Google 以外的使用者使用,包括需要與 Google 團隊合作處理特定問題和功能的合作夥伴和外部使用者。

如要瞭解 Google Issue Tracker 的基本概念,請參閱 Google Issue Tracker

回報錯誤

如要回報 AOSP 錯誤,請按照下列步驟操作:

  1. 所有未解決的錯誤做為搜尋依據,使用 Issue Tracker 的搜尋欄位,查看是否有人已回報您的問題或功能。別忘了搜尋已關閉和修正的錯誤。為協助您找到最熱門的結果,請依星號數量排序結果。如要進一步瞭解如何使用搜尋欄,請參閱「搜尋問題」一文。
  2. 如果找到問題,且對你來說很重要,請加星!問題的星號數量有助 Google 判斷其優先順序。
  3. 如果沒有人回報您的問題,請建立新的錯誤。

    1. 請參閱本文件中與錯誤相關的元件部分。錯誤元件可指出 Android 中哪個區域發生錯誤。

      • 如果錯誤與安全性相關,請參閱「安全性」一節。
      • 如果錯誤與 Android 開放原始碼計畫有關,請參閱「平台」一節。
      • 如果錯誤與開發人員工具有關,請參閱 Android 開發人員工具
      • 如果錯誤是指說明文件有誤,請參閱說明文件
    2. 填寫提供的範本:

      • 如果問題是錯誤,請在註解中附上重現錯誤的步驟。如果留言內容只提到某項功能無法正常運作,可能需要進一步的資訊。您提供的詳細資料 (包括記錄檔,甚至是修補程式集) 有助於 Google 解決您的問題。
      • 如果問題是功能要求,請針對建議的功能提供明確詳細資料,包括解決的問題和設計考量。
    3. 點按「建立」,系統會建立錯誤報告,供 Google 審查。

如要瞭解如何追蹤錯誤狀態,請參閱「追蹤錯誤狀態」一文。

錯誤元件

下列四個部分旨在協助您使用正確的元件搜尋及回報錯誤。

安全性

如果您發現會影響 Android 安全性或 Pixel 裝置中元件的相關問題,請按照「回報安全性問題」一文中的指示回報錯誤。此外,安全性錯誤符合 Android 和 Google 裝置獎勵計畫的資格。

平台

如果您有問題或功能要求會影響 Android 平台的某個層面,請按一下相關元件區域旁的錯誤圖示,回報錯誤:

瀏覽所有平台問題

Android 開發人員工具

如果您有問題或功能要求會影響 Android 開發人員工具的某個層面,請按一下下表中相關元件區域旁的錯誤圖示,將錯誤檔案送交。

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

瀏覽錯誤 詳細說明 回報錯誤
adb
Android Studio Android Studio 錯誤的特定資訊
C++ Android Studio 中的相關問題
模擬器或系統映像檔 Emulator 錯誤專屬資訊
Gradle Gradle 錯誤專屬資訊
套用變更 適用於套用變更錯誤的特定資訊
Lint
NDK NDK 編譯器或建構系統問題。不適用於 API 要求或錯誤。API 是作業系統的一部分,與 API 相關的要求應提交至上述其中一個平台元件 (如果不知道該使用哪一個,請使用 Framework)。
分析器
Jetpack (androidx)
Jetpack (androidx) 測試
Games SDK

說明文件

如果您有問題或功能要求會影響 Android 說明文件的某個層面,請按一下相關元件區域旁的錯誤圖示,回報錯誤:

《數位市場法》互通性要求

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

追蹤錯誤狀態

新建立的錯誤一律會標示為「新」狀態。AOSP 維護人員會定期審查及分類錯誤,並可能將其指派給其他人。錯誤會分類為以下三種:

  • 需要更多資訊。錯誤報告沒有足夠的資訊,無法讓人員依據優先順序或正確分析錯誤。在您提供所需資訊之前,系統會將錯誤報告放入清單 (New + Hotlist:NeedsInfo)。一段時間後,如果未提供其他資訊,系統會將該錯誤設為「不會採取行動」的狀態。

  • 錯誤會指派給某人,並視需要重新設定優先順序。系統已認定此錯誤回報為合法問題的詳細報告。錯誤已正確排序或重新排序。最後,將錯誤指派給特定貢獻者進行評估和分析。

    通常,除非有人打算解決錯誤,否則錯誤狀態會維持為「已指派」,這時才會指派「已接受」狀態。不過,指派者可能不會將錯誤狀態變更為「已接受」,而是直接修正錯誤,並指派「已修正」或「已修正 (已驗證)」狀態。

  • 我們不會採取行動處理這個錯誤。錯誤會歸類為此類別的原因有很多,例如該錯誤與其他錯誤重複、無法修正,或是代表功能正常運作。

如要追蹤錯誤狀態,請按照下列步驟操作:

  1. 開啟錯誤,查看「優先順序」、「狀態」和「註解」欄位。如要瞭解優先順序和狀態,請參閱問題欄位
  2. (選用) 在「註解」欄位中回覆任何問題或意見。

標示為「已修正 (已驗證)」的錯誤會納入日後的 Android 版本。

特定狀態的其他資訊

除了 Issue Tracker 問題欄位說明文件中提供的資訊外,以下進一步說明幾種錯誤狀態:

  • 不會修正 (預期行為): AOSP 維護者已判定所述行為並非錯誤,而是預期行為。這個狀態也通常稱為「正常運作 (WAI)」。針對功能要求,AOSP 維護人員已判定這項要求不會在 Android 中實作。

  • 不會修正 (無法修正):無法合理地進行解決問題所需的變更。這個狀態也用於回報的問題無法在 AOSP 中處理,通常是因為問題與自訂裝置或外部應用程式有關,或是回報者誤將「Issue Tracker」當成說明論壇。

  • 已修正 (已經驗證):這個錯誤已修正,並納入正式版本。

  • 已修正:這個錯誤已在來源樹狀結構中修正 (或已實作),但可能尚未納入正式版本。