报告和跟踪 bug

您可以使用 Google 问题跟踪器报告问题及提出新功能请求，以协助我们改进 Android。Google 问题跟踪器是 Google 用来跟踪 AOSP 问题和功能请求的工具。问题跟踪器可在 Google 外部使用，以供外部公众用户及合作伙伴用户与 Google 团队协作解决特定问题和实现功能。

如需了解 Google 问题跟踪器的基础知识，请参阅 Google 问题跟踪器。

报告错误

如需报告 AOSP bug，请执行以下操作：

  1. 根据所有待解决的 bug 进行搜索，使用问题跟踪器的搜索字段查看是否有人报告过您的问题或提交过相关功能请求。别忘了还要搜索已关闭和已修复的 bug。为了方便您找到关注人数最多的问题，请按星标数对搜索结果进行排序。如需详细了解如何使用搜索字段，请参阅问题搜索
  2. 如果您找到了自己遇到的问题，并且该问题对您来说很重要，请为其加注星标！ Google 可以借助某个问题获得的星标数来确定问题的优先级。

  3. 如果没有人报告过您的问题，请创建一个新 bug。

    1. 请参阅本文档中关于 bug 组件的部分。bug 组件用于识别 bug 适用的 Android 领域。

      • 如果 bug 与安全有关，请参阅安全。
      • 如果 bug 与 AOSP 有关，请参阅平台。
      • 如果 bug 与开发者工具有关，请参阅 Android 开发者工具。
      • 如果 bug 涉及错误文档，请参阅文档。

    2. 填写所提供的模板：

      • 如果问题属于 bug，请在注释中列出重现 bug 的步骤。如果注释只是说某些方面存在问题，系统可能会要求您提供更多信息。您提供的详细信息（包括日志文件，甚至补丁集）越多，越有助于 Google 解决问题。
      • 如果问题属于功能请求，请提供所提议功能的具体细节，包括要解决的问题和设计注意事项。

    3. 点击创建。系统会创建 bug 报告，供 Google 审核。

如需了解如何跟踪 bug 的状态，请参阅跟踪 bug 状态。

bug 组件

以下四个部分旨在帮助您使用正确的组件搜索和报告 bug。

安全

如果您在 Pixel 设备中发现了影响 Android 或组件安全的问题，请遵循报告安全问题中的说明提交错误。此外，如果报告安全 bug，您还可以参加 Android 和 Google 设备奖励活动。

平台

如果您发现了影响 Android 平台某个方面的问题，或要提出相关功能请求，请点击对应组件区域旁边的 bug 图标，提交您的 bug：

浏览所有平台问题

浏览 bug 提交 bug
无障碍功能
ART
浏览器
CTS
框架
图形
内核 (GKI)
16kB
媒体
免安装应用
Libcore
网络
系统
通用系统映像
文本
Things
Wear

Android 开发者工具

如果您发现了影响 Android 开发者工具某个方面的问题，或要提出相关功能请求，请点击下表中对应组件区域旁边的 bug 图标，提交您的 bug。

浏览所有开发者工具问题

浏览 bug 详细信息 提交 bug
adb
Android Studio 针对 Android Studio bug 需要提供的信息
C++ Android Studio 中的问题
模拟器或系统映像 针对模拟器 bug 需要提供的信息
Gradle 针对 Gradle bug 需要提供的信息
应用更改 针对应用更改 bug 需要提供的信息
lint
NDK NDK 编译器或构建系统问题。不针对 API 请求或 bug。API 是操作系统的一部分，与这些 API 相关的请求应在上面的某个平台组件中提交（如果您不知道哪个组件，请使用“框架”）。
性能分析器
Jetpack (androidx)
Jetpack (androidx) 测试
Games SDK

文档

如果您发现了影响 Android 文档某个方面的问题，或要提出相关功能请求，请点击对应组件区域旁边的 bug 图标，提交您的 bug：

浏览 bug 提交 bug
developer.android.com（应用开发者文档）
source.android.com（AOSP 文档）

DMA 互操作性请求

如果您要针对 Android 提交 DMA 互操作性请求，请在相关组件区域操作：

提交请求 浏览请求
创建新的公开请求 公开请求
创建新的不公开请求

跟踪 bug 状态

新建 bug 一律被标记为 New 状态。AOSP 维护人员通过更改 bug 状态并可能将其分配给他人来定期审核 bug 并对其进行分类。bug 将被划分为以下 4 个类别之一：

  • 需要更多信息。bug 报告中没有足够的信息供相关人员优先处理或正确分析 bug。bug 报告会一直在列表 (New + Hotlist:NeedsInfo) 中，直到您提供所需信息为止。一段时间后，如果您仍未提供任何额外信息，系统会更改 bug 的状态，以表明此 bug 不需要任何处理。

  • bug 状态变为 Assigned ，表示相应 bug 分配给了相关人员，并视需要调整了优先级。我们已将 bug 报告认定为细节充分、问题有效，并正确设置 bug 的优先级或重新调整优先级。最后，我们会将 bug 分配给特定贡献者进行评估和分析。

    通常情况下，bug 会一直保持 Assigned 状态，直到有人有意解决它，此时 bug 的状态会被指定为 Accepted。但是，分配对象可能不会将 bug 的状态更改为 Accepted ，而是修复 bug 并为其指定一个 Fixed 或 Fixed (verified) 状态。

  • 我们不会处理此类 bug。bug 会出于多种原因被归入此类别，例如 bug 与另一个 bug 重复，bug 不可修复，或者 bug 所描述的功能按预期正常运行。

如需跟踪 bug 状态，请执行以下操作：

  1. 打开 bug 并查看优先级、状态和注释字段。如需了解优先级和状态的说明，请参阅问题字段。
  2. （可选）回复注释字段中的任何问题或意见。

标记为 Fixed (verified) 状态的 bug 最终将在未来版本的 Android 软件中予以修复。

有关特定状态的其他信息

除了问题跟踪器的问题字段文档中提供的信息之外，下面还对几个 bug 状态做了进一步说明：

  • Won't Fix (Intended behavior)：AOSP 维护人员已确定所描述的行为不是 bug，而是正常情况。这种状态通常也称为“按预期运行 (WAI)”。如果是功能请求，此状态表示 AOSP 维护人员已确定在 Android 中将不会实现相应请求。

  • Won't Fix (Infeasible)：解决问题所需进行的更改不可能实现。此状态还用于表示报告的问题无法在 AOSP 中予以处理，这通常是因为问题与定制设备或外部应用相关，或者报告者误认为此问题跟踪器是帮助论坛。

  • Fixed (verified)：已修复相应 bug，且某个正式版本中已纳入相应的修复方案。

  • Fixed：相应 bug 已经在源代码树中予以修复（或功能已经实现），但修复方案尚未被纳入到正式版本中。