Hero background image
Um guia para ser um testador beta eficaz
Um guia prático e um documento de referência para ajudá-lo a começar e obter o máximo de valor dos testes beta de acesso antecipado do Unity.
Esta página foi traduzida por máquina. Para ver a versão original a fim de obter uma fonte confiável e precisa,

Bem-vindo!

Por que o teste beta é importante

Nossa equipe de controle de qualidade trabalha arduamente para garantir que nossas versões sejam estáveis, mas não há como fazer isso sem que os membros da nossa comunidade de desenvolvedores forneçam feedback sobre as próximas compilações. Estamos muito felizes por você querer ajudar!

Para ajudar você a nos ajudar (a ajudar você), criamos este guia para ser o melhor testador beta que você pode ser - como carregar seu projeto, como escrever um relatório de bug e muito mais. Seguindo essas etapas, você nos fornecerá as informações mais importantes para que possamos corrigir os problemas que afetam você e o desenvolvimento de seus projetos.

Seu feedback sobre a versão beta é inestimável. Analisamos todos os relatórios de bugs beta com classificação 4 e 5 e fazemos o possível para examinar aqueles com classificações mais baixas (se não tiver certeza do que isso significa, dê uma olhada nesta publicação do blog). Quando tivermos validado o bug e tivermos uma correção, nós a programaremos para uma próxima versão beta. No momento, não podemos fornecer detalhes sobre qual correção estará em qual versão beta, mas saiba que isso acontecerá o mais rápido possível!

Abaixo você encontrará informações detalhadas sobre o fluxo de trabalho para o envio de relatórios de bugs e feedback impactantes. Aqui você também pode encontrar um resumo das etapas mais importantes.

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

CONTEÚDO

01 Instalação e primeiros passos

Baixe a versão beta mais recente, seja diretamente como um instalador autônomo ou por meio do novo Unity Hub. Esta página também contém muitas informações e recursos beta. Você pode conhecer os novos recursos, encontrar documentos e ferramentas úteis e manter-se informado sobre os últimos sorteios.

Execute o instalador ou o hub. Se você usar o instalador, certifique-se de instalar a versão beta em um novo diretório. Não há problema em ter várias versões do Unity lado a lado, desde que estejam localizadas em diretórios individuais.

Inicie um novo projeto ou faça uma cópia do projeto que planeja usar para testar a versão beta e, em seguida, abra-o com a versão beta mais recente.

Certifique-se de criar uma cópia de backup se 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 o Unity abre um projeto, ele migra automaticamente o projeto para a versão do Unity que você está usando. Portanto, trabalhar em uma cópia do seu projeto também economiza tempo, pois você evita ter que reimportar quando volta para a versão estável atual.

Desenvolver como de costume e/ou testar novos recursos e atualizações. Se você acha que encontrou um bug, siga as próximas etapas descritas nas partes dois, três e quatro deste guia.

02 Lidando com bugs no Unity

Então... você encontrou um bug. É assim que você pode ajudar de forma mais eficiente.

Avalie a situação Ações primárias Ações secundárias Verifique se há relatórios de bugs existentes no rastreador de problemas.

Pesquise o problema no Google e procure tópicos de fóruns relacionados.

É um problema conhecido e não resolvido?

Vote na entrada relevante do rastreador de problemas.

É um problema desconhecido?

Envie um relatório de bug com um projeto de reprodução mínimo e responda às solicitações da equipe da Unity.

O problema já foi relatado, mas você quer ter certeza de que seu caso será coberto por uma correção?

Envie um relatório de bug com um projeto de reprodução mínimo e responda às solicitações da equipe da Unity.

Existe algum tópico no fórum sobre esse problema?

Responder Caso contrário, inicie um com referência ao seu ID de problema.

Se você tiver um problema com o Unity, a primeira coisa que deve fazer é descobrir se é um problema conhecido ou se você é o primeiro a enfrentá-lo. O primeiro endereço para obter esse tipo de informação é o nosso Issue Tracker público. Ele permite que você pesquise bugs relatados por outros usuários e vote ou comente sobre eles. Votar nos problemas ajuda nossa equipe a priorizar quais bugs devem ser resolvidos primeiro.

O fórum da versão beta do Unity é outro grande recurso da comunidade. Você pode ver o que outras pessoas relataram, encontrar soluções alternativas para os problemas ou fornecer informações você mesmo. Também é uma boa maneira de entrar em contato com alguém da Unity. Apenas certifique-se de que os assuntos que você está abordando estejam relacionados à versão beta atual e não agrupe vários problemas diferentes em um único tópico.

