- Dokumentacja
- Locus
- Kontrola wersji
Kontrola wersji
Locus działa bez kontroli wersji. Gdy Unreal ma aktywnego dostawcę, Locus stosuje zasady zależne od dostawcy zgodnie z własnością każdego typu zawartości.
Własność określa zachowanie dostawcy
Dział zatytułowany „Własność określa zachowanie dostawcy”| Zawartość | Zachowanie dostawcy |
|---|---|
| Współdzielone Notatki | Oznacz do dodania dla nowych; jawne pobranie do edycji, status i bezpieczne usuwanie dla kontrolowanych |
| Prywatne Notatki | Bez zapytań do dostawcy i bez operacji u dostawcy |
| Współdzielone Pinezki | Oznacz do dodania dla nowych; jawne pobranie do edycji, status i bezpieczne usuwanie dla kontrolowanych |
| Prywatne Pinezki | Bez zapytań do dostawcy i bez operacji u dostawcy |
| Dokumenty | Należą do projektu; tworzone jako Nieśledzone, a następnie jawnie Oznacz do dodania; pobranie do edycji, status i bezpieczne usuwanie dla kontrolowanych |
Prywatna zawartość jest zapisywana lokalnie w obszarze Saved projektu. W przypadku Prywatnych Notatek i Pinezek Locus nigdy nie odpytuje dostawcy ani nie wykonuje za jego pośrednictwem żadnych operacji.
Tryb lokalny
Dział zatytułowany „Tryb lokalny”Jeśli nie skonfigurowano żadnego dostawcy, Locus przechodzi w tryb lokalny. Pliki lokalne i nieśledzone można edytować bez ostrzeżeń dostawcy i wywołań w tle; notatka, pinezka i dokument nie pokazują statusu dostawcy, wskaźnika, podpowiedzi, wskazówek, afordancji Oznacz do dodania ani Pobierz do edycji. Udostępniona treść pozostaje w katalogu głównym należącym do projektu.
Skonfigurowany, ale niedostępny dostawca jest odrębny i zapewnia ochronę znanych kontrolowanych treści. Jeśli jest dostępny, na pasku stanu używana jest standardowa ikona kontroli wersji Unreal. Pokaż status Kontroli wersji steruje tylko kompaktowymi wskaźnikami rzędowymi; czyste, gąsienicowe rzędy pozostają ciche, jeśli jest to udokumentowane.
Pobieranie do edycji i stany tylko do odczytu
Dział zatytułowany „Pobieranie do edycji i stany tylko do odczytu”Wybieranie, otwieranie lub czytanie kontrolowanej zawartości nie powoduje jej sprawdzenia. Udostępniony notatka wymaga jawnego Pobierz do edycji. Obsługiwana mutacja kontrolowanego współdzielonego pinezka żąda automatycznie realizacji transakcji i przebiega tylko wtedy, gdy jest to dozwolone; awaria zapewnia ochronę.
Kontrolowane Dokumenty pozostają dostępne do odczytu, ale ich autorytatywne akcje Markdown Tryb edycji i Zapisz pozostają niedostępne, dopóki pobranie do edycji się nie powiedzie. Ta sama ochrona obowiązuje, gdy kontrolowany plik został pobrany do edycji przez innego użytkownika lub klienta, jest nieaktualny, odłączony od wymaganego dostawcy albo znajduje się w stanie, którego Locus nie może zweryfikować. Eksportuj kopię pozostaje dostępne dla Dokumentów, gdy ma to zastosowanie.
Po ponownym połączeniu dostawcy odśwież Kontrolę wersji lub Locus, jeśli to konieczne. Stan kontrolowany powróci, ale czysty plik pozostanie tylko do odczytu do czasu jawnego pobrania do edycji.
Locus nie udostępnia obejścia Make Writable dla kontrolowanego pliku tylko do odczytu.
Nowe pliki i Oznacz do dodania
Dział zatytułowany „Nowe pliki i Oznacz do dodania”Nowe współdzielone notatka zachowują żądanie Oznacz do dodania po utworzeniu; niepowodzenie pozostawia prawidłowy plik do ponownej próby. Nowe współdzielone pinezka pozostają Untracked do czasu wyraźnego dodania, w tym kwalifikującego się wielokrotnego wyboru. Udostępniona migawka pinezka to oddzielny obraz z własnym stanem dodania lub pobrania.
Nowe Dokumenty celowo pozostają Nieśledzone. Najpierw utwórz, uporządkuj, zmień nazwę, przenieś i edytuj Dokument, a następnie użyj Oznacz do dodania, gdy jego ostateczna ścieżka będzie stabilna. Nieśledzony Dokument można zmienić lub przenieść, gdy jest to poza tym bezpieczne. Dokument oznaczony do dodania lub już kontrolowany nie może zostać zmieniony ani przeniesiony przez Locus, ponieważ Locus nie może zagwarantować neutralnego względem dostawcy transakcyjnego przeniesienia. Nie używa obejścia Make Writable ani nie prosi o wyłączenie kontroli wersji w celu obejścia tej granicy.
Plik lokalny nie jest współdzielony z zespołem, dopóki nie zostanie dodany i przesłany w zwykłym procesie projektu. Po przesłaniu plik jest kontrolowany i przy kolejnych edycjach używa Pobierz do edycji; nie jest ponownie oznaczany do dodania.
Usuwanie
Dział zatytułowany „Usuwanie”Usunięcie wymaga potwierdzenia. W przypadku kontrolowanych plików Locus sprawdza zgłoszony stan i kieruje usunięcie przez dostawcę przed lokalnym czyszczeniem. Blokuje usunięcie, gdy inny użytkownik posiada pobranie do edycji, plik jest nieaktualny lub nie można ustalić bezpieczeństwa.
Wskazówki dotyczące Perforce
Dział zatytułowany „Wskazówki dotyczące Perforce”Perforce to dostawca, dla którego istnieją obecne dowody walidacji projektu. Typowym wyborem typemap dla współpracy nad Notatkami i Pinezkami jest:
text+l //....uenotetext+l //....locuspinTraktuje to pliki oparte na JSON jako tekst z wyłączną blokadą. Dokumenty Markdown są zwykłymi plikami tekstowymi; wybierz zasady .md odpowiednie dla repozytorium. Locus nigdy sam nie edytuje typemap Perforce.
Inni dostawcy kontroli wersji Unreal są obsługiwani w miarę możliwości i nie zostali zweryfikowani dla wersji 1.0. Przed poleganiem na nich sprawdź zachowanie dostawcy w projekcie tymczasowym.
Perforce jest certyfikowanym dostawcą wersji 1.1. Inni dostawcy kontroli źródła Unreal starają się i nie są zweryfikowani; przetestuj je w jednorazowym projekcie.
Odzyskiwanie i konflikty zewnętrzne
Dział zatytułowany „Odzyskiwanie i konflikty zewnętrzne”Migawki odzyskiwania chronią niezapisaną pracę lokalną i nie zastępują kontroli wersji. Konflikt zewnętrzny występuje, gdy zawartość na dysku zmienia się, podczas gdy lokalny edytor ma oczekujące zmiany; Locus blokuje ciche zastąpienie i oferuje bezpieczne działania umożliwiające rozwiązanie konfliktu. Stan nieaktualności kontroli wersji i konflikty edytora są powiązanymi, ale odrębnymi warunkami.
Zobacz sekcje odzyskiwania w Notatkach, Pinezkach i Dokumentach albo użyj strony Rozwiązywanie problemów.