Pesquisar em Unity

Um Guia para Ser um Testador Beta Eficaz

Um guia prático e um documento de referência para ajudar você a começar e aproveitar ao máximo os testes beta Unity.

Bem-vindo

Por que o teste beta é importante

Nossa equipe de controle de qualidade está empenhada em manter nossas versões estáveis, mas não conseguimos fazê-lo sem o feedback sobre as novas compilações por parte dos membros de nossa comunidade de desenvolvedores. Estamos felizes por você querer dar sua contribuição!

Para ajudar você a nos ajudar (ajudar você), criamos este guia para permitir-lhe ser o melhor beta tester possível - como fazer upload de seu projeto, como escrever um relatório de erro e muito mais. Seguindo essas etapas, você poderá fornecer as informações mais importantes que nos permitirão corrigir problemas que afetam você e o desenvolvimento de seus projetos.

Seu feedback sobre a versão beta é inestimável para nós. Analisamos todos os relatórios de erros da categoria 4 e 5 e fazemos o nosso melhor para observar categorias mais baixas (se você não tem certeza do que isso significa, veja a explicação em este post de blog). Quando validamos o erro e temos uma correção, planejamos incluí-lo em uma futura versão beta. No momento não podemos dar detalhes sobre quais erros foram corrigidos em qual versão beta, mas isso acontecerá o mais rápido possível!

Abaixo estão informações detalhadas sobre o fluxo de trabalho para enviar relatórios de bugs e feedback efetivos. Além disso, criamos um resumo dos passos mais importantes.

Se você tiver mais dúvidas sobre a versão beta, visite o fórum beta

01

Instalação e Primeiros Passos

  1. Baixe a última versão beta, diretamente como um instalador independente ou através do novo Unity Hub. Esta página também contém muitas informações e recursos beta. Você pode aprender sobre novos recursos, encontrar documentos e ferramentas úteis e se manter informado sobre os últimos concursos.
  2. Execute o instalador ou o Hub. Se você usar o instalador, certifique-se de instalar o beta em um novo diretório. Não há problema em ter várias versões do Unity, desde que estejam localizadas em diretórios individuais.
  3. Inicie um novo projeto ou faça uma cópia do projeto que você planeja usar para testar a versão beta e abra-o com a versão beta mais recente.
    • Certifique-se de criar uma cópia de backup, se você decidir executar um projeto existente na versão beta. A compatibilidade com versões anteriores não é garantida, portanto, depois de atualizar seu projeto, talvez não seja possível revertê-lo para uma versão anterior.
    • Observe que, quando Unity abre um projeto, esse projeto é automaticamente migrado para a versão Unity que você está usando. Portanto, trabalhar em uma cópia do seu projeto também economiza seu tempo, pois você evita a reimportação ao voltar à sua versão estável atual.
  4. Desenvolva como de costume e/ou teste novas funções e atualizações. Se identificou um erro, siga os passos descritos nas partes dois, três e quatro deste guia.

02

Lidando com bugs em Unity

Então ... você encontrou um bug. Veja como você pode ajudar melhor na sua correção:

Avaliação da situação

Ações primárias

Ações secundárias

1. Avaliação da situação

Verifique o Rastreador de problemas para relatórios de bugs existentes.

Pesquise o problema no Google e procure tópicos do fórum relacionados.

2. Ações primárias

É um problema conhecido e não resolvido?

Vote na entrada Rastreador de problemas correspondente

É um problema desconhecido?

Envie um relatório de bug com um projeto de reprodução mínimo e responda às perguntas do pessoal da Unity.

3. Ações secundárias

O problema já foi comunicado, mas você quer garantir que seu caso seja coberto por uma correção?

Envie um relatório de bug com um projeto de reprodução mínimo e responda às perguntas do pessoal da Unity.

Existe um tópicos do fórum sobre o assunto?

Responda. Se ainda não houver um tópico, abra um e indique o seu ID do problema.

Se você encontrar um problema no Unity, você deve primeiro descobrir se ele já é conhecido ou se você é o primeiro a ter essa experiência. O primeiro endereço para este tipo de informação é o nosso !Public_issue_tracker. Aqui você pode procurar erros já reportados e avaliar ou comentar sobre eles. A avaliação de problemas ajuda nossa equipe a determinar quais erros devem ser resolvidos primeiro.

O Unity fórum beta é outro grande recurso da comunidade. Você pode ver o que os outros relataram, encontrar soluções alternativas ou até mesmo compartilhar informações. É uma boa maneira de entrar em contato com a equipe Unity. Mas certifique-se de que seus tópicos estão relacionados com o beta atual e não agrupe vários problemas diferentes em um único segmento.

