回報及追蹤錯誤

如要回報問題及要求新功能，請使用 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 平台，請點按相關元件區域旁的錯誤圖示，回報錯誤：

瀏覽所有平台問題

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

Android 開發人員工具

如果您有問題或功能要求，會影響 Android 開發人員工具的某個層面，請點選下表相關元件區域旁的錯誤圖示，回報錯誤。

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

瀏覽錯誤	詳細說明	回報錯誤
adb		bug_report
Android Studio	Android Studio 錯誤專用資訊	bug_report
C++	Android Studio 中的問題	bug_report
模擬器或系統映像檔	模擬器錯誤專用資訊	bug_report
Gradle	Gradle 錯誤專用資訊	bug_report
套用變更	適用於「套用變更」錯誤的特定資訊	bug_report
Lint		bug_report
NDK	NDK 編譯器或建構系統問題。不適用於 API 要求或錯誤。API 是 OS 的一部分，相關要求應歸入先前的其中一個平台元件 (如果不知道要使用哪個，請使用 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 (AOSP 文件)	bug_report

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

如要提交 Android 的《數位市場法》互通性要求，請使用相關的元件區域：

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

在 Pixel 上要求 DMA 內容動態消息

在歐洲經濟區 (EEA)，Pixel 會顯示《數位市場法》線上搜尋引擎 (OSE) 選擇畫面，讓使用者選取偏好的 OSE。如果使用者在 OSE 選擇畫面中選取特定供應商，該供應商可以選擇在 Pixel 畫面上顯示內容動態消息。使用者從 Pixel 主畫面向右滑動時，就會看到這個畫面。

如果您是參與任何會員國 DMA OSE 選擇畫面計畫的供應商，並有意在 Pixel 的 -1 畫面上顯示內容，請提交錯誤報告與我們聯絡：

建立新的私人要求

追蹤錯誤狀態

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

• 需要更多資訊。錯誤報告資訊不足，無法讓他人排定優先順序或正確分析錯誤。在您提供要求資訊前，錯誤報告會列在清單 (New + Hotlist:NeedsInfo) 中。一段時間後，如果沒有提供其他資訊，系統會將錯誤狀態設為「不會採取行動」。

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

  通常，在有人打算解決錯誤之前，錯誤會維持「已指派」狀態，此時錯誤會指派為「已接受」狀態。不過，指派對象可能不會將錯誤狀態變更為「已接受」，而是直接修正錯誤，並指派「已修正」或「已修正 (已驗證)」狀態。

• 系統不會處理該錯誤。錯誤屬於這個類別的原因有很多，例如錯誤與其他錯誤重複、無法修正錯誤，或錯誤代表功能正常運作。

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

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

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

特定狀態的額外資訊

以下進一步說明幾個錯誤狀態 (除了 Issue Tracker Issue 欄位文件提供的資訊外)：

• 不會修正 (預期行為)：AOSP 維護人員已判定所描述的行為並非錯誤，而是預期行為。這個狀態也通常稱為「運作正常 (WAI)」。如果是功能要求，AOSP 維護人員已判定不會在 Android 中實作該要求。

• 不會修正 (不可行)：解決問題所需的變更不合理，如果回報的問題無法在 Android 開放原始碼計畫中處理 (通常是因為問題與自訂裝置或外部應用程式有關，或是回報者誤將 Issue Tracker 當成說明論壇)，也會使用這個狀態。

• 已修正 (已驗證)：這個錯誤已修正，並納入正式版本。

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