스크립트 동기화

Roblox Studio에는 Roblox 프로젝트의 코드를 편집하기 위한 스크립트 편집기가 내장되어 있습니다. 이 편집기에는 린팅, 타입 체크, 자동 완성 및 공동 편집과 같은 주요 기능이 포함되어 있습니다.

하지만 많은 개발자들은 Visual Studio Code, Cursor, Sublime Text 또는 Notepad++와 같은 선호하는 텍스트 편집기나 통합 개발 환경(IDE)이 있습니다. 인기 있는 개발 환경은 종종 Studio에 없는 기능이나 플러그인이 있습니다. Studio와 외부 편집기 또는 IDE를 사용하려면 스크립트 동기화 기능을 활성화하세요.

스크립트 동기화는 데이터 모델의 스크립트를 로컬 디스크의 텍스트 파일과 동기화하여 작동합니다. 디스크의 Luau 파일에 대한 변경 사항은 Studio의 스크립트에 적용되며, 그 반대도 마찬가지입니다. 이 동기화 기능 덕분에 외부 편집기인 VS Code에서 스크립트를 편집하면 Studio에서 즉시 변경 사항을 확인할 수 있습니다.

스크립트 동기화를 사용할 때

• 선호하는 텍스트 편집기를 사용하고 코드만 버전 관리 시스템에 체크인하려는 경우, Studio에서는 다른 모든 것을 위해 스크립트 동기화가 좋은 선택입니다. 이 기능은 타사 도구와는 달리 Roblox의 내장 협업 도구와도 잘 작동합니다.

  스크립트 동기화는 기존 Roblox 프로젝트와 잘 작동하며, 프로젝트를 관리하는 방법을 완전히 변경하는 것이 아니라 추가적인 기능입니다.

• 전체 프로젝트(코드뿐만 아니라)를 버전 관리 시스템에 체크인하거나 파일 시스템을 프로젝트의 진실한 출처로 사용하려는 경우 타사 도구인 Rojo가 더 나은 선택입니다.

스크립트 동기화 설정하기

1. 탐색기에서 동기화할 하나 이상의 폴더를 선택합니다.

2. 마우스 오른쪽 버튼을 클릭하고 스크립트 동기화 ⟩ 디렉토리와 동기화를 선택합니다.

   

3. 컴퓨터에서 디렉토리를 선택하거나 새로 만들고 저장을 클릭합니다.

4. Studio에서 다시 폴더를 오른쪽 클릭하고 스크립트 동기화 ⟩ 탐색기에서 표시(Windows) 또는 파인더에서 표시(macOS)를 선택합니다.

5. 선호하는 텍스트 편집기에서 디렉토리를 엽니다.

   또는 Studio에서 개별 스크립트를 오른쪽 클릭하고 외부 편집기에서 열기를 선택할 수 있습니다.

개별 스크립트를 동기화할 수 있지만 폴더를 동기화하는 것을 강력히 추천합니다. 폴더를 동기화하면 스크립트와 자식 폴더가 자동으로 동기화되므로, 매번 동기화를 활성화하지 않고도 스크립트를 생성, 삭제 및 이름 변경할 수 있습니다.

스크립트 동기화 설정 후, LSP 확장 프로그램을 추가하는 것을 원할 것입니다 텍스트 편집기에.

주요 팁

• 스크립트 동기화는 Script, LocalScript, ModuleScript 및 Folder 인스턴스만 동기화합니다. 동기화된 폴더에 있는 다른 인스턴스는 무시됩니다. 스크립트와 다른 인스턴스가 함께 있는 폴더는 동기화하지 마세요.

• 속성이나 태그가 있는 스크립트를 동기화하지 마세요. 스크립트 동기화는 이것들을 무시하므로 디스크의 파일과 동기화할 때 스크립트를 생성하거나 삭제하면 데이터 손실이 발생할 수 있습니다.

• 스크립트 동기화는 스크립트 이름이 파일 시스템과 호환되어야 합니다—중복 이름이나 지원되지 않는 문자가 없도록 하세요. Studio에서 이러한 문제가 발생하면 오류가 발생하고 동기화를 재개하기 전에 문제를 해결하라고 요청합니다.

• Studio가 닫혀 있는 동안 동기화된 파일이나 폴더가 변경되면, Studio는 플레이스를 다시 열 때 어떻게 해결할지 물어봅니다.

• 로컬 디스크에서 최상위(또는 "루트") 인스턴스—초기에 동기화된 인스턴스—를 삭제하면 Studio에서 오류를 발생시킬 수 있습니다. 최상위 인스턴스를 삭제하려면:

  1. Studio에서 스크립트 또는 폴더를 오른쪽 클릭하고 스크립트 동기화 ⟩ 동기화 중지를 선택합니다.
  2. 파일 삭제 또는 폴더 삭제 옵션을 선택하여 로컬 디스크에서 인스턴스를 삭제합니다.
  3. Studio에서 스크립트 또는 폴더를 삭제합니다.

  스튜디오에서 또는 로컬 디스크에서 자식 인스턴스를 동기화 해제 없이 삭제할 수 있으며, 삭제는 예상대로 동기화됩니다.

언어 서버 설정하기

언어 서버는 텍스트 편집기에 자동 완성, 타입 체크, "정의로 이동" 등의 언어별 기능을 제공합니다. VS Code의 경우 Luau Language Server를 추천합니다.

언어 서버 프로토콜(LSP) 확장 기능은 제대로 작동하기 위해 프로젝트의 데이터 모델 계층 구조를 이해해야 합니다. VS Code 확장은 이에 대한 데이터를 제공하는 Companion Studio 플러그인(Luau Language Server Companion)와 함께 제공됩니다.

두 개 모두 설치하는 것을 강력히 추천합니다. VS Code 확장 및 Companion Studio 플러그인을 사용하면 스크립트 동기화를 사용하는 동안 VS Code에서 언어 기능이 올바르게 작동합니다.

추천 확장

• Roblox Luau LSP 및 Luau Language Server Companion - 언어 기능(위 참조)
• selene - 정적 코드 분석(린팅)
• StyLua - 자동 코드 포맷팅

동기화 규칙

디스크의 디렉토리와 자식이 있는 인스턴스를 동기화할 때, Studio는 자식의 생성, 이름 변경, 이동 및 삭제 작업을 자동으로 동기화합니다. 이러한 접근 방식으로 코드를 수동으로 개별 스크립트에서 동기화를 중지하고 다시 시작하지 않고도 유지할 수 있습니다.

디스크에서 스크립트 동기화는 서로 다른 유형의 스크립스를 구분하기 위해 다음 규칙을 사용합니다.

설정

스크립트 동기화에는 Studio 설정 창(AltS 또는 ⌥S)에 여러 설정이 있습니다. 기본 옵션은 대부분의 사용 사례에 적합합니다.