Projetos criados após a versão 36.00 não poderão usar o caminho de arquivo fornecido abaixo para usar comandos de CLI. Ao navegar para o caminho do arquivo, procure urc2.exe.
Use os seguintes comandos da CLI para projetos após a versão 36.00:
Ver todas as revisões no seu repositório
urc2 revision list
Sincronizar com a revisão mais recente do projeto
urc2 revision sync
Sincronizar com uma revisão anterior no histórico do repositório
urc2 revision sync @[revision]
Obter uma visão geral de todos os ativos e seus status em uma determinada revisão
urc2 repository status
Reverter para uma revisão específica para continuar trabalhando a partir de um backup anterior
urc2 revision promote "description"
Reverter um ativo para a revisão atual para desfazer as alterações
urc2 file reset .\pathname
Liberar ativos desconectados por um membro específico da equipe para desbloquear você mesmo
urc2 lock release --force --owner <username>
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 Caminho > 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. Em geral, isso pode ser encontrado em
C:\Program Files\Epic Games\Fortnite\FortniteGame\Binaries\Win64Clique 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.
Como inicializar 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 janela do PowerShell aqui.
Casos de uso comuns da CLI
Listar todos os projetos aos quais você tem acesso com sua conta logada.
| Comandos de CLI |
|---|
urc project list |
urc p list |
Clique para ampliar a imagem.
Vendo todos os instantâneos do projeto.
| Comandos de CLI |
|---|
urc project snapshot list |
urc p s list |
Sincronizar com um instantâneo anterior para retornar 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 de CLI |
|---|
urc project snapshot get <número do instantâneo> |
urc p s get <número do instantâneo> |
Clique para ampliar a imagem.
Sincronizando com o mais recente para que você possa recuperar as atualizações de todos na Ilha.
| Comandos de CLI |
|---|
urc project snapshot get |
urc p s get |
Clique para ampliar a imagem.
Obtenha uma visão geral de todos os ativos e seus status no instantâneo atual antes de enviar.
| Comandos de CLI |
|---|
urc project status –-extended |
urc p status –-extended |
Clique para ampliar a imagem.
Reverter para um snapshot específico para continuar trabalhando a partir de um backup anterior.
Sincronize o projeto com um instantâneo anterior.
| Comandos de CLI |
|---|
urc projects snapshots get <número do instantâneo> |
Se precisar ver uma lista de instantâneos para poder selecionar com qual versão do projeto deseja sincronizar, use o comando:
| Comandos de 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 de 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 Conferir 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 de CLI |
|---|
urc asset revert .\pathname |
urc a revert .\pathname |
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 de CLI |
|---|
urc project forcerelease <projectID> –-user UserName |
urc p forcerelease <projectID> –-user UserName |
Clique para ampliar a imagem.