Desenvolvimento de novo código e documentação
Dependendo do nível de acesso, novos códigos e documentação podem ser desenvolvidos em uma nova ramificação de recursos ou em uma bifurcação. Em geral, trabalhar a partir de um garfo separado é preferível, e às vezes é a única alternativa.
As melhores práticas no desenvolvimento do git/GitHub estão fora do escopo desta documentação, mas mais leituras podem ser encontradas aqui.
Novo código
Enviando uma solicitação pull (PR)
Qualquer solicitação pull deve incluir uma execução manual através do pipeline de construção de CI. O pipeline é acionado adicionando um comentário ao PR. O comando a seguir acionará uma compilação completa:
/azp run
Se for sabido que as alterações são totalmente restritas a código ou documentação, então apenas esse lado da compilação pode ser executado. Por exemplo, para verificar apenas as alterações de código:
/azp run wlt_ci
Ou para verificar apenas as alterações na documentação:
/azp run wlt_docs
No entanto, tenha em mente que mesmo alterações restritas a arquivos de código (.cs) podem desencadear alterações na documentação. É sempre mais seguro executar a compilação completa.
Execute a versão apropriada após quaisquer alterações significativas em um PR e antes da conclusão final do PR. Lembre-se, essas ferramentas estão em vigor para proteger os colaboradores de quebrar a compilação. Usá-los é para seu próprio benefício e o benefício de outros que trabalham no mesmo espaço.
Revisão do código
Todos os RPs devem ser revisados por outro desenvolvedor antes de serem concluídos.
Ao realizar revisões de código, mantenha uma atmosfera amigável e colaborativa. Vale sempre a pena um pouco mais de tempo para encontrar uma maneira de expressar uma sugestão ou correção que deixe o outro lado se sentindo positivo sobre as mudanças.
Publicação de uma nova versão
Após testes minuciosos e estabilização, uma nova versão segura do produto pode ser publicada.
O produto é disponibilizado através de dois canais:
- Através do repositório GitHub de código aberto, marcado para confirmações de lançamento verificadas.
- Através de ficheiros publicados
.unitypackage.
Ambos os canais estão disponíveis na página de lançamentos do GitHub da WLTU.
Construindo os pacotes de unidade
NOTA: A IU exata do processo descrito aqui está sujeita a alterações frequentes. Se o que você vê na tela não corresponder às capturas de tela aqui, provavelmente tudo bem. Basta procurar as palavras-chave relevantes e seguir.
Primeiro, vá para a página do pipeline de compilação. Certifique-se de que "wlt_ci" está selecionado.
Selecione a compilação que corresponde à confirmação que será a base para a versão.
Essa seleção levará à tela a seguir, a partir da qual os artefatos de construção podem ser acessados.*
Selecione os pacotes unity.
Em seguida, faça o download como zip.
Depois de instalar e testar os pacotes, eles podem ser integrados em uma nova versão.
Criando a versão
Atualizar o campo Versão no código
Atualize o campo WorldLockingManager.Version para refletir corretamente a nova versão.
Criar uma ramificação de versão
Por exemplo, crie uma ramificação chamada "release/v0.3.6-alpha". Embora redundante com a tag, essa ramificação facilitará hot-fixes para a versão, o que não seria adequado para o ramo de desenvolvimento principal "master".
Publicar a versão
Vá para a página World Locking Tools for Unity releases.
Clique no botão "Criar uma nova versão".
Especifique uma tag . A tag deve ser do formato vX.Y.Z[-prerelease-modifier]. X, Y e Z dessa tag são três inteiros que devem corresponder à versão, conforme especificado no campo WorldLockingManager.Version. Esses números também devem corresponder ao nome da ramificação de lançamento.
Especifique a ramificação de liberação criada acima como o destino.
Preencha os campos de título e descrição adequadamente.
Arraste os .unitypackage arquivos criados acima para o retângulo rotulado "Anexar binários soltando-os aqui ou selecionando-os".
O pacote Exemplos grande, que também contém um instantâneo de sua dependência MRTK, pode levar um tempo considerável para ser carregado. É mais seguro não sair dessa página até que o upload tenha sido concluído com sucesso.
Quando os .unitypackage arquivos tiverem sido carregados com êxito, clique no botão Publicar versão.
Verifique se tudo está correto na página de lançamentos.