Se você não consegue encontrar nada sobre o seu erro, é hora de enviar um relatório de erro. Posteriormente, publique no fórum uma descrição do problema encontrado. Isso permite que outros usuários sejam informados e adicionem contexto ou forneçam sua solução alternativa. Isso também irá acelerar o tempo de processamento, pois monitoramos regularmente o fórum beta e priorizamos a avaliação inicial de novos casos neste fórum.

Se você começar um novo tópico sobre um problema, inclua o número do seu caso (fornecido em seu e-mail de confirmação) na postagem, para que nossa equipe possa identificar o relatório de erro enviado por você. Caso contrário, esse número é o primeiro a ser solicitado.

Se estiver na dúvida se um problema indica uma falha na plataforma ou no seu projeto e consultar os fóruns ou a documentação não ajuda a esclarecer, envie um relatório de falha.

03

Documentação e relatório de seu erro

O relatório de erro pode parecer um pouco complicado no começo, mas não é tão difícil, e é essencial para garantir a estabilidade. Siga estes passos simples para escrever um relatório de erro eficaz que nossos engenheiros entendam facilmente.

Não tenha medo de cometer erros. Se não conseguirmos reproduzir um problema com as informações de seu relatório, entraremos em contato para descobrir se algo está faltando.

Abrir o relatório de erros

Ao executar Unity, selecione Help → Report a Bug no menu.Alternativamente, você pode encontrar o Bug Reporter instalado ao lado do editor na pasta do programa. Ele será iniciado automaticamente caso tenha alguma pane.

Forneça informações básicas

No campo "What is the problem related to" selecione a opção que corresponde melhor ao erro. Como você está relatando um erro na versão beta, geralmente é a opção "A problem with the Editor" ou "Crash Bug".

Em “How often does it happen,” você deve especificar se o problema ocorreu uma vez, várias vezes ou sempre que você executou as etapas que causaram o erro.

Forneça seu endereço de e-mail, caso nossa equipe precise entrar em contato com você para obter mais informações. Se você fez login com sua conta do Unity, esse campo será preenchido automaticamente.

Se seu relatório é aprovado, o texto que você escreveu nos campos “Title” e “Describe the problem” é publicado no Rastreador de Problemas. Isso ajuda a comunidade. Outros usuários podem comentar o problema, avaliá-lo (o que ajuda a priorizar as correções de erros) e verificar se uma solução está disponível. Suas informações pessoais não serão publicadas. Seus projetos e outros anexos são acessíveis apenas aos funcionários da Unity.

Identifique o erro

Como você descreveria o erro sucintamente? Seja preciso e escreva por exemplo:

Aparece um erro no console depois de limpar o GI Cache e recarregar o projeto

Categorize o erro e escreva o título

Em qual categoria você classificaria o erro? IU? Importação de recursos? Scripting? Plataforma específica? Crash? Neste caso, o erro estava relacionado à iluminação, mais especificamente com o Lightlightper Enlighten.

Ok, agora adicione essa informação e a descrição do seu erro para criar o título no seguinte formato:

[Category] descrição

Neste exemplo, o título do seu erro ficaria assim:

[Enlighten] Erros aparecem no console depois de limpar o GI Cache e recarregar o projeto

Especifique as etapas para reproduzir o erro

As equipes de controle de qualidade e desenvolvimento Unity precisam de toda a ajuda possível para diagnosticar e corrigir um problema. As informações recebidas podem não ser suficientes para identificar a origem do problema, ou levar a alterar algo que não seja seu erro. Portanto, é do seu interesse fornecer o máximo de informações possíveis para ajudar a corrigir seu problema. A maneira mais fácil é reproduzir as etapas anteriores à ocorrência de seu erro. Então, qual foi a primeira coisa que você fez antes de descobrir o erro?

Feche e reabra o projeto

Então esta é a última das Etapas para Reproduzir o erro. O que você fez antes?

Limpe o cache do GI: Edit > Preferences > GI Cache > Clean Cache

Continue até onde puder se lembrar, idealmente ao ponto em que você abriu o Unity. Quanto mais informações você fornecer, mais fácil será reproduzir e corrigir o erro. Se você não se lembra de tudo, tente reproduzir o erro, prestando atenção nas etapas que está realizando.

Você não precisa fornecer as etapas por escrito - você pode, por exemplo, enviar as etapas através de captura de vídeo da sua tela. O mais importante é ilustrar claramente as etapas para que nossos engenheiros possam reproduzir o erro.

Adicione os resultados esperados vs reais

Que resultado você esperava antes de encontrar o erro?

