Contribuindo para o MRTK

O Mixed Reality Toolkit (MRTK) acolhe contribuições da comunidade. Todas as alterações sejam pequenas ou grandes, precisam de aderir às normas de codificação MRTK, por isso, certifique-se de que está familiarizado com estas alterações enquanto se desenvolve para evitar atrasos quando a alteração está a ser revista.

Se tiver alguma dúvida, contacte o canal de ferramentas de realidade mista no Slack. Pode juntar-se à comunidade Slack através do remetente automático de convites.

Processo de submissão

Fornecemos vários caminhos para permitir que os desenvolvedores contribuam para o Mixed Reality Toolkit, tudo começando com a criação de um novo Problema.

Selecione tipo de emissão

A partir daqui arquiva:

  • Bug report - Problema de funcionalidade com um dos componentes do Mixed Reality Toolkit
  • Problema de documentação - Emissão com a documentação do Kit de Ferramentas de Realidade Mista
  • Pedido de recurso - Proposta para um novo recurso de Ferramentas de Realidade Mista

Proposta de pedidos de recursos

Ao solicitar uma nova funcionalidade de Ferramentas de Realidade Mista, é importante documentar o benefício/problema do cliente a resolver. Uma vez submetido, um pedido de recurso será revisto e discutido no GitHub. Incentivamos a discussão aberta e construtiva de cada proposta de recurso para garantir que o trabalho seja benéfico para um grande segmento de clientes.

Para evitar a necessidade de reformular a funcionalidade, recomenda-se geralmente que o desenvolvimento da funcionalidade não comece durante a fase de revisão. Muitas vezes, o processo de revisão comunitária revela uma ou mais questões que podem exigir alterações significativas na implementação proposta.

Nota

Se deseja trabalhar em algo que já existe no nosso atraso, pode usar esse item de trabalho como sua proposta. Certifique-se de também comentar sobre a tarefa notificando os manutenção que você está trabalhando para completá-lo.

Processo de contribuição

Para começar, basta seguir estes passos:

  1. Garfo o repositório. Clique no botão "Garfo" no topo direito da página e siga o fluxo.
  2. Crie um ramo no seu garfo (fora do ramo principal) para facilitar o isolamento de quaisquer alterações até estar pronto para a submissão. Para correções de insetos durante um período de estabilização de libertação, procure o ramo mais prerelease/* recente. As novas funcionalidades devem sempre entrar main em .

Se você é novo no fluxo de trabalho Git, confira esta introdução de Github.

Ao adicionar uma correção ou funcionalidade de bug, siga estes passos:

  1. Implementar a correção ou funcionalidade do bug. As instruções para a construção e implantação do MRTK estão em dispositivos De implantação para hololens e dispositivos WMR. Lembre-se de seguir as Diretrizes de Codificação.
  2. Se adicionar uma funcionalidade, adicione também uma cena de exemplo que demonstre a funcionalidade.
  3. Se adicionar uma característica experimental, então não são necessários testes e documentação de escrita. Em vez disso, siga as diretrizes de recursos experimentais.
  4. Adicione testes para verificar a correção /funcionalidade do bug. As instruções para a escrita e o funcionamento dos testes estão nos UnitTests.
  5. Certifique-se de que o código e as funcionalidades estão documentados conforme descrito nas Diretrizes de Documentação.
  6. Certifique-se de que o código funciona como pretendido em todas as plataformas. Consulte as notas de lançamento para a lista de plataformas apoiadas. Para Windows projetos UWP, o código deve ser compatível com WACK. Para isso, gere uma solução Visual Studio, clique no projeto; LojaCriar pacotes de aplicativos. Siga as indicações e escohe os testes WACK. Certifique-se de que todos tenham sucesso.
  7. Siga as instruções no Pull Requests ao fazer um pedido de retirada.