Reportar e rastrear bugs

Você pode ajudar a melhorar o Android relatando problemas e solicitando novos recursos usando o Google Issue Tracker . Google Issue Tracker é uma ferramenta usada pelo Google para rastrear problemas de AOSP e solicitações de recursos. O Issue Tracker está disponível fora do Google para uso público externo e usuários parceiros que precisam colaborar com as equipes do Google em questões e recursos específicos.

Para aprender os conceitos básicos do Google Issue Tracker, consulte Google Issue Tracker .

Reportar um erro

Para relatar um bug AOSP:

  1. Tendo todos os bugs abertos como base para sua pesquisa, use o campo de pesquisa do Issue Tracker para ver se alguém já relatou seu problema ou recurso. Não se esqueça de pesquisar também bugs fechados e corrigidos. Para ajudá-lo a encontrar os resultados mais populares, classifique o resultado por número de estrelas. Para obter detalhes sobre como usar o campo de pesquisa, consulte Pesquisas de problemas
  2. Se você encontrar o 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 sua prioridade.
  3. Se ninguém relatou seu problema, crie um novo bug.

    1. Consulte a seção deste documento relacionada ao componente do seu bug. Os componentes do bug identificam a área do Android à qual o bug se aplica.

    2. Preencha o modelo fornecido:

      • Se o problema for um bug, inclua as etapas para reproduzir o bug nos comentários. Um comentário que apenas afirma que algo não está funcionando provavelmente exigirá mais informações. A quantidade de detalhes que você fornece, incluindo arquivos de log e até mesmo um conjunto de patches, ajuda o Google a resolver seu 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.
    3. Clique em Criar . O relatório do bug é criado para revisão do Google.

Para saber como rastrear o status do bug, consulte Rastrear o status do bug .

Componentes de bugs

As quatro seções a seguir foram projetadas para ajudá-lo a procurar e relatar bugs usando o componente correto.

Segurança

Se você encontrar um problema que afete a segurança do Android ou dos componentes dos dispositivos Pixel, registre um bug seguindo as instruções em Relatar problemas de segurança . Além disso, bugs de segurança são elegíveis para o Programa de recompensa de dispositivos Android e Google .

Plataforma

Se você tiver um problema ou solicitação de recurso que afete um aspecto da plataforma Android, registre seu bug clicando no ícone de bug próximo à área do componente relevante:

Procure todos os problemas da plataforma

Procure bugs Registrar um bug
Acessibilidade
ARTE
Navegador
CTS
Estrutura
Gráficos
Kernel (GKI)
meios de comunicação
Aplicativos instantâneos
Libcore
Rede
Sistema
Imagem genérica do sistema
Texto
Coisas
Vestir

Ferramentas para desenvolvedores Android

Se você tiver um problema ou solicitação de recurso que afeta um aspecto das ferramentas para desenvolvedores do Android, registre seu bug clicando no ícone de bug próximo à área do componente relevante na tabela a seguir.

Procure todos os problemas das ferramentas do desenvolvedor

Procure bugs Detalhes Registrar um bug
adb
Estúdio Android Informações específicas para bugs do Android Studio
C++ Problemas no Android Studio
Emulador ou imagens do sistema Informações específicas para bugs do emulador
Gradle Informações específicas para bugs do Gradle
Aplicar mudanças Informações específicas para bugs do Apply Changes
Fiapos
NDK Problemas no compilador NDK ou no sistema de compilação. Não para solicitações de API ou bugs. APIs fazem parte do SO, e as solicitações relacionadas a elas devem ser arquivadas em um dos componentes da Plataforma acima (caso não saiba qual, use Framework).
Criadores de perfil
Jetpack (androidx)
Teste Jetpack (androidx)
SDK de jogos

Documentação

Se você tiver um problema ou solicitação de recurso que afete um aspecto da documentação do Android, registre seu bug clicando no ícone do bug próximo à área do componente relevante:

Procure bugs Registrar um bug
developer.android.com (documentação do desenvolvedor de aplicativos)
source.android.com (documentação AOSP)

Solicitação de interoperabilidade DMA

Se você quiser enviar uma solicitação de interoperabilidade DMA para Android, use a área de componentes relevante:

Faça uma solicitação Procurar solicitações
Crie uma nova solicitação pública Solicitações públicas
Crie uma nova solicitação privada

Rastrear o status do bug

Bugs recém-criados são sempre marcados com o status New . Os mantenedores do AOSP revisam e fazem a triagem periodicamente de bugs, alterando seu status e potencialmente atribuindo-os a alguém. Os bugs são triados em uma das três categorias:

  • Precisa de mais informações. O relatório do bug não contém informações suficientes para alguém priorizar ou analisar adequadamente o bug. O relatório de bug é colocado em uma lista ( New + Hotlist:NeedsInfo ) até que você forneça as informações solicitadas. Após algum período de tempo, se nenhuma informação adicional for fornecida, o bug receberá um status indicando que não será resolvido.

  • O bug é atribuído a alguém e, opcionalmente, repriorizado. O relatório de bug foi reconhecido como um relatório adequadamente detalhado de um problema legítimo. O bug é priorizado adequadamente ou repriorizado. Finalmente, o bug é atribuído a um contribuidor específico para avaliação e análise.

    Normalmente, um bug permanece como Atribuído até que alguém pretenda resolvê-lo, momento em que ele recebe o status de Aceito . No entanto, um responsável pode não alterar o status de um bug para Aceito e, em vez disso, apenas corrigir o bug e atribuir um status Fixo ou Fixo (verificado) .

  • O bug não será resolvido. Um bug se enquadra nesta categoria por vários motivos, como o bug ser uma duplicata de outro bug, o bug ser inviável de ser corrigido ou o bug representar uma funcionalidade que está funcionando conforme o esperado.

Para rastrear o status do bug:

  1. Abra o bug e observe os campos de prioridade, status e comentários. Para obter explicações sobre prioridade e status, consulte os campos do problema .
  2. (opcional) responda a quaisquer perguntas ou comentários no campo de comentários.

Bugs marcados com status Corrigido (verificado) serão incluídos em uma versão futura do Android.

Informações adicionais para status específicos

A seguir estão explicações adicionais para alguns status de bugs (além das informações fornecidas na documentação dos campos de problemas do Issue Tracker):

  • Não corrigirá (comportamento pretendido): Um mantenedor do AOSP determinou que o comportamento descrito não é um bug, mas é o comportamento pretendido. Esse status também é comumente referido como "trabalhando conforme pretendido (WAI)". Para solicitações de recursos, um mantenedor do AOSP determinou que a solicitação não será implementada no Android.

  • Não resolverá (Inviável): As mudanças necessárias para resolver o problema não são razoavelmente possíveis. Esse status também é usado para problemas relatados que não podem ser tratados no AOSP, normalmente porque estão relacionados a um dispositivo personalizado ou a um aplicativo externo, ou porque o relator confundiu o Issue Tracker com um fórum de ajuda.

  • Corrigido (verificado): Este bug foi corrigido e está incluído em uma versão formal.

  • Corrigido: Este bug foi corrigido (ou recurso implementado) em uma árvore de código-fonte, mas pode ainda não ter sido incluído em uma versão formal.