Partilhar via

Quando e como devo criar um relatório de bugs?

  • Artigo

Dica

Use o item de menu Relatar um problema no Visual Studio – isso enviará informações de diagnóstico junto com o relatório de bugs para ajudar a resolve o problema.

Há instruções detalhadas para Visual Studio 2019 ou Visual Studio 2017 e Visual Studio para Mac.

Você pode pesquisar relatórios existentes no site do Visual Studio Developer Community.

Registre um bug se...

Você tem um conjunto de etapas que acha que os engenheiros poderão usar para reproduzir um problema.

OU

Você pode descrever cuidadosamente os sintomas visíveis do problema, especialmente se também puder descrever algumas circunstâncias precisas relacionadas ao problema. [1]

Práticas recomendadas para ajudar a resolver bugs de forma rápida e eficiente

  1. Pesquise no Visual Studio Developer Community e na Web para obter relatórios de bugs ou sugestões de uso existentes que possam resolver o problema diretamente.[2][3]

  2. Descreva o problema da forma mais clara e concisa possível, incluindo uma descrição do que aconteceu e era esperado que acontecesse.

  3. Inclua quaisquer rastreamentos de pilha relevantes, texto de mensagem de erro ou logs de falha (se você usar o recurso Relatar um problema , eles poderão ser incluídos automaticamente). [4]

  4. Anote todas as mensagens de erro importantes que aparecem em anexos de captura de tela como texto sem formatação também.

  5. Inclua um pequeno caso de teste autocontido que reproduza o bug com o mínimo de código possível. Se você não puder reproduzir o problema com um novo projeto (criado usando um dos modelos internos), compacte um projeto que demonstre o problema e anexe-o ao relatório de bugs. Torne o projeto de exemplo o mais simples possível antes de anexá-lo. [5][6]

  6. Descreva o ambiente em que o bug foi encontrado, incluindo o sistema operacional e as versões do Xamarin e quaisquer dependências.

Detalhes adicionais

  1. ^ Idealmente, a descrição dos "sintomas visíveis" deve incluir detalhes suficientes para que outros clientes possam confirmar se estão vendo o mesmo problema (mesmas mensagens de erro, mesma degradação de desempenho, mesmo rastreamento de pilha de uma falha etc.). Para "circunstâncias precisas", um bom exemplo seria se você dissesse algo como: "Eu normalmente atingi o problema 75% do tempo, mas se eu mudar essa única coisa, então eu posso evitar o problema completamente." Outro exemplo semelhante de uma "circunstância precisa" é se o downgrade para uma versão anterior do Xamarin interromper o problema.

  2. ^ Como seria de esperar, snippets de texto de erro (ou qualquer outro texto exclusivamente descritivo) geralmente são os melhores termos de pesquisa. Se o relatório de bugs existente estiver incompleto, você será bem-vindo a adicionar detalhes ou registrar um relatório de bugs novo e melhor.

  3. ^ Outra boa pergunta é se o mesmo problema foi relatado para qualquer aplicativo Java, Objective-Cou Swift. Nesse caso, o problema provavelmente faz parte do Android ou iOS em si, em vez de fazer parte do Xamarin.

  4. ^ Alguns exemplos de informações a serem incluídas:

    1. Para erros que ocorrem ao criar um projeto, inclua a saída completa do build de diagnóstico no relatório de bugs.

    2. Para erros que ocorrem ao compilar ou depurar um projeto iOS do Visual Studio, execute a Ajuda > Xamarin > Zip Logs depois de atingir o erro e incluir o arquivo de .zip resultante no relatório de bugs.

    3. Para exceções ou falhas em aplicativos Android ou iOS, inclua os logs de depuração relevantes para aplicativos Xamarin.Android e Xamarin.iOS.

  5. ^ Se possível para seu problema específico, uma opção é recriar o problema adicionando um pequeno número de arquivos de sua solução original em uma solução totalmente nova. A equipe do Xamarin geralmente poderá investigar problemas mesmo em casos de teste maiores (supondo que as etapas para reproduzir sejam explicadas claramente), mas casos de teste mais simples oferecem a melhor chance de que o bug seja resolvido rapidamente.

  6. ^ Se não for possível reproduzir o problema adicionando um pequeno número de arquivos a uma nova solução, você poderá compactar e anexar toda a pasta da solução para seu aplicativo completo. Exclua as binpastas , objComponents, e packages para tornar o arquivo zip menor. (O IDE e o processo de build geralmente restaurarão ou recriarão o conteúdo dessas pastas conforme necessário.) Você também pode excluir quantos arquivos de código e recurso desejar, desde que a solução resultante ainda demonstre o problema original.