Unreal Revision Control

O Unreal Editor para Fortnite (UEFN) integra o controle de revisão como uma parte importante do gerenciamento de projetos, processos de equipe e controle de qualidade. Ele mantém uma única fonte de verdade para o projeto e os desenvolvedores.

Habilitar o Unreal Revision Control em projetos de equipe facilita a colaboração entre os membros da equipe, evita que o trabalho seja perdido e acelera o lançamento de uma ilha reduzindo o tempo de produção. Incorporar a sincronização do projeto na iteração diária dá um pouco de trabalho, mas o esforço final vale a pena.

Como funciona o Unreal Revision Control

O Unreal Revision Control está disponível para todas as novas ilhas no UEFN. Ele funciona tirando um "instantâneo" da ilha e seus ativos. Esse instantâneo mostra o estado atual dos arquivos e ativos da ilha depois de serem enviados.

Clique na imagem para ampliar.

Selecione Unreal Revision Control no painel Padrões do Projeto para um novo projeto.

No menu suspenso Seleção de Equipe, selecione Apenas eu se estiver trabalhando em um projeto sozinho ou o nome de sua equipe se estiver trabalhando em um projeto de equipe. Você pode desabilitar o Unreal Revision Control para seus projetos pessoais.

Os projetos que usam o Unreal Revision Control são hospedados em servidores.

A opção Sincronizar mais recente é marcada por ícone de download.

Você também pode usar o Unreal Revision Control no painel Organizador. O status de controle de revisão de um ativo será exibido para referência no lado direito da linha de um ativo no Organizador. Além disso, você pode clicar com o botão direito do mouse em um ativo no painel Organizador e selecionar Controle de revisão > Check-out no menu suspenso.

Use o Unreal Revision Control com seus projetos

Ativar o controle de origem ao criar novos projetos adiciona estas funcionalidades à barra de ferramentas inferior:

• Controle de revisão

• Sincronizar alterações/Mais recente

• Fazer check-in de alterações/Sem alterações.

Todas as funcionalidades do Unreal Revision Control aparecem abaixo do painel Detalhes do seu projeto.

Controle de revisão

O indicador de controle de revisão. Uma marca de seleção verde indica que o controle de revisão está em uso para este projeto. Clique na seta para abrir o menu de controle onde você faz check-out dos arquivos e ativos modificados e altera suas configurações de controle de revisão.

Altere suas configurações de controle clicando em Alterar configurações de controle de revisão… no menu suspenso, o que abre o Login de controle de revisão. A partir daqui, você pode ativar e desativar as configurações automáticas e revisar o Log de controle de revisão.

Clique na imagem para ampliar.

Check-out automático

O Check-out Automático é ativado automaticamente quando você cria um novo projeto. Essa funcionalidade funciona fazendo automaticamente o check-out de um ativo para você quando alterações forem feitas ou um ativo for movido na janela de visualização.

Essa funcionalidade bloqueia o ativo no qual alterações foram feitas e impede que outro colega de equipe faça alterações no mesmo objeto enquanto você faz o check-out. Ao examinar os ativos listados no Organizador, é possível ver quais ativos foram submetidos ao check-out por um colega.

O uso do Check-out Automático evita conflitos e permite que você e seus colegas de equipe colaborem em projetos com o mínimo de atrito possível.

Se o check-out automático estiver desabilitado, o Unreal Revision Control solicitará que você se conecte novamente à Internet ou salve localmente.

Reversão automática

A Reversão Automática impede que você crie conflitos com os membros da equipe, desfazendo automaticamente suas alterações em um ativo já submetido a check-out por outra pessoa. Você receberá um aviso sobre o conflito e a reversão das alterações.

Essa funcionalidade impede que você dedique horas de trabalho em um ativo apenas para desfazer todas as alterações feitas no final. Ao entrar rapidamente no Organizador, você saberá em quais ativos seus colegas de equipe estão trabalhando no momento.

Sincronizar alterações

