uVersion
Português
Baixar →

Wiki

Quickstart

Seu primeiro checkin em menos de 10 minutos, sem terminal.

Esta página é para você que está chegando a um projeto uVersion e quer começar a trabalhar. Tudo acontece no cliente desktop: nenhuma linha de comando para digitar.

Você só precisa saber o endereço do servidor uVersion do seu estúdio, seu nome de usuário e sua senha (o administrador do seu estúdio passou essas informações para você).

1. Instalar o cliente desktop

Baixe o cliente para o seu sistema em uversion.io/downloads:

  • Windows: uVersion_x.y.z_x64-setup.exe. Dê dois cliques e siga o instalador.
  • macOS (Apple Silicon): uVersion_x.y.z_macos-arm64.app.zip. Descompacte e arraste uVersion.app para Aplicativos.
  • Linux: uVersion_x.y.z_amd64.AppImage (portátil) ou uVersion_x.y.z_amd64.deb (apt).

2. Entrar no servidor

Abra o cliente desktop. Na primeira abertura, ele pede três informações:

  • Endereço do servidor: o endereço do seu estúdio (por ex. https://uversion.mygamestudio.com)
  • Nome de usuário
  • Senha

Depois de entrar, o cliente memoriza sua sessão. Você não precisará digitar a senha de novo no dia a dia.

3. Trazer o projeto para a sua máquina

A lista de projetos com o botão Clone e uma barra de progresso de download.

No cliente desktop:

  1. Você vê a lista de projetos aos quais tem acesso
  2. Clique em Clone ao lado do projeto desejado
  3. Escolha onde baixá-lo no seu disco (uma pasta vazia)
  4. O cliente baixa o projeto inteiro. Você vê uma barra de progresso

Conte com cerca de 1 a 2 minutos por 10 GB em uma conexão de fibra. Quando terminar, o projeto está pronto para ser aberto no Unreal.

4. Editar e enviar um arquivo

O estado de checkout mostrando o nome de um colega e o botão Request release.

O fluxo de trabalho típico em 3 etapas:

  1. Reservar o arquivo antes de editá-lo (checkout). Ninguém mais pode alterá-lo enquanto você o mantém reservado.
  2. Editar o arquivo no Unreal ou em qualquer outra ferramenta.
  3. Enviar a sua alteração (checkin) com uma mensagem curta explicando o que você mudou.

Se um colega já reservou o arquivo, você vê o nome dele e um botão Solicitar liberação que envia uma notificação a ele.

Por que não consigo salvar este arquivo? Os arquivos do projeto ficam somente leitura enquanto você não os reservou (checkout). É uma proteção: evita que você edite um asset por engano enquanto um colega está trabalhando nele. Faça um checkout pelo cliente desktop ou diretamente no Unreal, e o arquivo se torna editável.

5. Trabalhar direto pelo Unreal

Se o seu projeto inclui o plugin uVersion (pasta Plugins/uVersion/ no projeto), você pode fazer tudo sem sair do editor:

  1. Abra o projeto no Unreal
  2. Menu Tools → Source Control → Connect to Source Control
  3. Escolha uVersion na lista suspensa
  4. Confirme. Suas credenciais são obtidas automaticamente do cliente desktop.

Depois de conectado, todo o controle de versão vive dentro do Unreal:

  • Clique com o botão direito em um asset → Source Control → Check Out para reservá-lo
  • Ícones pequenos no Content Browser para ver o estado de cada asset
  • Diff de Blueprint disponível pelo histórico
  • Validação automática no momento do checkin (Blueprint que compila, convenções de nomenclatura, etc.)

Em seguida