A interface de linha de comando (CLI) do Unreal Revision Control (URC) permite que você execute ações de controle de revisão em seu projeto usando uma ferramenta de linha de comando de terceiros, como o PowerShell. Embora essas ações muitas vezes possam ser executadas com a interface do usuário, algumas permitem ir além do que a interface suporta atualmente.
Este documento apresenta uma visão geral sobre:
-
Como começar a usar a CLI
-
Casos de uso comuns e como executá-los com a CLI
Antes de começar
Para usar linhas de comando, é necessário saber onde os arquivos do URC estão no Explorador de Arquivos e configurar uma variável de ambiente para criar e usar linhas de comando com o URC.
Antes de definir a variável de ambiente, certifique-se de definir a pasta onde o urc.exe existe na variável de caminho.

-
Abra as configurações do Windows e selecione Sistema > Sobre > Configurações avançadas do sistema. O painel Propriedades do Sistema é aberto.
-
Clique em Variáveis de Ambiente…
Clique para ampliar a imagem.
-
Selecione Path > Editar… na lista Variáveis de usuário para editar as variáveis de ambiente do caminho.
Clique para ampliar a imagem.
Seu nome aparece depois de "C:\Usuários".
-
Selecione Procurar… e escolha o caminho do arquivo que leva aos arquivos urc.exe.
Clique para ampliar a imagem.
-
Clique em OK até que todos os painéis abertos sejam fechados.
Você editou com sucesso uma variável de ambiente.
Iniciando o PowerShell
Abra o projeto do Unreal Editor para Fortnite (UEFN) no qual está trabalhando com o Explorador de Arquivos.

Certifique-se de iniciar uma sessão no UEFN antes de usar outros comandos de CLI do URC.
O que vai depender do fato de você ter entrado recentemente no UEFN. Não é necessário chamar urc auth login
se o UEFN estiver aberto e você estiver conectado, a menos que o token expire. Se usar a CLI sem o UEFN aberto ou depois que o token expirar, será necessário fazer o login na CLI.

-
Segure Shift e clique com o botão direito para abrir o menu contextual.
-
Escolha Abrir a janela do PowerShell aqui.
Casos de uso comuns da CLI
Listando todos os projetos aos quais você tem acesso com sua conta logada.
Comandos da CLI |
---|
urc project list |
urc p list |
Clique para ampliar a imagem.
Vendo todos os instantâneos do projeto.
Comandos da CLI |
---|
urc project snapshot list |
urc p s list |
Sincronizando com um instantâneo anterior para voltar no histórico do projeto.
Feche o projeto ou o editor antes de sincronizar com um instantâneo específico para evitar uma falha na sincronização dos arquivos do projeto.
Comandos da CLI |
---|
urc project snapshot get |
urc p s get |
Clique para ampliar a imagem.
Sincronizando com o mais recente para que você possa recuperar as atualizações de todos na ilha.
Comandos da CLI |
---|
urc project snapshot get |
urc p s get |
Clique para ampliar a imagem.
Obter uma visão geral de todos os ativos e seus status no instantâneo atual antes de enviar.
Comandos da CLI |
---|
urc project status –-extended |
urc p status –-extended |
Clique para ampliar a imagem.
Reverta para um instantâneo específico para continuar trabalhando a partir de um backup anterior.
Sincronize o projeto com um instantâneo anterior.
Comandos da CLI |
---|
urc projects snapshots get |
Se precisar ver uma lista de instantâneos para poder selecionar com qual versão do projeto deseja sincronizar, use o comando:
Comandos da CLI |
---|
urc projects snapshots list |
Clique para ampliar a imagem.
Copie e cole a pasta Plugins em sua área de trabalho para manter um backup dos ativos.

Depois, sincronize novamente com o instantâneo mais recente.
Comandos da CLI |
---|
urc projects snapshots get |
Depois de sincronizar efetivamente o projeto com o instantâneo mais recente, faça o seguinte:
-
Exclua os plugins da pasta atual do projeto do UEFN.
-
Copie e cole a pasta Plugins anterior da área de trabalho na pasta do projeto.
-
Abra seu projeto no UEFN e confirme se o estado do projeto está como você deseja.
-
Clique em Fazer check-in de alterações se o projeto estiver como o esperado para criar um novo instantâneo refletindo o novo estado do projeto.
Revertendo um ativo para o instantâneo atual para desfazer as alterações.
Comandos da CLI |
---|
urc asset revert .\nome do caminho |
urc a revert .\nome do caminho |
Clique para ampliar a imagem.
Liberação de ativos verificados por um membro específico da equipe, para que você possa continuar trabalhando sem que alguém bloqueie seu trabalho.
Obtenha o projectID, abrindo o projeto no Portal de Criadores. Você pode ver o ID do projeto no URL.
Clique para ampliar a imagem.
Esta função só pode ser executada por um administrador de equipe. Certifique-se de verificar sua função na equipe no Portal de Criadores.
Comandos da CLI |
---|
urc project forcerelease |
urc p forcerelease |
Clique para ampliar a imagem.