Essa funcionalidade extrai o instantâneo de controle de revisão mais recente do projeto e sincroniza com o disco. Você precisará sincronizar com a versão mais recente do projeto quando vir Sincronizar mais recente. Se não houver alterações a serem sincronizadas, o botão exibirá Mais recente.

Depois de clicar em Sincronizar mais recente, você obtém o instantâneo do projeto mais recente em seu ambiente local, onde pode continuar trabalhando no projeto.

Você pode fazer e salvar alterações sem ter sincronizado com o instantâneo mais recente, desde que as alterações feitas não entrem em conflito com as alterações no instantâneo mais recente e não sejam alterações feitas em ativos atualmente submetidos a check-out por outro usuário.

Consulte Conflitos no Unreal Revision Control para obter mais informações sobre os possíveis conflitos que você pode encontrar.

Fazer check-in de alterações

Faz check-in de todas as alterações e cria um novo instantâneo do projeto com todas as alterações com check-in. Quando você faz alterações no projeto que precisam ser submetidas em check-in, o botão muda de Sem alterações para Fazer check-in de alterações.

O Unreal Revision Control rastreia o histórico de revisões de arquivos de origem com formatos nativos do ecossistema UE, mas não rastreia o histórico de revisões de arquivos de origem com formatos nativos de outro software, (por exemplo, Blender, Photoshop e assim por diante).

Clicar em Fazer check-in de alterações abre a janela Fazer check-in de alterações, criando um novo instantâneo da sua ilha e abrindo a janela do instantâneo. Liste as alterações feitas nos ativos em Descrição da lista de alterações e clique em Enviar para criar um novo instantâneo da ilha.

Se houver um item na lista de check-in que deva ser revertido para a versão anterior, você poderá fazê-lo na janela de envio.

Selecione o ativo e clique com o botão direito, um menu suspenso aparece com a opção Reverter. Clique em Reverter e todas as alterações no ativo serão desfeitas.

1. Descrição da lista de alterações: adiciona uma descrição das alterações feitas no ativo colocado em check-out. Isso captura um instantâneo desse ativo.

2. Sinal de mais: um novo ativo adicionado ao Unreal Revision Control.

3. Marca de seleção: um ativo submetido a check-out.

4. Manter arquivos em check-out: selecionar para manter os arquivos em check-out significa que eles ainda estarão em check-out para você, mesmo depois que enviar suas alterações.

5. Enviar: envia as alterações para o Unreal Revision Control.

6. Cancelar: cancela o instantâneo e retorna você ao projeto.

Depois que as alterações forem salvas e enviadas com sucesso, seus colegas de equipe poderão sincronizar com a nova versão do projeto. A miniatura do projeto é atualizada para todos os membros da equipe com um ícone de download, informando que o projeto precisa ser sincronizado.

Há uma diferença entre salvar seu projeto e fazer o check-in das alterações. Salvar seu projeto salva o projeto no disco, onde o check-in de suas alterações cria um instantâneo histórico do projeto em um determinado momento.

Esses instantâneos fornecem um histórico dos ativos do projeto que você pode revisar posteriormente para entender como e por que um ativo foi alterado e por quem, ao longo do tempo.

Fazer check-out de um ativo do projeto

Fazer check-out de um ativo impede que ele seja editado por outro colega de equipe. Quem primeiro fizer check-out do objeto terá controle sobre ele pelo tempo que o check-out for mantido.

Para fazer check-out de um ativo individual:

1. Clique com o botão direito na miniatura do ativo para abrir o menu do ativo.

2. Selecione Controle de revisão > Conferir.

   

O ativo agora está em check-out para você, e sua miniatura é atualizada com uma marca de seleção vermelha. Os colegas de equipe veem um ícone diferente na miniatura que os informa que o ativo foi submetido a check-out.

Após o check-in do objeto, qualquer pessoa com acesso ao projeto precisará sincronizar com a versão mais recente do projeto para editar o ativo.

No menu do botão direito, você também pode fazer o seguinte: