Controle de código-fonte do Plastic SCM
O Plastic SCM do Unity é uma ferramenta para controle de versão e gerenciamento de código-fonte, desenvolvida para melhorar a colaboração e a escalabilidade da equipe com qualquer engine. Ele oferece fluxos de trabalho otimizados para artistas e programadores com velocidade superior ao trabalhar com arquivos grandes e binários.
Este guia aborda como configurar o Plastic SCM no Unity em qualquer uma das seguintes versões do Editor:
- 2019.4.29f1 ou posterior
- 2020.3.15f1 ou posterior
- 2021.1.15f1 ou posterior
- 2021.2.0b6 ou posterior
- Qualquer versão além da 2022.1.0a4
1. Conectar o Plastic SCM ao Unity
Para começar, você precisará conectar seu ID Unity ao Plastic SCM e selecionar ou criar uma organização.
Abra o Plastic SCM no Unity clicando no ícone do Plastic SCM na barra de ferramentas no canto superior direito. Você vai ver a janela do Plastic SCM solicitando a conclusão da configuração.
Clique para fazer login ou cadastrar-se. O Plastic SCM se conectará automaticamente ao seu ID Unity. Se o seu ID Unity ainda não estiver vinculado a uma organização, será necessário criar uma. Se você já pertence a uma organização, poderá selecionar uma para participar pelo menu suspenso.
2. Criar um espaço de trabalho otimizado para o seu fluxo de trabalho
Volte para a janela do Plastic SCM e clique em Create workspace.
O Plastic SCM vai sugerir nomes para o repositório (arquivos compartilhados e histórico) e para o espaço de trabalho (sua cópia local). Se você quiser usar um repositório existente do Plastic SCM, clique nos três pontos ao lado do nome do repositório e selecione um repositório da lista.
Selecione o tipo de espaço de trabalho desejado. O Plastic SCM é um sistema de controle de versão otimizado para o desenvolvimento de jogos e projetos 3D, por isso oferece suporte a fluxos de trabalho separados dentro do mesmo repositório. Nós projetamos o espaço de trabalho Plastic para programadores e o espaço de trabalho Gluon para artistas.
3. Adicionar arquivos de assets associados ao seu projeto
O Plastic SCM exibirá os arquivos de projeto da lista de assets na guia Pending changes. Você pode escolher arquivos específicos para incluir ou adicionar tudo ao repositório selecionando os arquivos e clicando em Checkin changes.
O Plastic SCM incluirá automaticamente todas as pastas e arquivos apropriados, como arquivos de pacotes e configurações de projetos, quando for configurado pelo Unity Editor. Você pode visualizar isso na guia Changesets.
Assim que a inclusão inicial de assets for concluída, o Plastic SCM para Unity estará configurado e você estará com tudo pronto para criar.
4. Tipos de arquivos ignorados por padrão
Além disso, há uma lista salva no arquivo ignore.conf na raiz do projeto, que descreve quais arquivos devem ser ignorados por padrão. Você pode editá-la para adicionar ou excluir arquivos da lista de ignorados.
5. Como convidar membros da equipe para o Plastic SCM
Para convidar membros da equipe que trabalham no seu projeto, clique no menu Options (ícone de engrenagem) na guia Plastic SCM no Unity, depois selecione Invite Members to Workspace.
Você será direcionado para o painel de nuvem do Plastic SCM. Nele você pode adicionar novos usuários, reenviar convites ou definir permissões.
Observação: Poderá ser solicitado que você faça login com seu ID Unity se você não estiver conectado ao painel de nuvem do Plastic SCM.
6. Conceitos básicos sobre como verificar o histórico de alterações e do arquivo
A guia Pending changes é a seção usada para confirmar as alterações salvas no projeto para enviar ao repositório.
A guia Changesets mostra o histórico de alterações do projeto feitas no repositório e quem fez cada alteração. Clique em cada conjunto de alterações listado para ver quais arquivos foram afetados pelo respectivo conjunto.
Você também pode visualizar o histórico de cada arquivo clicando com o botão direito do mouse e selecionando View file history, que mostra uma lista das alterações feitas no arquivo. Você tem a opção de clicar com o botão direito do mouse em uma versão mais antiga e selecionar Revert file to this revision.
Não importa se você está usando a Unreal Engine, uma versão incompatível do Unity ou outra engine, basta baixar o cliente completo para usar todas as funcionalidades do Plastic SCM.
1. Baixe e selecione um fluxo de trabalho
Comece baixando o Plastic SCM no site do Plastic SCM, e siga as instruções do assistente de instalação.
Depois de concluída, será solicitado que você execute com o tipo de fluxo de trabalho desejado. Para minimizar os conflitos entre artistas e programadores durante a colaboração, o Plastic oferece GUIs separadas para facilitar dois fluxos de trabalho diferentes dentro do mesmo repositório.
Nós projetamos a opção Plastic para programadores e a interface Gluon para artistas.
Esta escolha não é permanente. Você poderá alternar entre as interfaces Gluon e Plastic usando o menu superior direito do cliente.
2. Faça login e configure o Plastic SCM
Em seguida, será solicitado que você faça login ou crie uma conta. Mesmo que você não vá usar a engine Unity em seu projeto, recomendamos que use um ID Unity.
3. Tela inicial do cliente
Você será levado para a tela inicial do Plastic, como mostrado acima. Se você não tiver organizações associadas à conta, será solicitado que você crie uma. Caso contrário, você pode selecionar uma organização existente com a qual deseja trabalhar.
Se houver repositórios existentes, uma lista será mostrada à esquerda. Ao clicar em um, você pode navegar pelo conteúdo do repositório antes de pegar uma cópia funcional dele.
4. Selecione ou crie um repositório e um espaço de trabalho
Clique em (+) para criar um novo repositório ou selecione um dos repositórios e pressione o botão azul de download para criar um espaço de trabalho e sincronizá-lo com o repositório.
Para o caminho no disco, selecione o diretório que contém os arquivos do seu projeto.
5. Adicione pacotes e arquivos de configurações do projeto
O cliente do Plastic SCM abrirá seu projeto.
Se você for direcionado para um projeto existente na etapa anterior, precisará navegar até a guia Pending changes (se estiver usando a interface para desenvolvedor, conforme mostrado acima), selecionar todos os pacotes e arquivos e pastas de configurações do projeto, e clicar em Checkin para confirmá-los.
Observação: o nome dessa guia será Checkin changes se estiver usando o Gluon.
6. Adicione arquivos de assets e prepare-se para começar
Selecione as pastas e os arquivos de assets necessários para adicionar ao repositório e começar a trabalhar, e clique em Checkin novamente.
Se estiverem definidos como privados, volte para Workspace Explorer (Explore workspace no Gluon), localize os arquivos, clique com o botão direito neles e selecione Adicionar ao controle de código-fonte, depois finalize a confirmação na guia Pending changes.
O Plastic SCM do Unity já está configurado e está tudo pronto para você começar a criar.
7. Tipos de arquivos ignorados por padrão
Além disso, há uma lista salva no arquivo “ignore.conf” na raiz do projeto, que descreve quais arquivos devem ser ignorados por padrão. Você pode editá-la para adicionar ou excluir arquivos da lista de ignorados.
8. Envie alterações usando outro cliente
Ao usar o cliente independente do Plastic SCM fora da engine, você precisará confirmar as alterações salvas no projeto usando o cliente em uma janela separada.
A guia Pending changes (ou Checkin changes no Gluon) é o lugar para confirmar as alterações feitas no projeto para enviar ao repositório.
9. Visualize o histórico de arquivos e reverta arquivos no cliente
A guia Changesets mostra o histórico de alterações do projeto feitas no repositório e quem fez cada alteração. Clique duas vezes no conjunto de alterações listado para ver quais arquivos foram afetados pelo respectivo conjunto.
Você também pode visualizar o histórico de cada arquivo clicando com o botão direito do mouse e selecionando View file history, que mostra uma lista das alterações feitas no arquivo. Você também pode clicar com o botão direito do mouse em uma versão mais antiga e selecionar Revert to this revision.
10. Como conectar o Plastic SCM à Unreal Engine
Se você estiver usando o Plastic SCM com a Unreal Engine, poderá usar o controle de código-fonte dentro do editar sem precisar de janelas separadas para a maioria das tarefas. Saiba mais sobre o plug-in da Unreal Engine no link abaixo.
Mais guias úteis
Explore as práticas recomendadas e truques mais avançados para o controle de versão.
Implemente um fluxo de trabalho derivado de tarefa
Descubra como incorporar uma filosofia e um fluxo de trabalho rápido e flexível em sua equipe. Um fluxo de trabalho derivado de tarefa ajuda equipes a obterem agilidade por meio de um fluxo contínuo de alterações.
Práticas recomendadas de VCS e organização de projetos
Aprenda os principais conceitos de controle de versão, bem como dicas e truques que você pode usar ao configurar seu projeto da Unity, a fim de garantir que a colaboração em equipe seja tranquila e eficiente.