Home | History | Annotate | Download | only in source
      1 <html devsite>
      2   <head>
      3     <title>Reporting Bugs</title>
      4     <meta name="project_path" value="/_project.yaml" />
      5     <meta name="book_path" value="/_book.yaml" />
      6   </head>
      7   <body>
      8   <!--
      9       Copyright 2017 The Android Open Source Project
     10 
     11       Licensed under the Apache License, Version 2.0 (the "License");
     12       you may not use this file except in compliance with the License.
     13       You may obtain a copy of the License at
     14 
     15           http://www.apache.org/licenses/LICENSE-2.0
     16 
     17       Unless required by applicable law or agreed to in writing, software
     18       distributed under the License is distributed on an "AS IS" BASIS,
     19       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     20       See the License for the specific language governing permissions and
     21       limitations under the License.
     22   -->
     23 <p>
     24 Thank you for your interest in Android! You can help improve Android by
     25 reporting issues and feature requests in the
     26 <a href="https://issuetracker.google.com/issues/new?component=190923">Android Issue
     27 Tracker</a>. The Android Issue Tracker contains a list of pending technical
     28 tasks across a variety of topics, information relevant to those tasks, and
     29 information about progress on those tasks, including which ones might get worked
     30 on in the short term.
     31 </p>
     32 <p class="note">For more information about why we switched to Issue Tracker, see <a
     33 href="http://android-developers.googleblog.com/2017/04/a-new-issue-tracker-for-our-aosp.html">this
     34 blog post</a>.</p>
     35 <p>
     36 Issue Tracker is not a customer support forum. For support information, see the
     37 <a href="https://support.google.com/nexus">Nexus</a> and 
     38 <a href="https://support.google.com/pixelphone">Pixel</a> help centers. Support for
     39 other devices is provided by the device manufacturers or by the carriers selling
     40 those devices.
     41 </p>
     42 <p>
     43 Support for Google applications is through
     44 <a href="http://support.google.com/">Google's support site</a>. Support for
     45 third-party applications is provided by the application's developer, e.g.
     46 through the contact information provided on Google Play. For a list of more
     47 Android support resources, see our <a href="/source/community">Community page</a>.
     48 </p>
     49 <p>
     50 There are no guarantees that any particular bug can be fixed in any particular
     51 release. To see what happens to your bug once you report it, read
     52 <a href="/source/life-of-a-bug.html">Life of a Bug</a>.
     53 </p>
     54 <h2 id="filing-a-bug">Filing a bug</h2>
     55 <ol>
     56 <li><a href="https://issuetracker.google.com/issues?q=componentid:190923%2B">Search
     57 for your bug</a> to see if anyone has already reported it. Don't forget to
     58 search for all issues, not just open ones, as your issue might already have been
     59 reported and closed. To help you find the most popular results, sort the result
     60 by number of stars.</li>
     61 <li>If you find your issue and it's important to you,
     62 <a href="https://developers.google.com/issue-tracker/guides/subscribe#starring_an_issue">star
     63 it</a>! The number of
     64 stars on a bug helps us know which bugs are most important to fix.</li>
     65 <li>If no one has reported your bug, file the bug. First,
     66 <a href="https://issuetracker.google.com/components">browse for the correct
     67 component</a>, such as <a href="https://issuetracker.google.com/issues?q=componentid:192705">Framework</a>
     68 or <a href="https://issuetracker.google.com/issues?q=componentid:192634">Networking</a>,
     69 and fill out the provided template. Or select the desired bug queue from the
     70 tables below.
     71 <p class="key-point">
     72 <strong>Tip</strong>: Some components contain sub-components, like <strong>Network &gt;
     73 Messaging</strong> and <strong>Framework &gt; Storage</strong>.
     74 </p>
     75 </li>
     76 <li>Include as much information in bugs as you can, following the instructions
     77 for the bug queue you're targeting. A bug that simply says something isn't
     78 working doesn't help much, and will probably be closed without any action. The
     79 amount of detail you provide, such as log files, repro steps, and even a patch
     80 set, helps us address your issue.</li>
     81 </ol>
     82 <h2 id="bug-queues">Bug queues</h2>
     83 <p>
     84 The Android Issue Tracker has a variety of sub-components in a number of
     85 categories related to Android. There are subcomponents for security, the
     86 platform, Android Developer Tools, documentation, and more.
     87 </p>
     88 
     89 <h3 id="security">Security</h3>
     90 <p>
     91 If you find an issue that impacts the security of Android or components in Nexus
     92 or Pixel devices, follow the instructions
     93 <a href="/security/overview/updates-resources#report-issues">here</a>.
     94 Additionally, security bugs are eligible for the
     95 <a href="https://www.google.com/about/appsecurity/android-rewards/">Android
     96 Security Vulnerability Rewards Program</a>.
     97 </p>
     98 <p>
     99 Because of the sensitive nature of security bugs, you won't be able to browse
    100 open issues, only closed issues or issues that have been made public.
    101 </p>
    102 
    103 
    104 <table>
    105   <tr>
    106    <th>Browse bugs</th>
    107    <th>Details</th>
    108    <th>File a bug</th>
    109   </tr>
    110   <tr>
    111    <td>Security</td>
    112    <td><a href="/security/overview/updates-resources#report-issues">Android Security details</a></td>
    113    <td><a href="https://issuetracker.google.com/issues/new?component=190951">
    114    <i class="material-icons">bug_report</i></a></td>
    115   </tr>
    116   <tr>
    117 </table>
    118 
    119 <h3 id="platform">Platform</h3>
    120 <p>
    121 If you find an issue that impacts an aspect of the Android platform, file your
    122 bug in one of these components.
    123 </p>
    124 <p><a class="button button-primary" href="https://issuetracker.google.com/issues?q=componentid:(192786%20%7C%20192805%20%7C%20192705%20%7C%20192792%20%7C%20192644%20%7C%20192694%20%7C%20192710%20%7C%20192810%20%7C%20192634%20%7C%20192698%20%7C%20192706%20%7C%20192815%20%7C%20192715%20%7C%20192720%20%7C%20192711%20%7C%20192629%20%7C%20192643%20%7C%20192693%20%7C%20192639)">Browse all platform issues</a></p>
    125 <table>
    126   <tr>
    127    <th>Browse bugs</th>
    128    <th>File a bug</th>
    129   </tr>
    130   <tr>
    131    <td><a href="https://issuetracker.google.com/issues?q=componentid:192629%2B">ART</a></td>
    132    <td><a href="https://issuetracker.google.com/issues/new?component=192629"><i
    133 class="material-icons">bug_report</i></a></td>
    134   </tr>
    135   <tr>
    136    <td><a href="https://issuetracker.google.com/issues?q=componentid:192693%2B">Browser</a></td>
    137    <td><a href="https://issuetracker.google.com/issues/new?component=192693"><i
    138 class="material-icons">bug_report</i></a></td>
    139   </tr>
    140   <tr>
    141    <td><a href="https://issuetracker.google.com/issues?q=componentid:192639%2B">CTS</a></td>
    142    <td><a href="https://issuetracker.google.com/issues/new?component=192639"><i
    143 class="material-icons">bug_report</i></a></td>
    144   </tr>
    145   <tr>
    146    <td><a href="https://issuetracker.google.com/issues?q=componentid:192705%2B">Framework</a></td>
    147    <td><a href="https://issuetracker.google.com/issues/new?component=192705"><i
    148 class="material-icons">bug_report</i></a></td>
    149   </tr>
    150   <tr>
    151    <td><a href="https://issuetracker.google.com/issues?q=componentid:192644%2B">GfxMedia</a></td>
    152    <td><a href="https://issuetracker.google.com/issues/new?component=192644"><i
    153 class="material-icons">bug_report</i></a></td>
    154   </tr>
    155   <tr>
    156    <td><a href="https://issuetracker.google.com/issues?q=componentid:192694%2B">Jack</a></td>
    157    <td><a href="https://issuetracker.google.com/issues/new?component=192694"><i
    158 class="material-icons">bug_report</i></a></td>
    159   </tr>
    160   <tr>
    161    <td><a href="https://issuetracker.google.com/issues?q=componentid:192710%2B">Libcore</a></td>
    162    <td><a href="https://issuetracker.google.com/issues/new?component=192710"><i
    163 class="material-icons">bug_report</i></a></td>
    164   </tr>
    165   <tr>
    166    <td><a href="https://issuetracker.google.com/issues?q=componentid:192634%2B">Networking</a></td>
    167    <td><a href="https://issuetracker.google.com/issues/new?component=192634"><i
    168 class="material-icons">bug_report</i></a></td>
    169   </tr>
    170   <tr>
    171    <td><a href="https://issuetracker.google.com/issues?q=componentid:190951%2B">Security</a></td>
    172    <td><a href="https://issuetracker.google.com/issues/new?component=190951"><i
    173 class="material-icons">bug_report</i></a></td>
    174   </tr>
    175   <tr>
    176    <td><a href="https://issuetracker.google.com/issues?q=componentid:192706%2B">System</a></td>
    177    <td><a href="https://issuetracker.google.com/issues/new?component=192706"><i
    178 class="material-icons">bug_report</i></a></td>
    179   </tr>
    180   <tr>
    181    <td><a href="https://issuetracker.google.com/issues?q=componentid:192715%2B">Text</a></td>
    182    <td><a href="https://issuetracker.google.com/issues/new?component=192715"><i
    183 class="material-icons">bug_report</i></a></td>
    184   </tr>
    185   <tr>
    186    <td><a href="https://issuetracker.google.com/issues?q=componentid:192720%2B">Things</a></td>
    187    <td><a href="https://issuetracker.google.com/issues/new?component=192720"><i
    188 class="material-icons">bug_report</i></a></td>
    189   </tr>
    190   <tr>
    191    <td><a href="https://issuetracker.google.com/issues?q=componentid:192711%2B">Wear</a></td>
    192    <td><a href="https://issuetracker.google.com/issues/new?component=192711"><i
    193 class="material-icons">bug_report</i></a></td>
    194   </tr>
    195 </table>
    196 
    197 <h3 id="developer-tools">Android Developer Tools</h3>
    198 <p>
    199 If you find an issue that impacts one of the Android Developer tools, such as
    200 Android Studio, SDK, Emulator, System Images, or Support Library, file a bug in
    201 one of these components.
    202 </p>
    203 <p>
    204 As the tools have different requirements, read the
    205 <a href="https://developer.android.com/studio/report-bugs.html">General Bug filing
    206 details</a> and the linked details for the tool.
    207 </p>
    208 
    209 <a class="button button-primary"
    210 href="http://issuetracker.google.com/issues?q=componentid:192633%2B">Browse all
    211 Developer Tools issues</a>
    212 <table>
    213   <tr>
    214    <th>Browse bugs</th>
    215    <th>Details</th>
    216    <th>File a bug</th>
    217   </tr>
    218   <tr>
    219    <td><a href="https://issuetracker.google.com/issues?q=componentid:192633%2B">Android
    220 Studio</a></td>
    221    <td><a href="https://developer.android.com/studio/report-bugs.html#studio-bugs">Android
    222 Studio details</a></td>
    223    <td><a href="https://issuetracker.google.com/issues/new?component=192708&template=840533">
    224    <i class="material-icons">bug_report</i></a></td>
    225   </tr>
    226   <tr>
    227    <td><a href="http://issuetracker.google.com/issues?q=componentid:192717%2B">C++</a></td>
    228    <td>Issues in Android Studio</td>
    229    <td><a href="https://issuetracker.google.com/issues/new?component=192717">
    230    <i class="material-icons">bug_report</i></a></td>
    231   </tr>
    232   <tr>
    233    <td><a href="http://issuetracker.google.com/issues?q=componentid:192727%2B">Emulator or
    234 System Images</a></td>
    235    <td><a href="https://developer.android.com/studio/report-bugs.html#emulator-bugs">Emulator
    236     details</a></td>
    237    <td><a href="https://issuetracker.google.com/issues/new?component=192727">
    238    <i class="material-icons">bug_report</i></a></td>
    239   </tr>
    240   <tr>
    241    <td><a href="http://issuetracker.google.com/issues?q=componentid:192709%2B">Gradle</a></td>
    242    <td><a href="https://developer.android.com/studio/report-bugs.html#build-bugs">Gradle
    243    details</a></td>
    244    <td><a href="https://issuetracker.google.com/issues/new?component=192709&template=842921">
    245    <i class="material-icons">bug_report</i></a></td>
    246   </tr>
    247   <tr>
    248    <td><a href="http://issuetracker.google.com/issues?q=componentid:192751%2B">Instant
    249 Run</a></td>
    250    <td><a href="https://developer.android.com/studio/report-bugs.html#instant-run-bugs">Instant
    251    Run details</a></td>
    252    <td><a href="https://issuetracker.google.com/issues/new?component=192751">
    253    <i class="material-icons">bug_report</i></a></td>
    254   </tr>
    255   <tr>
    256    <td colspan="2"><a href="http://issuetracker.google.com/issues?q=componentid:192718%2B">Lint</a></td>
    257    <td><a href="https://issuetracker.google.com/issues/new?component=192718">
    258    <i class="material-icons">bug_report</i></a></td>
    259   </tr>
    260   <tr>
    261    <td><a href="https://github.com/android-ndk/ndk/issues">NDK</a></td>
    262    <td>Standalone NDK issues</td>
    263    <td><a href="https://github.com/android-ndk/ndk/issues"><i class="material-icons">bug_report</i></a></td>
    264   </tr>
    265   <tr>
    266    <td colspan="2"><a href="http://issuetracker.google.com/issues?q=componentid:192722%2B">Profilers</a></td>
    267    <td><a href="https://issuetracker.google.com/issues/new?component=192722">
    268    <i class="material-icons">bug_report</i></a></td>
    269   </tr>
    270   <tr>
    271    <td colspan="2"><a href="http://issuetracker.google.com/issues?q=componentid:192731%2B">Support
    272 Library</a></td>
    273    <td><a href="https://issuetracker.google.com/issues/new?component=192731">
    274    <i class="material-icons">bug_report</i></a></td>
    275   </tr>
    276   <tr>
    277    <td colspan="2"><a href="http://issuetracker.google.com/issues?q=componentid:192735%2B">Test
    278 Support Library </a></td>
    279    <td><a href="https://issuetracker.google.com/issues/new?component=192735">
    280    <i class="material-icons">bug_report</i></a></td>
    281   </tr>
    282 </table>
    283 
    284 <h3 id="documentation">Documentation</h3>
    285 <p>
    286 If you find an issue with this site or with
    287 <a href="https://developer.android.com/">developer.android.com</a>,
    288 file a bug and a writer will help.
    289 </p>
    290 
    291 <table>
    292   <tr>
    293    <th>Browse bugs</th>
    294    <th>File a bug</th>
    295   </tr>
    296   <tr>
    297    <td><a href="http://issuetracker.google.com/issues?q=componentid:192697%2B">developer.android.com</a></td>
    298    <td><a href="https://issuetracker.google.com/issues/new?component=192697">
    299    <i class="material-icons">bug_report</i></a></td>
    300   </tr>
    301   <tr>
    302    <td><a href="http://issuetracker.google.com/issues?q=componentid:191476%2B">source.android.com</a></td>
    303    <td><a href="https://issuetracker.google.com/issues/new?component=191476">
    304    <i class="material-icons">bug_report</i></a></td>
    305   </tr>
    306 </table>
    307 
    308  </body>
    309 </html>
    310