Robert Ly | 35f2fda | 2013-01-29 16:27:05 -0800 | [diff] [blame] | 1 | page.title=Report Bugs |
| 2 | @jd:body |
| 3 | |
| 4 | <!-- |
Clay Murphy | 768b82a | 2013-11-12 11:32:41 -0800 | [diff] [blame] | 5 | Copyright 2013 The Android Open Source Project |
Robert Ly | 35f2fda | 2013-01-29 16:27:05 -0800 | [diff] [blame] | 6 | |
| 7 | Licensed under the Apache License, Version 2.0 (the "License"); |
| 8 | you may not use this file except in compliance with the License. |
| 9 | You may obtain a copy of the License at |
| 10 | |
| 11 | http://www.apache.org/licenses/LICENSE-2.0 |
| 12 | |
| 13 | Unless required by applicable law or agreed to in writing, software |
| 14 | distributed under the License is distributed on an "AS IS" BASIS, |
| 15 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 16 | See the License for the specific language governing permissions and |
| 17 | limitations under the License. |
| 18 | --> |
| 19 | <div id="qv-wrapper"> |
| 20 | <div id="qv"> |
| 21 | <h2>In this document</h2> |
| 22 | <ol id="auto-toc"> |
| 23 | </ol> |
| 24 | </div> |
| 25 | </div> |
| 26 | <p>Thanks for your interest in Android! One of the best ways you can help us |
| 27 | improve Android is to let us know about any problems you find with it.</p> |
| 28 | <p>First, though: if you think you've found a security vulnerability, |
| 29 | <em>please don't use the forms below</em>. Using the public forms below may |
| 30 | allow anyone to see your report, which may put users at risk until the bug is |
| 31 | fixed. Please visit |
| 32 | <a href="{@docRoot}source/faqs.html">our |
| 33 | security faq</a> for more information on reporting security vulnerabilities |
| 34 | to the Android security team.</p> |
| 35 | <p>Here's how to report non-security bugs:</p> |
| 36 | <ul> |
| 37 | <li> |
Jean-Baptiste Queru | 05437cd | 2013-06-18 15:46:06 -0700 | [diff] [blame] | 38 | <p><a href="https://code.google.com/p/android/issues/advsearch">Search for |
| 39 | your bug</a> to see if anyone has already reported it. Don't forget to |
| 40 | search for all issues, not just open ones, as your issue might already |
| 41 | have been reported and closed. To help find the most popular results, |
| 42 | sort the result by number of stars.</p> |
Robert Ly | 35f2fda | 2013-01-29 16:27:05 -0800 | [diff] [blame] | 43 | </li> |
| 44 | <li> |
| 45 | <p>If you find your issue and it's important to you, star it! That's how we know which bugs are most important to fix.</p> |
| 46 | </li> |
| 47 | <li> |
| 48 | <p>If no one's reported your bug, file the bug. You can use one of these templates:</p> |
| 49 | <ul> |
| 50 | <li> |
| 51 | <p><a href="https://code.google.com/p/android/issues/entry?template=User%20bug%20report">Bug in your Device</a> - use this if you are a user reporting a bug in a device you own</p> |
| 52 | </li> |
| 53 | <li> |
| 54 | <p><a href="https://code.google.com/p/android/issues/entry?template=Developer%20bug%20report">Bug in the Software</a> - use this if you found a bug in the course of developing an app</p> |
| 55 | </li> |
| 56 | <li> |
| 57 | <p><a href="https://code.google.com/p/android/issues/entry?template=Feature%20request">Feature Request</a> - use this for a feature you'd like to see in a future verison</p> |
| 58 | </li> |
| 59 | </ul> |
| 60 | </li> |
| 61 | </ul> |
Jean-Baptiste Queru | 05437cd | 2013-06-18 15:46:06 -0700 | [diff] [blame] | 62 | <p>Keep in mind that an issue tracker is not a user support forum. It is a list |
| 63 | of pending technical tasks, along with information relevant for those tasks, |
| 64 | and information about progress on those tasks including which ones might |
| 65 | get worked on in the short term.</p> |
| 66 | <p>This issue tracker is narrowly focused on the Android Open Source Project. |
| 67 | Issues with retail devices need to be reported through those devices' support |
| 68 | channels, especially for devices other than Nexus. Issues with applications |
| 69 | that aren't part of AOSP need to be reported with those applications' |
| 70 | developers; that is also the case for Google applications.</p> |
Robert Ly | 35f2fda | 2013-01-29 16:27:05 -0800 | [diff] [blame] | 71 | <p>Please note that we can't guarantee that any particular bug can be fixed in |
| 72 | any particular release. To see what happens to your bug once you report it, |
| 73 | read <a href="life-of-a-bug.html">Life of a Bug</a>.</p> |
| 74 | <p>In general, please put as much info in bugs as you can. Just a one liner |
| 75 | telling us something isn't working is usually useless, and will probably be |
| 76 | closed without any action. The more detail you provide, the more likely your |
| 77 | issue is to be resolved. Below, there are some examples of a good bug report |
| 78 | and a poor bug report.</p> |
| 79 | |
| 80 | <h2 id="a-poor-bug-report">A Poor Bug Report</h2> |
| 81 | <pre> |
| 82 | Title: Error message |
| 83 | |
| 84 | When running Eclipse I get an "Internal Error" that says "See the .log file for more details". |
| 85 | |
| 86 | Steps to reproduce: |
| 87 | Happens when "Object o = null". Doesn't happen when changed to "Object o". |
| 88 | |
| 89 | Expected results: |
| 90 | I wouldn't get the error message--would work with Object o = null. |
| 91 | |
| 92 | Observed results: |
| 93 | See above. |
| 94 | </pre> |
| 95 | <p>This is a poor bug report because it doesn't provide any context for the |
| 96 | issue; is it a problem in the Dalvik virtual machine, the core framework, or |
| 97 | something else? It also doesn't provide any code or hint on how to reproduce |
| 98 | it. In other words, this bug report doesn't provide enough information for |
| 99 | anyone to take action on, so it would be ignored.</p> |
| 100 | <h2 id="a-good-bug-report">A Good Bug Report</h2> |
| 101 | <pre> |
| 102 | Title: Stepping over "Object o = null" causes Eclipse "Internal Error" |
| 103 | |
| 104 | Interesting bug, while using Eclipse 3.3.1.1 with m37a of android and the following code: |
| 105 | |
| 106 | package com.saville.android; |
| 107 | |
| 108 | import android.app.Activity; |
| 109 | import android.os.Bundle; |
| 110 | import android.util.Log; |
| 111 | |
| 112 | public class TestObjectNull extends Activity { |
| 113 | /** Called when the activity is first created. */ |
| 114 | @Override |
| 115 | public void onCreate(Bundle icicle) { |
| 116 | super.onCreate(icicle); |
| 117 | setContentView(R.layout.main); |
| 118 | |
| 119 | Object o = null; |
| 120 | |
| 121 | o = "hi"; |
| 122 | |
| 123 | Log.v(TAG, "o=" + o); |
| 124 | } |
| 125 | |
| 126 | static final String TAG = "TestObjectNull"; |
| 127 | } |
| 128 | |
| 129 | Eclipse indicates an "Internal Error" with "See the .log file for more |
| 130 | details" and then asks if I want to exit the workbench. This occurs when I |
| 131 | place a break point on "setContentView(R.layout.main);" and then single |
| 132 | step over "Object o = null;" |
| 133 | |
| 134 | If I change "Object o = null;" to "Object o" all is well. |
| 135 | |
| 136 | The last lines of the .log file are: |
| 137 | |
| 138 | !ENTRY org.eclipse.core.jobs 4 2 2008-01-01 13:04:15.825 |
| 139 | !MESSAGE An internal error occurred during: "has children update". |
| 140 | !STACK 0 |
| 141 | java.lang.InternalError: Invalid signature: "<null>" |
| 142 | at |
| 143 | org.eclipse.jdi.internal.TypeImpl.signatureToTag(TypeImpl.java:307) |
| 144 | at |
| 145 | org.eclipse.jdi.internal.LocalVariableImpl.tag(LocalVariableImpl.java:185) |
| 146 | at |
| 147 | org.eclipse.jdi.internal.StackFrameImpl.getValues(StackFrameImpl.java:128) |
| 148 | at |
| 149 | org.eclipse.jdi.internal.StackFrameImpl.getValue(StackFrameImpl.java:73) |
| 150 | at |
| 151 | org.eclipse.jdt.internal.debug.core.model.JDILocalVariable.retrieveValue(JDILocalVariable.java:57) |
| 152 | at |
| 153 | org.eclipse.jdt.internal.debug.core.model.JDIVariable.getCurrentValue(JDIVariable.java:66) |
| 154 | at |
| 155 | org.eclipse.jdt.internal.debug.core.model.JDIVariable.getValue(JDIVariable.java:88) |
| 156 | at |
| 157 | org.eclipse.debug.internal.ui.model.elements.VariableContentProvider.hasChildren(VariableContentProvider.java:62) |
| 158 | at |
| 159 | org.eclipse.jdt.internal.debug.ui.variables.JavaVariableContentProvider.hasChildren(JavaVariableContentProvider.java:73) |
| 160 | at |
| 161 | org.eclipse.debug.internal.ui.model.elements.ElementContentProvider.updateHasChildren(ElementContentProvider.java:223) |
| 162 | at |
| 163 | org.eclipse.debug.internal.ui.model.elements.ElementContentProvider$3.run(ElementContentProvider.java:200) |
| 164 | at org.eclipse.core.internal.jobs.Worker.run(Worker.java:55) |
Jean-Baptiste Queru | 05437cd | 2013-06-18 15:46:06 -0700 | [diff] [blame] | 165 | </pre> |