Reportar um bug
Como você pode reportar um bug para que ele seja analisado e corrigido
Se você encontrar quaisquer bugs ou problemas com o Decentraland SDK e o Scene Editor no Creator Hub, por favor reporte-os no nosso repositório do GitHub aqui.
Antes de reportar um bug
Antes de enviar um relatório de bug, certifique-se do seguinte:
Certifique-se de que está a usar a versão mais recente do SDK, caso o problema já tenha sido corrigido em lançamentos mais recentes.
Consulte a documentação da funcionalidade que está a tentar usar para confirmar que ela deve funcionar como você espera e que isso não é apenas um mal-entendido.
Exclua a possibilidade de o problema ser causado pela forma como a sua scene está construída. Veja Debug in Preview e Debug in Prod para obter dicas.
Evite duplicados. Consulte a lista de bugs conhecidos para evitar criar um duplicado. Se tiver mais informações para adicionar a um issue existente, por favor adicione um comentário ao issue em vez de criar um novo issue.
Reportar um bug
Para reportar um bug no SDK, você precisará de uma conta GitHub. Siga estes passos:
Visite o seguinte link: New Issue Page
Clique em Get Started ao lado de Bug Report.
Preencha todos os campos do template. O template fornece instruções para cada seção. Quanto mais detalhes você puder fornecer, mais rapidamente os nossos developers poderão identificar e resolver o problema.
Clique em Enviar novo issue.
Os developers podem fazer perguntas de acompanhamento no seu ticket se precisarem de esclarecimentos ou informações adicionais. Você receberá notificações por email sobre as atualizações do seu relatório de bug.
📔 Nota: Para quaisquer problemas não relacionados com o SDK, por favor contacte a equipa de suporte. Para entrar em contacto, por favor visite esta página intercom.decentraland.org ou envie-nos um email para [email protected]. Você também pode encontrar-nos no Discord. A equipa está disponível para ajudar de segunda a domingo, das 12h às 21h UTC, e fará o possível para responder o mais rapidamente possível. Pode esperar uma resposta no Discord em até 60 min durante o intervalo acima e por email em até 24h.
Você também pode contactar a equipa de suporte da DAO no DAO Discord.
Dicas adicionais para relatórios de bug:
Crie um issue separado para cada bug. Se encontrar vários problemas, certifique-se de criar um novo issue para cada um.
Evite explicações longas. Inclua apenas a saída relevante da linha de comando ou do console, ou o código da scene quando necessário.
Anexe imagens ou vídeos, se possível. Você pode facilmente arrastar e largá-los na área de texto do issue, e o GitHub tratará do upload e da ligação.
Usando o Decentraland Playground
Fornecer trechos de código que demonstrem o problema é extremamente útil. A reprodutibilidade é crucial. Se um bug não puder ser reproduzido, é difícil diagnosticá-lo e corrigi-lo.
Você pode colar trechos de código no texto do seu issue, mas a melhor forma de fornecer trechos de código é usando o Decentraland Playground. Siga estes passos:
Escreva o seu trecho de código à esquerda e veja a sua scene no painel da direita.
Clique no Share botão e cole o link no seu relatório de issue.
Usar o playground simplifica a reprodução do issue e garante que qualquer pessoa que abrir o link possa ver a mesma saída, independentemente do seu sistema operativo, versão do SDK, versão do Node, etc. Também facilita a iteração rápida para identificar as condições afetadas e localizar a causa do issue.
Mantenha o seu exemplo o mais conciso possível, ao mesmo tempo que continua a reproduzir o issue. Um exemplo mais simples ajuda a eliminar a ambiguidade sobre a origem do problema.
📔 Nota: Não é possível importar assets para a sua scene no Playground. Portanto, se reproduzir o issue exigir a importação de um modelo 3D ou de um ficheiro de som, não será possível mostrá-lo lá.
Obter logs
Muitas vezes é útil obter os logs do explorer do Decentraland ao reportar um bug.
Para obter os seus logs, basta abrir o chat e escrever /logs. Isto abrirá uma nova janela com os logs do explorer do Decentraland. Anexe o Player.log ficheiro ao seu relatório de issue.
Editar a documentação
Se descobrir problemas no conteúdo do website da Documentation, pode enviar pedidos de alteração. Basta deslocar-se até ao fim da página e clicar no botão Edit this page . O GitHub irá guiá-lo através da criação de um pull request com as suas alterações. A equipa da foundation irá rever as suas alterações e publicá-las se forem consideradas úteis.
Pedidos de funcionalidade e sugestões
Se tiver sugestões para adicionar nova funcionalidade ou features em vez de reportar um problema, por favor junte-se ao Decentraland Discord Server e publique uma mensagem no Creator Hub Channel em vez de criar um GitHub Issue.
Atualizado