回報及追蹤錯誤

您可以使用 Google Issue Tracker 回報問題並提出新功能要求,協助我們改善 Android。Google Issue Tracker 是 Google 用來追蹤 Android 開放原始碼計畫問題和功能要求的工具。Issue Tracker 僅供 Google 外部的大眾和合作夥伴使用者使用,凡是需要與 Google 團隊合作處理特定問題和功能的合作夥伴使用者皆可使用。

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

回報錯誤

如何回報 Android 開放原始碼計畫錯誤:

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

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

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

      • 如果是錯誤,請在備註中納入重現錯誤的步驟。僅指出有故障情形的註解可能需要更多資訊。您提供的詳細資料 (包括記錄檔,甚至是修補程式集) 有助於 Google 解決您的問題。
      • 如果問題是功能要求,請提供建議功能的詳細資訊,包括解決的問題和設計考量。
    3. 點按「建立」,系統會建立錯誤報告,以便 Google 進行審查。

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

錯誤元件

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

安全性

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

平台

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

瀏覽所有平台問題

瀏覽錯誤 回報錯誤
無障礙功能
Android 執行階段:ART
瀏覽器
CTS
架構
圖像
核心 (GKI)
16kB
媒體
免安裝應用程式
Libcore
網路
系統
通用系統映像檔
Text
事物
Wear

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 說明文件的某個層面,請按一下相關元件區域旁的錯誤圖示,提交錯誤:

瀏覽錯誤 回報錯誤
developer.android.com (應用程式開發人員說明文件)
source.android.com (Android 開放原始碼計畫說明文件)

指定行銷區域互通性要求

如果您想針對 Android 提交《數位市場法》互通性要求,請使用相關元件區塊:

提出要求 瀏覽要求
建立新的公開要求 公開要求
建立新的私人要求

追蹤錯誤狀態

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

  • 需要更多資訊。錯誤報告沒有足夠的資訊,無法讓人員依據優先順序或正確分析錯誤。在您提供要求的資訊之前,系統會將錯誤報告放入清單 (New + Hotlist:NeedsInfo)。經過一段時間後,如未提供額外資訊,錯誤會獲得一個狀態,表示不需要採取任何行動。

  • 錯誤會已指派給其他使用者,並視需要變更優先順序。錯誤報告為充分詳盡的有效問題報告。錯誤已正確排序或重新排序。最後,將錯誤指派給特定貢獻者進行評估和分析。

    一般來說,錯誤會維持在「已指派」狀態,直到有人打算解決該錯誤,此時該錯誤就會獲派「接受」狀態。不過,指派者可能不會將錯誤狀態變更為「已接受」,而是直接修正錯誤,並指派「已修正」或「已修正 (已驗證)」狀態。

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

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

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

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

特定狀態的其他資訊

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

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

  • 不會修正 (無法修正):無法合理地進行解決問題所需的變更。這個狀態也會用於回報無法在 Android 開放原始碼計畫中處理的問題,原因通常是因為該應用程式與自訂裝置或外部應用程式相關,或者回報者誤將 Issue Tracker 誤認為說明論壇。

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

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