I progetti creati dopo il rilascio della versione 36.00 non potranno utilizzare il percorso file indicato di seguito per utilizzare i comandi CLI. Quando cerchi il percorso del file, individua il file urc2.exe.
Utilizza i seguenti comandi CLI per i progetti successivi alla versione 36.00 per compiere le seguenti azioni:
Visualizzare tutte le revisioni nel tuo repository
urc2 revision list
Eseguire la sincronizzazione con la revisione più recente del progetto
urc2 revision sync
Eseguire la sincronizzazione con una revisione precedente nella cronologia del tuo repository
urc2 revision sync @[revision]
Visualizzare una panoramica di tutti gli asset e del loro stato all'interno di una determinata revisione
urc2 repository status
Ripristinare una revisione specifica per continuare a lavorare da un backup precedente
urc2 revision promote "description"
Ripristina un asset alla revisione corrente per annullare le modifiche
urc2 file reset .\pathname
Rilascia gli asset attualmente gestite da un membro specifico del team per permetterti di sbloccarle
urc2 lock release --force --owner <username>
L' Interfaccia a riga di comando (CLI) di Unreal Revision Control (URC) ti permette di eseguire azioni per il controllo di revisione sul tuo progetto utilizzando uno strumento da riga di comando di terze parti come PowerShell. Sebbene queste azioni siano spesso eseguibili con l'interfaccia utente standard, alcune consentono di raggiungere risultati più avanzati.
In questo documento vengono trattati i seguenti argomenti:
Come iniziare a utilizzare la CLI
Casi di utilizzo comuni e come applicarli con la CLI
Prima di iniziare
Per utilizzare le righe di comando, devi prima conoscere dove si trovano i file URC in Windows Explorer e impostare una variabile d'ambiente per creare e utilizzare le righe di comando in URC.
Prima di impostare la variabile d'ambiente, assicurati di avere definito la cartella del file urc.exe nella variabile percorso.
Apri le impostazioni di Windows e seleziona Sistema > Informazioni sul sistema > Impostazioni di sistema avanzate. Si apre il pannello Proprietà del sistema.
Fai clic su Variabili d'ambiente...
Fai clic per ingrandire l'immagine.
Seleziona Percorso > Modifica dall'elenco Variabili utente per modificare le variabili d'ambiente del percorso.
Fai clic per ingrandire l'immagine.
Il tuo nome viene visualizzato dopo C:\Users\
Seleziona Sfoglia e scegli il percorso che porta ai tuoi file urc.exe. In genere, si trova in
C:\Programmi\Epic Games\Fortnite\FortniteGame\Binaries\Win64Fai clic per ingrandire l'immagine. Fai clic su OK fino a quando tutti i pannelli aperti saranno chiusi.
Hai modificato correttamente una variabile di ambiente
Avvio di PowerShell
Apri il progetto di Unreal Editor per Fortnite (UEFN) su cui stai lavorando con Windows Explorer.
Assicurati di aver eseguito \l'accesso a UEFN prima di iniziare a utilizzare altri comandi CLI di Unreal Revision Control.
Controlla se hai eseguito l'accesso a UEFN di recente. Non dovrai richiamare urc auth login se UEFN è aperto e hai eseguito l'accesso, a meno che il token non sia scaduto. Se utilizzi la CLI mentre UEFN non è aperto o dopo che il token è scaduto, dovrai eseguire un accesso alla CLI.
Tieni premuto il tasto destro del mouse e fai clic su Maiusc per aprire il menu contestuale.
Scegli la finestra Apri PowerShell qui.
Casi di utilizzo comuni della CLI
Elenco di tutti i progetti a cui hai accesso con l'account con cui hai eseguito l'accesso.
| Comandi CLI |
|---|
urc project list |
urc p list |
Fai clic per ingrandire l'immagine.
Visualizzazione di tutte le istantanee del tuo progetto.
| Comandi CLI |
|---|
urc project snapshot list |
urc p s list |
Sincronizzazione a un'istantanea precedente per rivedere la cronologia di progetto.
Chiudi il progetto o l'editor prima di sincronizzare a un'istantanea specifica per evitare errori di sincronizzazione dei file di progetto.
| Comandi CLI |
|---|
urc project snapshot get <number of snapshot> |
urc p s get <number of snapshot> |
Fai clic per ingrandire l'immagine.
Sincronizzazione all'ultima versione per ricevere gli aggiornamenti di tutti gli utenti nell'isola.
| Comandi CLI |
|---|
urc project snapshot get |
urc p s get |
Fai clic per ingrandire l'immagine.
Visualizzazione di una panoramica di tutti gli asset e del loro stato all'interno dell'istantanea corrente prima dell'invio.
| Comandi CLI |
|---|
urc project status –-extended |
urc p status –-extended |
Fai clic per ingrandire l'immagine.
Ripristina un'istantanea specifica per continuare a lavorare da un backup precedente.
Sincronizza il tuo progetto a un'istantanea precedente
| Comandi CLI |
|---|
urc projects snapshots get <number of snapshot> |
Se desideri visualizzare un elenco di istantanee per selezionare la versione del progetto che vuoi sincronizzare, usa il comando:
| Comandi CLI |
|---|
urc projects snapshots list |
Fai clic per ingrandire l'immagine.
Copia e incolla la cartella Plugin sul desktop per mantenere un backup dei tuoi asset.
Di seguito, esegui la sincronizzazione all'istantanea più recente.
| Comandi CLI |
|---|
urc projects snapshots get |
Una volta sincronizzato il progetto all'ultima istantanea, procedi come segue:
Elimina i plugin dalla cartella del progetto UEFN corrente.
Copia e incolla la precedente cartella Plugin dal desktop nella cartella del progetto.
Apri il progetto in UEFN e verifica che il suo stato sia coretto.
Fai clic su Archivia modifiche se il progetto non presenta problemi per creare una nuova istantanea che rifletta il nuovo stato del progetto.
Ripristino di un asset all'istantanea corrente per annullare le modifiche.
| Comandi CLI |
|---|
urc asset revert .\pathname |
urc a revert .\pathname |
Fai clic per ingrandire l'immagine.
Rilascio degli asset estratti da un membro specifico del team per continuare a lavorare senza che qualcuno blocchi il lavoro.
Ottieni l'ID progetto aprendo il progetto nel Portale creatori. Puoi ora vedere l'ID progetto nell'URL.
Fai clic per ingrandire l'immagine.
Questa funzione può essere eseguita solo dall'admin di un team. Verifica il tuo ruolo nel team nel Portale creatori.
| Comandi CLI |
|---|
urc project forcerelease <projectID> –-user UserName |
urc p forcerelease <projectID> –-user UserName |
Fai clic per ingrandire l'immagine.