Esperado: console sem erros

O que aconteceu?

Real: aparecem erros no console

Atenção: Se você receber mensagem de "unexpected error ", será útil adicioná-lo à sua descrição.

Depois de preencher todas essas informações, seu relatório deve ficar assim:

Anexe sua pasta do projeto

O Bug Reporter incluirá automaticamente o projeto atualmente carregado no relatório de erros, se você o abrir através do editor. Se você iniciar o repórter por meio de seu arquivo executável, será necessário anexar seu projeto manualmente. A menos que seu projeto já seja muito pequeno, recomenda-se remover todas as informações irrelevantes. O envio de um projeto de reprodução mínimo que contém apenas o que é necessário permite que nossas equipes de controle de qualidade e desenvolvimento isolem o problema com mais eficiência e corrijam muito mais rapidamente.

Se o problema ocorrer em uma cena específica do seu projeto, tente exportar essa cena e, em seguida, importe-a para um novo projeto para ver se o erro persiste. Em caso afirmativo, faça o upload do novo projeto menor. Se não, tente com versões maiores do projeto.

Para ajudá-lo a reduzir o tamanho de seus projetos e a criar projetos de reprodução mínimos, desenvolvemos diversas ferramentas que reduzem o esforço necessário.

Você pode encontrar informações adicionais sobre o uso destas ferramentas !aqui.

O projeto mais pequeno que reproduz o problema é ideal, mas os grandes projetos são definitivamente melhores do que nada. Por isso, inclua todo o projeto, caso não seja possível reduzi-lo. Nosso sistema de relatórios suporta anexos pesados. . Não carregue recursos individuais porque o projeto contém dados e arquivos importantes que os próprios recursos não possuem.

O relatório final agora deve ficar assim:

Perfeito! Você criou um relatório de erro informativo e preciso que nossa equipe pode usar para identificar e corrigir o problema. Apenas uma última etapa:

Envie seu relatório de erro

Clique em "Send" para enviar seu relatório de erro.

Após envio do seu relatório, você receberá um e-mail de confirmação contendo o número do caso, o qual você deve conservar. O email inclui um link para um site com o status atual do erro. Você pode consultar esse site a qualquer momento para atualização. Não compartilhe este link no fórum ou em outros espaços públicos, pois contém seu endereço de contato e o histórico do relatório de erros. O número do caso é suficiente para que outros usuários encontrem o problema no Rastreador de problemas.

Para sua conveniência pessoal, sugerimos que faça o seguimento dos seus relatórios de erros e respetivas pastas de projetos. Recomendamos o seguinte procedimento:

  1. Toda vez que você enviar um relatório de erro, crie um arquivo .zip do projeto que você anexou.
  2. Conserve um arquivo .txt do relatório de erro no diretório Assets para saber que erro ocorreu no projeto e como você pode reproduzi-lo.
  3. Depois de enviar o relatório de erro, use o número do caso fornecido no e-mail de confirmação como prefixo do seu arquivo .zip.

Isso permitirá que você encontre rapidamente o projeto que você anexou ao relatório quando Unity informar por e-mail que seu relatório de erro foi fechado.

Ao receber a notificação da Unity informando que seu relatório de erro foi fechado, você pode verificar se o erro foi corrigido. Vá para o projeto e abra-o na versão beta mais recente do Unity. Siga as etapas de reprodução para ver se o erro desapareceu.

Embora seja um pouco trabalhoso, significa: a) é provável que você tenha um relatório de erros de alta qualidade, o que significa que seu erro tem mais chances de ser reproduzido e corrigido e b) você pode facilmente garantir que o erro não ocorrerá em uma futura versão beta.

04

Seguimento

É sempre ideal que nossa equipe possa entrar em contato com você caso tenha alguma dúvida. Se você enviou um relatório de erro, entraremos em contato por e-mail. Se você escreveu no fórum, nós responderemos lá. Responda o mais rápido possível às perguntas e solicitações que você recebe da equipe para garantir uma resolução rápida do caso.

Se você não viu seu erro mencionado nos fóruns, aconselhamos que você inicie um novo tópico. Lembre-se de que outras pessoas podem ter tido o mesmo problema, por isso, postar soluções alternativas que você possa ter encontrado é uma maneira rápida de encontrar amigos na comunidade beta!

É isso aí!

Obrigado por dedicar seu tempo para aprender como se tornar um testador beta eficaz. Se você tiver alguma dúvida e sua engine de pesquisa não fornecer respostas, pergunte nos fóruns .

Eu entendi

Usamos cookies para garantir a melhor experiência no nosso site. Visite nossa página da política de cookies para obter mais informações.