Synchronizacja skryptów

Roblox Studio ma wbudowany edytor skryptów do edytowania kodu w twoim projekcie Roblox. Edytor zawiera kluczowe funkcje, takie jak linting, sprawdzanie typów, autouzupełnianie i współdzielona edycja.

Jednak wielu deweloperów ma preferowany edytor tekstu lub zintegrowane środowisko programistyczne (IDE), takie jak Visual Studio Code, Cursor, Sublime Text lub Notepad++. Popularne środowiska programistyczne często oferują funkcje lub wtyczki, które nie są dostępne w Studio. Aby używać zewnętrznego edytora lub IDE z Studio, włącz funkcję Synchronizacja skryptów.

Synchronizacja skryptów działa poprzez synchronizowanie skryptów w twoim modelu danych z plikami tekstowymi na twoim lokalnym dysku. Zmiany wprowadzone w plikach Luau na dysku są stosowane do skryptów w Studio i odwrotnie. Ta synchronizacja oznacza, że możesz edytować skrypt w zewnętrznym edytorze, takim jak VS Code, i natychmiast zobaczyć zmiany w Studio.

Kiedy używać Synchronizacji skryptów

• Jeśli chcesz używać preferowanego edytora tekstu lub zaktualizować kod w systemie kontroli wersji, ale używać Studio do wszystkiego innego, Synchronizacja skryptów jest dobrym rozwiązaniem. Działa również z wbudowanymi narzędziami do współpracy Robloxa, z których często nie korzystają narzędzia zewnętrzne.

  Synchronizacja skryptów dobrze współdziała z istniejącymi projektami Roblox, ponieważ jest to dodatkowa funkcja, a nie całkowita zmiana w sposobie zarządzania projektem.

• Jeśli chcesz zaktualizować cały projekt (nie tylko kod) w systemie kontroli wersji lub używać swojego systemu plików jako źródła prawdy dla swojego projektu, lepszym wyborem będą narzędzia zewnętrzne takie jak Rojo.

Ustawienia Synchronizacji skryptów

1. W Eksploratorze wybierz jeden lub więcej folderów, które chcesz synchronizować.

2. Kliknij prawym przyciskiem i wybierz Synchronizacja skryptów ⟩ Synchronizuj z katalogiem.

   

3. Wybierz katalog na swoim komputerze (lub utwórz nowy) i kliknij Zapisz.

4. W Studio kliknij prawym przyciskiem na folderze ponownie i wybierz Synchronizacja skryptów ⟩ Pokaż w Eksploratorze (Windows) lub Pokaż w Finderze (macOS).

5. Otwórz katalog w swoim preferowanym edytorze tekstu.

   Alternatywnie, kliknij prawym przyciskiem na pojedynczy skrypt w Studio i wybierz Otwórz w zewnętrznym edytorze.

Możesz synchronizować pojedyncze skrypty, ale zdecydowanie zalecamy synchronizowanie folderów; jeśli zsynchronizujesz folder, Synchronizacja skryptów automatycznie zsynchronizuje jego podrzędne foldery i skrypty, co pozwala na tworzenie, usuwanie i zmienianie nazw skryptów bez konieczności włączania synchronizacji za każdym razem.

Po skonfigurowaniu Synchronizacji skryptów prawie na pewno będziesz chciał dodać rozszerzenie LSP do swojego edytora tekstu.

Kluczowe wskazówki

• Synchronizacja skryptów synchronizuje tylko instancje Script, LocalScript, ModuleScript i Folder. Wszystkie inne instancje w zsynchronizowanym folderze są ignorowane. Unikaj synchronizowania folderów, które zawierają skrypty obok innych instancji.

• Nie synchronizuj skryptów, które mają atrybuty lub tagi. Synchronizacja skryptów ignoruje te atrybuty, co może prowadzić do utraty danych, jeśli tworzysz lub usuwasz skrypty lub zaczynasz synchronizować z starszą wersją swoich plików na dysku.

• Synchronizacja skryptów wymaga, aby nazwy skryptów były zgodne z twoim systemem plików - bez zduplikowanych nazw lub nieobsługiwanych znaków. Jeśli Studio napotka jakiekolwiek z tych problemów, zgłosi błąd i poprosi cię o rozwiązanie sytuacji przed wznowieniem synchronizacji.

• Jeśli jakiekolwiek zsynchronizowane pliki lub foldery zmienią się, gdy Studio jest zamknięte, Studio zapyta cię, jak chcesz rozwiązać tę sytuację, gdy ponownie otworzysz miejsce.

• Usunięcie instancji najwyższego poziomu (lub "korzeniowej") - instancji, którą początkowo zsynchronizowałeś - na twoim lokalnym dysku może spowodować zgłoszenie błędu przez Studio. Aby usunąć instancję najwyższego poziomu:

  1. W Studio kliknij prawym przyciskiem na skrypt lub folder i wybierz Synchronizacja skryptów ⟩ Zatrzymaj synchronizację.
  2. Wybierz opcję Usuń plik(i) lub Usuń folder(y), aby usunąć instancję z lokalnego dysku.
  3. Usuń skrypt lub folder w Studio.

  Możesz usuwać instancje podrzędne w Studio lub na swoim lokalnym dysku bez wyłączania synchronizacji, a usunięcie będzie synchronizowane zgodnie z oczekiwaniami.

Ustawienia serwera językowego

Serwery językowe oferują twojemu edytorowi tekstu funkcje specyficzne dla języka, takie jak autouzupełnianie, sprawdzanie typów, "przejdź do definicji" i inne. Dla VS Code zalecamy Serwer Języka Luau.

Rozszerzenia protokołu serwera językowego (LSP) muszą rozumieć hierarchię modelu danych projektu, aby działać poprawnie. Rozszerzenie VS Code współpracuje z towarzyszącą wtyczką Studio (Towarzyszący Serwer Języka Luau), która dostarcza te dane.

Zdecydowanie zalecamy zainstalowanie obu. Jeśli używasz rozszerzenia VS Code i towarzyszącej wtyczki Studio, funkcje językowe będą działać poprawnie w VS Code podczas korzystania z Synchronizacji skryptów.

Zalecane rozszerzenia

• Roblox Luau LSP i Towarzyszący Serwer Języka Luau - Funkcje językowe (patrz powyżej)
• selene - Statyczna analiza kodu (linting)
• StyLua - Automatyczne formatowanie kodu

Zasady synchronizacji

Podczas synchronizacji instancji z dziećmi z katalogiem na dysku, Studio automatycznie synchronizuje operacje tworzenia, zmieniania nazw, przenoszenia i usuwania dzieci z odpowiadającymi im plikami i folderami na dysku. Takie podejście pozwala utrzymać twój kod bez konieczności ręcznego zatrzymywania i uruchamiania synchronizacji na poszczególnych skryptach.

Na dysku, Synchronizacja skryptów używa następujących zasad do rozróżniania różnych typów skryptów względem siebie.

Ustawienia

Synchronizacja skryptów ma kilka ustawień w oknie Ustawienia Studio (AltS lub ⌥S). Opcje domyślne są dobrym rozwiązaniem dla większości zastosowań.