您可以使用 Google Issue Tracker 回報問題並提出新功能要求,協助我們改善 Android。Google Issue Tracker 是 Google 用來追蹤 Android 開放原始碼計畫問題和功能要求的工具。Issue Tracker 僅供 Google 外部的大眾和合作夥伴使用者使用,凡是需要與 Google 團隊合作處理特定問題和功能的合作夥伴使用者皆可使用。
如要瞭解 Google Issue Tracker 的基本概念,請參閱 Google Issue Tracker。
回報錯誤
如何回報 Android 開放原始碼計畫錯誤:
- 以所有未解決的錯誤做為搜尋依據,使用 Issue Tracker 的搜尋欄位,查看是否有人已回報您的問題或功能。別忘了一併搜尋已關閉和已修正的錯誤如要找出最熱門的搜尋結果,請依星級評等排序結果。如要進一步瞭解如何使用搜尋欄,請參閱「搜尋問題」一文。
- 如果找到問題,且對你來說很重要,請加星!問題的星號數量有助 Google 判斷其優先順序。
如果沒有人回報您的問題,請建立新的錯誤。
請參閱本文件中與錯誤元件相關的章節。錯誤元件可指出 Android 中哪個區域發生錯誤。
- 如果錯誤與安全性相關,請參閱「安全性」一節。
- 如果錯誤與 Android 開放原始碼計畫有關,請參閱平台。
- 如果錯誤與開發人員工具有關,請參閱 Android 開發人員工具。
- 如果錯誤是指說明文件有誤,請參閱說明文件。
填寫提供的範本:
- 如果是錯誤,請在備註中納入重現錯誤的步驟。僅指出有故障情形的註解可能需要更多資訊。您提供的詳細資料 (包括記錄檔,甚至是修補程式集) 有助於 Google 解決您的問題。
- 如果問題是功能要求,請提供建議功能的詳細資訊,包括解決的問題和設計考量。
點按「建立」,系統會建立錯誤報告,以便 Google 進行審查。
如要瞭解如何追蹤錯誤狀態,請參閱「追蹤錯誤狀態」一文。
錯誤元件
以下四個部分旨在協助您使用正確的元件搜尋及回報錯誤。
安全性
如果您發現會影響 Android 安全性或 Pixel 裝置中元件的相關問題,請按照「回報安全性問題」一文中的指示回報錯誤。此外,安全性錯誤也有資格加入 Android 和 Google 裝置獎勵計畫。
平台
如果您有會影響 Android 平台某部分的問題或功能要求,請按一下相關元件區域旁邊的錯誤圖示回報錯誤:
Android 開發人員工具
如果您有會影響 Android 開發人員工具某個部分的問題或功能要求,請在下表中相關元件區域旁邊按一下「錯誤」圖示,回報錯誤。
瀏覽錯誤 | 詳細說明 | 回報錯誤 |
---|---|---|
adb | bug_report | |
Android Studio | Android Studio 錯誤專屬資訊 | bug_report |
C++ | Android Studio 中的相關問題 | bug_report |
模擬器或系統映像檔 | Emulator 錯誤專屬資訊 | bug_report |
Gradle | Gradle 錯誤專屬資訊 | bug_report |
套用變更 | 針對套用變更錯誤的特定資訊 | bug_report |
Lint | bug_report | |
NDK | NDK 編譯器或建構系統問題。不適用於 API 要求或錯誤。API 是作業系統的一部分,與 API 相關的要求應提交至上述其中一個平台元件 (如果不知道該提交至哪個元件,請使用 Framework)。 | bug_report |
分析器 | bug_report | |
Jetpack (androidx) | bug_report | |
Jetpack (androidx) 測試 | bug_report | |
Games SDK | bug_report |
說明文件
如果您有問題或功能要求會影響 Android 說明文件的某個層面,請按一下相關元件區域旁的錯誤圖示,提交錯誤:
瀏覽錯誤 | 回報錯誤 |
---|---|
developer.android.com (應用程式開發人員說明文件) |
bug_report |
source.android.com (Android 開放原始碼計畫說明文件) |
bug_report |
指定行銷區域互通性要求
如果您想針對 Android 提交《數位市場法》互通性要求,請使用相關元件區塊:
提出要求 | 瀏覽要求 |
---|---|
建立新的公開要求 | 公開要求 |
建立新的私人要求 |
追蹤錯誤狀態
新建立的錯誤一律會標示為「新」狀態。AOSP 維護人員會定期審查及分類錯誤,並可能將其指派給其他人。錯誤會歸入以下三個類別之一:
需要更多資訊。錯誤報告沒有足夠的資訊,無法讓人員依據優先順序或正確分析錯誤。在您提供要求的資訊之前,系統會將錯誤報告放入清單 (New + Hotlist:NeedsInfo)。經過一段時間後,如未提供額外資訊,錯誤會獲得一個狀態,表示不需要採取任何行動。
錯誤會已指派給其他使用者,並視需要變更優先順序。錯誤報告為充分詳盡的有效問題報告。錯誤已正確排序或重新排序。最後,將錯誤指派給特定貢獻者進行評估和分析。
一般來說,錯誤會維持在「已指派」狀態,直到有人打算解決該錯誤,此時該錯誤就會獲派「接受」狀態。不過,指派者可能不會將錯誤狀態變更為「已接受」,而是直接修正錯誤,並指派「已修正」或「已修正 (已驗證)」狀態。
我們不會採取行動處理這個錯誤。錯誤會歸類為此類別的原因有很多,例如該錯誤與其他錯誤重複、無法修正,或是代表功能正常運作。
如要追蹤錯誤狀態,請按照下列步驟操作:
- 開啟錯誤,查看「優先順序」、「狀態」和「註解」欄位。如要瞭解優先順序和狀態,請參閱問題欄位。
- (選用) 在「註解」欄位中回覆任何問題或意見。
標示為「已修正 (已驗證)」的錯誤會納入日後的 Android 版本。
特定狀態的其他資訊
除了 Issue Tracker 問題欄位說明文件中提供的資訊外,以下進一步說明幾種錯誤狀態:
不會修正 (預期行為): AOSP 維護者已判定所述行為並非錯誤,而是預期行為。這個狀態也通常稱為「正常運作 (WAI)」。針對功能要求,AOSP 維護人員已判定這項要求不會在 Android 中實作。
不會修正 (無法修正):無法合理地進行解決問題所需的變更。這個狀態也會用於回報無法在 Android 開放原始碼計畫中處理的問題,原因通常是因為該應用程式與自訂裝置或外部應用程式相關,或者回報者誤將 Issue Tracker 誤認為說明論壇。
已修正 (已驗證):這項錯誤已修正,並包含在正式版本中。
已修正:這個錯誤已在原始碼樹狀結構中修正 (或已實作),但可能尚未納入正式版本。