Interfejs wiersza poleceń (Command Line Interface – CLI) w systemie kontroli wersji Unreal Revision Control (URC) umożliwia wykonywanie czynności kontroli wersji projektu przy użyciu zewnętrznego narzędzia wiersza poleceń, takiego jak PowerShell. Te czynności można zwykle wykonywać przy użyciu interfejsu użytkownika, ale niektóre możliwości wykraczają poza funkcje obecnie obsługiwane przez zwykły interfejs.
Dokument omawia następujące zagadnienia:
-
Rozpoczęcie pracy z CLI
-
Typowe zadania i sposób ich realizacji w CLI
Zanim zaczniesz
Aby używać wiersza poleceń, musisz wiedzieć, gdzie w Eksploratorze Windows znajdują się pliki URC, i skonfigurować zmienną środowiskową tak, aby przy użyciu URC tworzyć wiersze poleceń i ich używać.
Zanim ustawisz zmienną środowiskową, upewnij się, że folder z plikiem urc.exe znajduje się w zmiennej ścieżki (path).
-
Otwórz ustawienia Windows, wybierz System > Informacje > Zaawansowane ustawienia systemu. Otwiera się panel Właściwości systemu.
-
Kliknij Zmienne środowiskowe…
Kliknij obraz, aby go powiększyć.
-
Na liście Zmienne użytkownika wybierz Path > Edytuj, aby wyedytować zmienne środowiskowe dla ścieżki.
Kliknij obraz, aby go powiększyć.
Twoja nazwa użytkownika pojawia się po C:\Users\
-
Wybierz Przeglądaj i wybierz ścieżkę pliku, która prowadzi do pliku urc.exe.
Kliknij obraz, aby go powiększyć.
-
Klikaj OK, aż zamkniesz wszystkie otwarte panele.
Zmienna środowiskowa jest teraz prawidłowo wyedytowana.
Uruchamianie PowerShell
W Eksploratorze Windows otwórz projekt Unreal Editor dla Fortnite (UEFN), nad którym pracujesz.
Zanim będziesz używać innych poleceń URC CLI, zaloguj się najpierw do UEFN.
Zależy to od tego, czy użytkownik ostatnio logował się do UEFN. Nie musisz wywoływać urc auth login, jeśli UEFN jest otwarty i jesteś zalogowanym użytkownikiem, a token jeszcze nie wygasł. Jeśli używasz CLI, a UEFN nie jest otwarty lub wygasł token, musisz się zalogować do CLI.
-
Naciśnij Shift + PPM, aby otworzyć menu kontekstowe.
-
Wybierz Otwórz okno PowerShell tutaj.
Typowe przypadki użycia CLI
Wyświetlenie wszystkich projektów, do których masz dostęp po zalogowaniu się na konto.
| Polecenia CLI |
|---|
| urc project list |
| urc p list |
Kliknij obraz, aby go powiększyć.
Wyświetlanie wszystkich migawek projektu.
| Polecenia CLI |
|---|
| urc project snapshot list |
| urc p s list |
Synchronizacja z poprzednią migawką, aby się cofnąć w historii projektu.
Zanim zsynchronizujesz pracę z konkretną migawką, zamknij projekt lub edytor, aby uniknąć błędów synchronizacji plików projektu.
| Polecenia CLI |
|---|
| urc project snapshot get |
| urc p s get |
Kliknij obraz, aby go powiększyć.
Synchronizacja z najnowszą wersją, aby pobrać wszystkie aktualizacje wyspy wprowadzone przez pozostałych użytkowników.
| Polecenia CLI |
|---|
| urc project snapshot get |
| urc p s get |
Kliknij obraz, aby go powiększyć.
Pobieranie podsumowania wszystkich zasobów i ich stanu w aktualnej migawce przed przesłaniem.
| Polecenia CLI |
|---|
| urc project status –extended |
| urc p status –extended |
Kliknij obraz, aby go powiększyć.
Wycofanie do konkretnej migawki, aby kontynuować pracę na poprzedniej kopii zapasowej.
Synchronizacja projektu z jedną z poprzednich migawek
| Polecenia CLI |
|---|
| urc projects snapshots get |
Jeśli chcesz wyświetlić listę migawek, aby wybrać, z którą wersją projektu zsynchronizować pracę, użyj polecenia:
| Polecenia CLI |
|---|
| urc projects snapshots list |
Kliknij obraz, aby go powiększyć.
Skopiuj i wklej folder Plugins do komputera, aby mieć kopię zapasową swoich zasobów.
Następnie zsynchronizuj pracę z najnowszą migawką.
| Polecenia CLI |
|---|
| urc projects snapshots get |
Po zsynchronizowaniu projektu z najnowszą migawką wykonaj następujące czynności:
-
Usuń Plugins z folderu aktualnego projektu UEFN.
-
Skopiuj i wklej poprzedni folder Plugins z komputera do folderu projektu.
-
Otwórz projekt w UEFN i upewnij się, że stan projektu wygląda zgodnie z planem.
-
Kliknij Wprowadź zmiany, jeśli projekt wygląda zgodnie z oczekiwaniami, aby utworzyć nową migawkę odzwierciedlającą nowy stan projektu.
Przywracanie zasobu do aktualnej migawki, aby wycofać zmiany.
| Polecenia CLI |
|---|
| urc asset revert .\nazwaścieżki |
| urc a revert .\nazwaścieżki |
Kliknij obraz, aby go powiększyć.
Zwalnianie zasobów wyprowadzonych przez konkretnego członka zespołu, aby kontynuować pracę na niezablokowanych plikach.
Uzyskaj identyfikator projektu, otwierając projekt w Portalu Twórcy. Identyfikator projektu widać w URL.
Kliknij obraz, aby go powiększyć.
Tę funkcję może wykonywać tylko administrator zespołu. Upewnij się, że znasz swoją rolę w zespole na Portalu Twórcy.
| Polecenia CLI |
|---|
| urc project forcerelease |
| urc p forcerelease |
Kliknij obraz, aby go powiększyć.