报告 Bug

感谢你对 Android 的兴趣！你能够帮助我们改善 Android 最好的一个方法是让我们知道关于你在它上面发现的任何问题。

首先，虽然：假如你想你已经发现一个安全漏洞，请不要用下面的形式。用下面可能允许任何人看你的报告的公开的形式，可能置用户在风险知道 bug 被修复。请访问我们的安全常见问题更多信息在报告安全漏洞给 Android 安全团队上。

这是如何报告非安全 bugs：

• 搜索你的 bug 看假如任何人已经报告了它。

• 假如你发现你的问题和它对你是重要的，开始它！这是我们如何知道 bugs 是最重要来修复。

• 假如没有人报告你的 bug，归档 bug。你能用这些模板中的一个：

  • 在你的设备里的 Bug - 用着个，假如你是一个用户报告一个你拥有的一个设备里的 bug

  • 在软件里的 Bug - 用这个，假如你发现一个在开发一个应用期间

  • 功能要求 - 用着个，你想在未来的版本看到一个特征

请注意，我们不能保证任何特定的 bug 能被修复在任何特别的发布。看一旦你报告你的 bug 发生了什么，读一个 Bug 的生命.

一般，请尽你所能提供关于 bug 的更多信息。仅仅一个单行告诉我们一些东西是不能工作是常常无用的，和将多半关闭没有任何行动。你提供更多细节，更有可能你的问题被解决。下面，这些是一些例子，一个好的 bug 报告和一个差的 bug 报告.

一个差的 Bug 报告

Title: Error messageWhen running Eclipse I get an "Internal Error" that says "See the .log file for more details".Steps to reproduce:Happens when "Object o = null". Doesn't happen when changed to "Object o".Expected results:I wouldn't get the error message--would work with Object o = null.Observed results:See above.

标题：错误信息当我运行 Eclipse，我获得一个"内部错误"，这说"更多详情看 .log 文件"。重现步骤：当"Object o = null"时发生。当改变为"Object o"时不发生。预期结果：我不想获得这错误消息--像工作用 Object o = null。观察结果：看上面。

这是一个差的报告，因为它没有提供这个问题的一些环境；它是在 Dalvik 虚拟机里的一个问题，核心框架，或别的一些东西？它也没有提供一些代码或暗示如何重现它。换句话说，这个 bug 报告没提供足够信息让任何人执行，所以它将被忽略。

一个好的 Bug 报告

Title: Stepping over "Object o = null" causes Eclipse "Internal Error"Interesting bug, while using Eclipse 3.3.1.1 with m37a of android and the following code:package com.saville.android;import android.app.Activity;import android.os.Bundle;import android.util.Log;public class TestObjectNull extends Activity {    /** Called when the activity is first created. */    @Override    public void onCreate(Bundle icicle) {        super.onCreate(icicle);        setContentView(R.layout.main);        Object o = null;        o = "hi";        Log.v(TAG, "o=" + o);    }    static final String TAG = "TestObjectNull";}Eclipse indicates an "Internal Error" with "See the .log file for moredetails" and then asks if I want to exit the workbench. This occurs when Iplace a break point on "setContentView(R.layout.main);" and then singlestep over "Object o = null;"If I change "Object o = null;" to "Object o" all is well.The last lines of the .log file are:!ENTRY org.eclipse.core.jobs 4 2 2008-01-01 13:04:15.825!MESSAGE An internal error occurred during: "has children update".!STACK 0java.lang.InternalError: Invalid signature: "<null>"        atorg.eclipse.jdi.internal.TypeImpl.signatureToTag(TypeImpl.java:307)        atorg.eclipse.jdi.internal.LocalVariableImpl.tag(LocalVariableImpl.java:185)        atorg.eclipse.jdi.internal.StackFrameImpl.getValues(StackFrameImpl.java:128)        atorg.eclipse.jdi.internal.StackFrameImpl.getValue(StackFrameImpl.java:73)        atorg.eclipse.jdt.internal.debug.core.model.JDILocalVariable.retrieveValue(JDILocalVariable.java:57)        atorg.eclipse.jdt.internal.debug.core.model.JDIVariable.getCurrentValue(JDIVariable.java:66)        atorg.eclipse.jdt.internal.debug.core.model.JDIVariable.getValue(JDIVariable.java:88)        atorg.eclipse.debug.internal.ui.model.elements.VariableContentProvider.hasChildren(VariableContentProvider.java:62)        atorg.eclipse.jdt.internal.debug.ui.variables.JavaVariableContentProvider.hasChildren(JavaVariableContentProvider.java:73)        atorg.eclipse.debug.internal.ui.model.elements.ElementContentProvider.updateHasChildren(ElementContentProvider.java:223)        atorg.eclipse.debug.internal.ui.model.elements.ElementContentProvider$3.run(ElementContentProvider.java:200)        at org.eclipse.core.internal.jobs.Worker.run(Worker.java:55)

标题:加强 "Object o = null"，原因 Eclipse "内部错误"有趣的 bug，当用 Eclipse 3.3.1.1 关于 m37a 的 android 和下面的代码：package com.saville.android;import android.app.Activity;import android.os.Bundle;import android.util.Log;public class TestObjectNull extends Activity {    /** 当活动第一次被创建时调用。 */    @Override    public void onCreate(Bundle icicle) {        super.onCreate(icicle);        setContentView(R.layout.main);        Object o = null;        o = "hi";        Log.v(TAG, "o=" + o);    }    static final String TAG = "TestObjectNull";}Eclipse 指示一个"内部错误"同"更多细节看 .log 文件"，并且然后问我是否要退出工作台。这发生在当我放一个断点在"setContentView(R.layout.main);"和然后单步到"Object o = null;"假如我改变"Object o = null;"为"Object o"一切都好。.log 文件的最后几行是：!ENTRY org.eclipse.core.jobs 4 2 2008-01-01 13:04:15.825!MESSAGE An internal error occurred during: "has children update".!STACK 0java.lang.InternalError: Invalid signature: "<null>"        atorg.eclipse.jdi.internal.TypeImpl.signatureToTag(TypeImpl.java:307)        atorg.eclipse.jdi.internal.LocalVariableImpl.tag(LocalVariableImpl.java:185)        atorg.eclipse.jdi.internal.StackFrameImpl.getValues(StackFrameImpl.java:128)        atorg.eclipse.jdi.internal.StackFrameImpl.getValue(StackFrameImpl.java:73)        atorg.eclipse.jdt.internal.debug.core.model.JDILocalVariable.retrieveValue(JDILocalVariable.java:57)        atorg.eclipse.jdt.internal.debug.core.model.JDIVariable.getCurrentValue(JDIVariable.java:66)        atorg.eclipse.jdt.internal.debug.core.model.JDIVariable.getValue(JDIVariable.java:88)        atorg.eclipse.debug.internal.ui.model.elements.VariableContentProvider.hasChildren(VariableContentProvider.java:62)        atorg.eclipse.jdt.internal.debug.ui.variables.JavaVariableContentProvider.hasChildren(JavaVariableContentProvider.java:73)        atorg.eclipse.debug.internal.ui.model.elements.ElementContentProvider.updateHasChildren(ElementContentProvider.java:223)        atorg.eclipse.debug.internal.ui.model.elements.ElementContentProvider$3.run(ElementContentProvider.java:200)        at org.eclipse.core.internal.jobs.Worker.run(Worker.java:55)