报告和跟踪 bug

您可以通过使用Google 问题跟踪器报告问题和请求新功能来帮助改进 Android。 Google Issue Tracker 是 Google 用于跟踪 AOSP 问题和功能请求的工具。问题跟踪器可在 Google 外部使用,供需要与 Google 团队就特定问题和功能进行协作的外部公众和合作伙伴用户使用。

要了解 Google 问题跟踪器的基础知识,请参阅Google 问题跟踪器

报告错误

要报告 AOSP 错误:

  1. 所有未解决的错误作为搜索的基础,使用问题跟踪器的搜索字段查看是否有人已经报告了您的问题或功能。不要忘记搜索已关闭和已修复的错误。为了帮助您找到最受欢迎的结果,请按星数对结果进行排序。有关使用搜索字段的详细信息,请参阅问题搜索
  2. 如果您发现问题并且它对您很重要,请为其加注星标!某个问题的星数有助于 Google 确定其优先级。
  3. 如果没有人报告您的问题,请创建一个新错误。

    1. 请参阅本文档中与您的错误相关的组件部分。 Bug 组件标识了 Bug 适用的 Android 区域。

      • 如果错误与安全相关,请参阅安全性
      • 如果bug与AOSP相关,请参阅平台
      • 如果Bug与开发者工具相关,请参考Android开发者工具
      • 如果错误引用了不正确的文档,请参阅文档
    2. 填写提供的模板:

      • 如果问题是错误,请在评论中包含重现该错误的步骤。仅指出某些内容不起作用的评论可能需要更多信息。您提供的详细信息(包括日志文件甚至补丁集)可以帮助 Google 解决您的问题。
      • 如果问题是功能请求,请提供有关提议功能的明确详细信息,包括解决的问题和设计注意事项。
    3. 单击创建。该错误报告是为了供 Google 审核而创建的。

要了解如何跟踪错误状态,请参阅跟踪错误状态

错误组件

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

安全

如果您发现影响 Android 或 Pixel 设备中组件安全的问题,请按照报告安全问题中的说明提交错误。此外,安全漏洞也符合Android 和 Google 设备奖励计划的资格。

平台

如果您遇到影响 Android 平台某个方面的问题或功能请求,请通过单击相关组件区域旁边的错误图标来提交错误:

浏览所有平台问题

浏览错误提交错误
无障碍
艺术
浏览器
CTS
框架
图形
内核(GKI)
16kB
媒体
即时应用程序
利伯核
联网
系统
通用系统映像
文本
事物
穿

Android 开发者工具

如果您遇到影响 Android 开发人员工具某个方面的问题或功能请求,请通过单击下表中相关组件区域旁边的错误图标来提交错误。

浏览所有开发人员工具问题

浏览错误细节提交错误
亚行
安卓工作室Android Studio 错误的特定信息
C++ Android Studio 中的问题
模拟器或系统映像模拟器错误的特定信息
摇篮Gradle bug 的特定信息
应用更改特定于“应用更改”错误的信息
皮棉
NDK NDK 编译器或构建系统问题。不适用于 API 请求或错误。 API 是操作系统的一部分,与它们相关的请求应提交到上述平台组件之一中(如果您不知道是哪个,请使用框架)。
分析器
喷气背包 (androidx)
Jetpack (androidx) 测试
游戏SDK

文档

如果您遇到影响 Android 文档某个方面的问题或功能请求,请通过单击相关组件区域旁边的错误图标来提交错误:

浏览错误提交错误
developer.android.com (应用程序开发人员文档)
source.android.com (AOSP 文档)

DMA 互操作性请求

如果您想提交 Android 的 DMA 互操作性请求,请使用相关组件区域:

提出请求浏览请求
创建新的公共请求公众要求
创建新的私人请求

跟踪错误状态

新创建的错误始终标记为New状态。 AOSP 维护人员通过更改错误状态并可能将其分配给某人来定期审查和分类错误。错误被分为三类之一:

  • 需要更多信息。错误报告没有足够的信息供某人确定错误的优先级或正确分析错误。错误报告会放在列表中( New + Hotlist:NeedsInfo ),直到您提供所请求的信息。一段时间后,如果没有提供其他信息,该错误将被赋予一个状态,表明不会对其采取行动。

  • 该错误已分配给某人,并且可以选择重新确定优先级。该错误报告已被认为是对合法问题的充分详细的报告。错误的优先级已正确确定或重新确定了优先级。最后,该错误被分配给特定的贡献者进行评估和分析。

    通常,错误会保持“已分配”状态,直到有人打算解决该错误为止,此时该错误将被分配为“已接受”状态。但是,受让人可能不会将错误的状态更改为“已接受” ,而只是修复错误并分配“已修复”“已修复”(已验证)状态。

  • 该错误不会被采取行动。出于多种原因,错误属于此类别,例如该错误是另一个错误的重复,该错误无法修复,或者该错误代表了按预期工作的功能。

跟踪错误状态:

  1. 打开错误并查看优先级、状态和评论字段。有关优先级和状态的说明,请参阅问题字段
  2. (可选)回复评论字段中的任何问题或评论。

标有“已修复”(已验证)状态的错误将包含在 Android 的未来版本中。

特定状态的附加信息

以下是一些错误状态的进一步说明(除了问题跟踪器问题字段文档中提供的信息之外):

  • 无法修复(预期行为): AOSP 维护者已确定所描述的行为不是错误,而是预期行为。此状态通常也称为“按预期工作 (WAI)”。对于功能请求,AOSP 维护人员已确定该请求不会在 Android 中实现。

  • 无法修复(不可行):解决问题所需的更改不太可能。此状态还用于报告无法在 AOSP 中处理的问题,通常是因为它与自定义设备或外部应用程序相关,或者报告者将问题跟踪器误认为是帮助论坛。

  • 已修复(已验证):此错误已修复,并包含在正式版本中。

  • 已修复:此错误已在源代码树中修复(或实现了功能),但可能尚未包含在正式版本中。