Se você não encontrar nada relacionado ao seu bug, é hora de enviar um relatório de bug. Depois de enviar um relatório, também é uma boa ideia voltar ao fórum e publicar uma descrição do problema que você descobriu. Isso permitirá que outras pessoas se informem e adicionem mais contexto ou forneçam suas soluções alternativas. Isso também acelerará o tempo de processamento, pois estamos monitorando o fórum beta com frequência e priorizamos a avaliação inicial de novos casos que são discutidos lá.

Se você iniciar um novo tópico sobre um problema, não se esqueça de incluir o número do seu caso (fornecido no e-mail de confirmação) na postagem para que nossa equipe possa identificar o relatório de bug que você enviou - é a primeira coisa que eles perguntarão se você não o incluir.

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 Documentar e relatar seu bug

O relatório de bugs pode parecer um pouco intimidador no início, mas na verdade não é tão difícil, e é vital para garantir a estabilidade. Siga estas etapas simples para escrever um bom relatório de bug que nossos engenheiros poderão entender facilmente e agir.

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

Abra o Bug Reporter

Enquanto estiver executando o Unity, vá para Help → Report a Bug no menu. Alternativamente, você pode encontrar o Bug Reporter instalado ao lado do Editor na pasta do programa. Ele também será iniciado automaticamente se você tiver uma falha.

Fornecer informações básicas

No campo "What is the problem related to" (A que o problema está relacionado), selecione a opção que melhor se alinha com o bug que você está relatando. Como você está relatando um bug na versão beta, geralmente será "A problem with the Editor" (Um problema com o editor) ou "Crash Bug" (Bug de falha).

Em "How often does it happen" (Com que frequência isso acontece), você precisará indicar se esse é um problema que ocorreu apenas uma vez, algumas vezes ou todas as vezes em que você toma as medidas que o levaram a encontrá-lo.

Forneça seu endereço de e-mail caso nossa equipe precise contatá-lo para obter mais informações. Se estiver conectado com sua conta Unity, esse campo será preenchido automaticamente.

Se o seu relatório for verificado, o texto escrito nos campos "Title" (Título) e "Describe the problem" (Descreva o problema) será disponibilizado publicamente no Issue Tracker. Isso ajuda a comunidade. Outros usuários poderão comentar, votar (o que ajuda a priorizar as correções) e ver quando uma correção está disponível. Nenhuma de suas informações pessoais será publicada. Seus projetos e outros anexos são acessíveis apenas aos funcionários da Unity.

Identificar o bug

Em termos mais concisos, como você descreveria o bug? Seja breve e específico, por exemplo:

Aparecem erros no console depois de limpar o cache do GI e recarregar o projeto

Categorize o bug e escreva o título

Se você tivesse que categorizar o bug, o que escolheria? UI? Importação de ativos? Criação de scripts Plataforma específica? Crash? Nesse caso, o bug estava relacionado à iluminação e, mais especificamente, ao Lightmapper do Enlighten.

Certo, agora adicione isso e a descrição do bug para criar o título no seguinte formato:

