Você pode ajudar a melhorar o Android informando problemas e solicitando novos recursos usando o Google Issue Tracker. O Google Issue Tracker é uma ferramenta usada pelo Google para rastrear problemas e solicitações de recursos no AOSP. O Issue Tracker está disponível fora do Google para uso pelo público externo e usuários parceiros que precisam colaborar com as equipes do Google em problemas e recursos específicos.
Para saber mais sobre os conceitos básicos, consulte Google Issue Tracker.
Informar um bug
Para informar um bug no AOSP, siga estas etapas:
- Com todos os bugs abertos, use o campo de pesquisa do Issue Tracker para conferir se alguém já informou sobre o problema ou recurso. Não se esqueça de também pesquisar bugs fechados ou corrigidos. Para encontrar os resultados melhor avaliados, classifique-os pelo número de estrelas. Para detalhes sobre o uso do campo de pesquisa, consulte Pesquisas de problemas
- Se encontrar seu problema e ele for importante para você, marque-o com uma estrela. O número de estrelas em um problema ajuda o Google a determinar a prioridade.
Se ninguém informou seu problema, crie um novo relatório de bug.
Consulte a seção deste documento que se refere ao componente do seu bug. Componentes de bugs identificam a área do Android a que o bug se aplica.
- Se o bug estiver relacionado à segurança, consulte Segurança.
- Se o bug estiver relacionado ao AOSP, consulte Plataforma.
- Se o bug estiver relacionado às ferramentas de desenvolvedor, consulte Ferramentas de desenvolvedor Android.
- Se o bug se referir a documentação incorreta, consulte Documentação.
Preencha o modelo fornecido:
- Se o problema for um bug, inclua as etapas para reproduzi-lo nos comentários. Um comentário que informa apenas que algo não está funcionando provavelmente vai precisar de mais informações. A quantidade de detalhes que você fornecer, como arquivos de registro e até mesmo um conjunto de patches, ajuda nossa equipe a resolver o problema.
- Se o problema for uma solicitação de recurso, forneça detalhes explícitos sobre o recurso proposto, incluindo o problema resolvido e considerações de design.
Selecione Criar. O relatório do bug será criado para que o Google o analise.
Para aprender a acompanhar o status do bug, consulte Acompanhar o status de bugs.
Componentes de bugs
As quatro seções abaixo foram criadas para ajudar você a pesquisar e informar bugs usando o componente correto.
Segurança
Se você encontrar um problema que afeta a segurança do Android ou de componentes em dispositivos Pixel, registre um bug usando as instruções em Como informar problemas de segurança. Além disso, os bugs de segurança estão qualificados para o Programa de recompensas de dispositivos Android e Google.
Plataforma
Se você tiver um problema ou solicitar um recurso que impacte um aspecto da plataforma Android, informe o bug clicando no ícone ao lado da área do componente relevante:
Procurar por todos os problemas da plataforma
Ferramentas para desenvolvedores Android
Se você tem um problema ou uma solicitação de recurso que impacta um aspecto do arquivo de ferramentas para desenvolvedores Android, informe o bug clicando no ícone ao lado da área do componente relevante na tabela abaixo.
Procurar em todos os problemas das Ferramentas para desenvolvedores
| Procurar bugs | Detalhes | Informar um bug |
|---|---|---|
| adb | bug_report | |
| Android Studio | Informações específicas para bugs do Android Studio | bug_report |
| C++ | Problemas no Android Studio | bug_report |
| Emulador ou imagens do sistema | Informações específicas para bugs do emulador | bug_report |
| Gradle | Informações específicas para bugs do Gradle | bug_report |
| Implementar mudanças | Informações específicas para bugs do recurso Implementar mudanças | bug_report |
| Lint | bug_report | |
| NDK | Problemas do compilador ou do sistema de build do NDK. Não se aplica a solicitações de API nem bugs. As APIs fazem parte do SO, e as solicitações relacionadas a elas precisam ser registradas em um dos componentes da plataforma acima. Se não souber qual, use o framework. | bug_report |
| Criadores de perfil | bug_report | |
| Jetpack (androidx) | bug_report | |
| Teste do Jetpack (androidx) | bug_report | |
| SDK do Play Games | bug_report | |
Documentação
Se você tem um problema ou uma solicitação de recurso que impacta um aspecto da documentação do Android, informe o bug clicando no ícone ao lado da área do componente relevante:
| Procurar bugs | Informar um bug |
|---|---|
developer.android.com (documentação para desenvolvedores de apps) |
bug_report |
source.android.com (documentação do AOSP) |
bug_report |
Solicitação de interoperabilidade de DMA (Área designada do mercado)
Caso você queira enviar uma solicitação de interoperabilidade de DMA para o Android, use a área do componente relevante:
| Fazer uma solicitação | Procurar solicitações |
|---|---|
| Criar uma nova solicitação pública | Solicitações públicas |
| Criar uma nova solicitação particular |
Acompanhar o status de bugs
Bugs recém criados são sempre marcados com um status de Novo. Os mantenedores do AOSP analisam e fazem a triagem periódica de bugs, mudando o status e potencialmente os atribuindo a alguém. A triagem dos bugs é feita em três categorias:
Precisa de mais informações. O relatório do bug não tem informações suficientes para que alguém priorize ou analise de maneira adequada. O relatório do bug é colocado em uma lista (Novo + Hotlist:NeedsInfo) até que você forneça as informações solicitadas. Depois de algum tempo, se não forem fornecidas mais informações, o bug recebe um status indicando que ele não será resolvido.
O bug é Atribuído a alguém e uma nova prioridade pode ser dada a ele. O relatório do bug foi reconhecido e detalhado corretamente como um problema legítimo. É dada uma prioridade adequada ou o bug é reclassificado. Por fim, o bug é atribuído a um colaborador específico para avaliação e análise.
Geralmente, um bug permanece como Atribuído até que alguém decida resolvê-lo. Então, ele recebe o status Aceito. Porém, a pessoa a quem ele foi atribuído pode não mudar o status para Aceito. Ela pode apenas corrigir o bug e depois atribuir um status de Corrigido ou Corrigido (verificado).
O bug não será resolvido. Um bug se enquadra nessa categoria por vários motivos, por exemplo, ser uma cópia de outro bug, ser inviável corrigi-lo ou representar um recurso que está funcionando como esperado.
Para acompanhar o status de bugs, siga estas etapas:
- Abra o bug e confira os campos de prioridade, status e comentários. Para explicações sobre prioridade e status, confira os Campos de problemas.
- Opcional: responda a perguntas ou comentários no campo correspondente.
Os bugs marcados com um status Corrigido (verificado) serão incluídos em uma versão futura do Android.
Mais informações para status específicos
Confira abaixo mais explicações sobre alguns status de bugs, além das informações fornecidas na documentação dos Campos de problemas do Issue Tracker:
Não corrigir (comportamento esperado): um administrador do AOSP determinou que o comportamento descrito não é um bug, mas sim o comportamento esperado. Esse status também aparece como "funcionando como esperado (WAI, na sigla em inglês)." Para solicitações de recursos, um administrador do AOSP determinou que a solicitação não será implementada no Android.
Sem correção (inviável): as mudanças necessárias para resolver o problema não são viáveis. Esse status também é usado para problemas informados que não podem ser tratados no AOSP, normalmente por serem relacionados a um dispositivo personalizado ou a um app externo. Outra opção é que o informante tenha confundido o Issue Tracker com um fórum de ajuda.
Corrigido (verificado): o bug foi corrigido e está incluído em uma versão formal.
Corrigido: o bug foi corrigido (ou o recurso foi implementado) em uma árvore de origem, mas ainda não foi incluído em uma versão formal.