报告和跟踪错误

您可以使用 Google Issue Tracker 报告问题和请求新功能,从而帮助改进 Android。Google Issue Tracker 是 Google 用来跟踪 AOSP 问题和功能请求的工具。Issue Tracker 在 Google 外部提供,供需要与 Google 团队协作处理特定问题和功能的外部公共用户和合作伙伴用户使用。

要了解 Google Issue Tracker 的基本知识,请参阅 Google Issue Tracker

报告错误

要报告 AOSP 错误

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

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

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

      • 如果问题是错误,请在评论中包含重现该错误的步骤。仅说明某些内容无法正常工作的评论可能需要更多信息。您提供的详细程度(包括日志文件甚至补丁程序集)有助于 Google 解决您的问题。
      • 如果问题是功能请求,请提供有关建议功能的明确详细信息,包括解决的问题和设计考虑因素。
    3. 点击创建。系统会创建错误报告,供 Google 审核。

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

错误组件

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

安全性

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

平台

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

浏览所有平台问题

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

Android 开发者工具

如果您有影响 Android 开发者工具某个方面的问题或功能请求,请点击下表相关组件区域旁边的错误图标提交错误。

浏览所有开发者工具问题

浏览错误 详情 提交错误
adb
Android Studio Android Studio 错误专用信息
C++ Android Studio 中的问题
模拟器或系统映像 模拟器错误专用信息
Gradle Gradle 错误专用信息
应用更改 应用更改错误专用信息
Lint
NDK NDK 编译器或构建系统问题。不适用于 API 请求或错误。API 是操作系统的一部分,与 API 相关的请求应在上述平台组件之一中提交(如果您不知道使用哪个组件,请使用框架)。
性能分析器
Jetpack (androidx)
Jetpack (androidx) 测试
Games SDK

文档

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

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

DMA 互操作性请求

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

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

跟踪错误状态

新创建的错误始终标记为新建状态。AOSP 维护人员会定期审核和分类错误,方法是更改错误状态并可能将其分配给某人。错误分为以下三类

  • 需要更多信息。错误报告没有足够的信息供某人确定优先级或正确分析错误。错误报告会放在列表(新建 + Hotlist:NeedsInfo)中,直到您提供请求的信息为止。经过一段时间后,如果未提供其他信息,则错误会被赋予一个状态,表明不会对其采取任何措施。

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

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

  • 错误将不会被处理。错误属于此类别的原因有多种,例如,错误是另一个错误的副本、错误不可修复或错误表示按预期运行的功能。

要跟踪错误状态

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

标记为已修复(已验证)状态的错误包含在 Android 的未来版本中。

特定状态的附加信息

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

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

  • 不予修复(不可行):解决问题所需的更改在合理程度上是不可行的。此状态也用于报告的无法在 AOSP 中处理的问题,通常是因为它与自定义设备或外部应用相关,或者报告者误将 Issue Tracker 当作帮助论坛。

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

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