Descrição [Categoria

Nesse cenário, o título do bug seria parecido com este:

[Enlighten] Aparecem erros no console após limpar o cache do GI e recarregar o projeto

Forneça as etapas para reproduzir

As equipes de controle de qualidade e desenvolvimento da Unity precisam de toda a ajuda que você puder oferecer para diagnosticar e corrigir um problema. Dependendo das informações recebidas, eles podem não conseguir identificar o problema principal ou podem ser enganados e consertar outra coisa que não é o seu bug. Portanto, é de seu interesse fornecer o máximo de informações possíveis desde o início para garantir que o problema seja definitivamente resolvido. A maneira mais fácil de fazer isso geralmente é voltar às etapas anteriores à descoberta do bug. Então, qual foi a primeira coisa que você fez antes de ver o bug?

Feche e reabra o projeto

Portanto, essa é a última etapa das etapas de reprodução. O que você fez logo antes disso?

Limpe o cache do GI: Editar > Preferências > Cache do GI > Limpar cache

Continue fazendo isso até onde puder se lembrar, de preferência até o momento em que abriu a Unity pela primeira vez. Quanto mais informações você puder fornecer, mais fácil será reproduzir e corrigir o problema. Se não conseguir se lembrar de tudo, veja se consegue reproduzir o bug e preste atenção nas etapas que está executando.

Observe que não é necessário fornecer as etapas por escrito - por exemplo, você pode enviar as etapas por meio de captura de vídeo da sua tela. O mais importante é que ele ilustre claramente as etapas para que nossos engenheiros possam recriar o bug.

Adicionar resultados esperados aos reais

O que você achava que aconteceria antes de encontrar o bug?

Esperado: nenhum erro no console

Em vez disso, o que aconteceu?

Real: os erros aparecem no console

Observe que, se você encontrar mensagens de erro inesperadas, é útil adicioná-las também à descrição.

Depois de preencher todas essas informações, seu relatório deverá ter a seguinte aparência:

Anexe sua pasta de projeto

O Bug Reporter incluirá automaticamente o projeto carregado no momento no relatório de bug se você o abrir por meio do editor. Se você iniciar o repórter por meio de seu arquivo executável, terá de anexar o projeto manualmente. A menos que o seu projeto já seja muito pequeno, é recomendável eliminá-lo dos ativos irrelevantes. O envio de um projeto de reprodução mínima que contenha apenas o necessário permite que nossas equipes de controle de qualidade e desenvolvimento isolem o problema com mais eficiência e forneçam uma correção muito mais rápida.

Se o problema ocorrer em uma cena específica do seu projeto, tente exportar a cena em que o erro ocorreu, importe-a para um novo projeto e veja se o problema persiste. Se isso acontecer, carregue o novo projeto menor. Se isso não acontecer, você pode continuar tentando com versões maiores do projeto.

Para ​ajuda ​você ​reduzir ​o ​tamanho ​de ​seu ​projetos ​e ​para ​criar ​mínimo ​projetos de reprodução, ​we ​desenvolvido ​vários ​ferramentas ​que ​muito ​reduzir ​o ​necessário ​esforço.

Você ​can ​encontrar ​adicionais ​informações ​em ​como ​para ​uso ​esses ​ferramentas aqui.

O menor projeto que recrie o problema é o ideal, mas grandes projetos são definitivamente melhores do que nada, portanto, inclua todo o seu projeto se não conseguir reduzi-lo. Nosso ​relatórios ​sistema ​suportes ​enorme ​anexos Por favor ​do ​não ​carregar ​individual ​ativos ​porque ​o ​projeto ​contém ​relevante ​dados e ​arquivos ​que ​o ​ativos ​sozinho ​do ​Não

O relatório final deve ter a seguinte aparência:

Perfeito Você elaborou um relatório de bug informativo e conciso que nossa equipe pode usar para localizar e corrigir o problema. Apenas uma última etapa:

Envie seu relatório de bug

Clique em "Enviar" para enviar seu relatório de bug.

Quando o bug for enviado, você receberá um e-mail de confirmação com o número do caso, que deverá ser guardado. O e-mail incluirá um link para uma página da Web com o status atual do bug. Você pode voltar a essa página a qualquer momento para obter uma atualização. Não compartilhe esse link no fórum ou em outros espaços públicos, pois ele revela seu endereço de contato e o histórico de relatórios de bugs. O número do caso é suficiente para que outras pessoas encontrem o problema no Rastreador de problemas.

Para sua conveniência pessoal, sugerimos que você mantenha o controle dos seus relatórios de bugs e das pastas de projetos relacionadas. Recomendamos a seguinte abordagem:

Sempre que enviar um relatório de bug, crie um arquivo .zip do projeto que você anexou.

Mantenha um arquivo .txt do próprio relatório de bug e mantenha-o no diretório Assets para que você saiba qual erro o projeto mostra e como reproduzi-lo.

Depois de enviar o relatório de bug, pegue o número do caso fornecido no e-mail de confirmação e prefixe o arquivo .zip com ele.

Dessa forma, você pode encontrar rapidamente o projeto que anexou a um relatório quando a Unity enviar um e-mail para notificá-lo de que o relatório de bug foi fechado.

Ao receber a notificação da Unity sobre o fechamento do seu relatório de bug, você pode verificar se o bug foi corrigido encontrando o projeto apropriado e abrindo-o na versão beta mais recente da Unity. Siga as etapas para reproduzir e você poderá determinar facilmente se o bug foi eliminado.

Embora isso dê um pouco de trabalho para você, significa que: a) é mais provável que você tenha um relatório de bugs de alta qualidade, o que significa que é mais provável que o bug seja reproduzido e corrigido; e b) você pode facilmente garantir que o bug foi corrigido em uma versão beta futura.

04 Acompanhamento

É sempre ideal que nossa equipe possa entrar em contato com você em caso de dúvidas. Se você enviou um relatório de bug, entraremos em contato com você 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 receber da equipe para garantir uma resolução rápida do caso.

Se o seu bug não foi mencionado nos fóruns, recomendamos que você inicie um novo tópico. Lembre-se de que outras pessoas podem ter tido o mesmo problema, portanto, publicar as soluções que você encontrar é uma maneira rápida de fazer amigos na comunidade beta!

É isso.

Obrigado por dedicar seu tempo para aprender a ser um testador beta eficaz. Se tiver dúvidas sobre qualquer um dos itens acima e o mecanismo de pesquisa de sua preferência não revelar nenhuma resposta, entre nos fóruns e pergunte.