Đồng bộ kịch bản

Roblox Studio có một trình soạn thảo kịch bản tích hợp để chỉnh sửa mã trong dự án Roblox của bạn. Trình soạn thảo này bao gồm các tính năng chính như kiểm tra cú pháp, kiểm tra kiểu, tự động hoàn thành và chỉnh sửa cộng tác.

Nhiều nhà phát triển, tuy nhiên, có một trình soạn thảo văn bản hoặc môi trường phát triển tích hợp (IDE) ưa thích, chẳng hạn như Visual Studio Code, Cursor, Sublime Text, hoặc Notepad++. Các môi trường phát triển phổ biến thường có các tính năng hoặc plugin không tồn tại trong Studio. Để sử dụng một trình soạn thảo hoặc IDE bên ngoài với Studio, hãy kích hoạt tính năng Đồng bộ kịch bản.

Đồng bộ kịch bản hoạt động bằng cách đồng bộ hóa các kịch bản trong mô hình dữ liệu của bạn với các tệp văn bản trên đĩa cứng địa phương. Các thay đổi được thực hiện trên các tệp Luau trên đĩa sẽ được áp dụng cho các kịch bản trong Studio, và ngược lại. Việc đồng bộ hóa này nghĩa là bạn có thể chỉnh sửa kịch bản trong một trình soạn thảo bên ngoài như VS Code và lập tức thấy sự thay đổi trong Studio.

Khi nào sử dụng Đồng bộ kịch bản

• Nếu bạn muốn sử dụng trình soạn thảo văn bản ưa thích hoặc kiểm tra mã vào kiểm soát phiên bản, nhưng sử dụng Studio cho mọi thứ khác, Đồng bộ kịch bản là một lựa chọn tốt. Nó cũng hoạt động với các công cụ hợp tác tích hợp sẵn của Roblox, điều mà các công cụ bên thứ ba thường không có.

  Đồng bộ kịch bản hoạt động tốt với các dự án Roblox hiện có, vì nó là một tính năng bổ sung chứ không phải một sự thay đổi hoàn toàn trong cách bạn quản lý dự án.

• Nếu bạn muốn kiểm tra toàn bộ dự án của mình (không chỉ mã) vào kiểm soát phiên bản hoặc sử dụng hệ thống tệp của bạn như là nguồn thông tin chính cho dự án của bạn, các công cụ bên thứ ba như Rojo là một lựa chọn tốt hơn.

Thiết lập Đồng bộ kịch bản

1. Trong Explorer, chọn một hoặc nhiều thư mục mà bạn muốn đồng bộ.

2. Nhấp chuột phải và chọn Đồng bộ kịch bản ⟩ Đồng bộ với Thư mục.

   

3. Chọn một thư mục trên máy tính của bạn (hoặc tạo một cái mới) và nhấp vào Lưu.

4. Trong Studio, nhấp chuột phải vào thư mục một lần nữa và chọn Đồng bộ kịch bản ⟩ Hiện trong Explorer (Windows) hoặc Hiện trong Finder (macOS).

5. Mở thư mục trong trình soạn thảo văn bản ưa thích của bạn.

   Ngoài ra, nhấp chuột phải vào một kịch bản cá nhân trong Studio và chọn Mở bằng Trình soạn thảo bên ngoài.

Bạn có thể đồng bộ hóa các kịch bản cá nhân, nhưng chúng tôi rất khuyến nghị đồng bộ hóa các thư mục; nếu bạn đồng bộ hóa một thư mục, Đồng bộ kịch bản sẽ tự động đồng bộ hóa các thư mục và kịch bản con của nó, cho phép bạn tạo, xóa, và đổi tên các kịch bản mà không cần kích hoạt đồng bộ hóa mỗi lần.

Sau khi bạn thiết lập Đồng bộ kịch bản, bạn gần như chắc chắn muốn thêm một tiện ích mở rộng LSP vào trình soạn thảo văn bản của bạn.

Mẹo chính

• Đồng bộ kịch bản chỉ đồng bộ hóa các đối tượng Script, LocalScript, ModuleScript và Folder. Tất cả các đối tượng khác trong một thư mục đã đồng bộ sẽ bị bỏ qua. Tránh đồng bộ hóa các thư mục chứa kịch bản cùng với các đối tượng khác.

• Không đồng bộ hóa các kịch bản có thuộc tính hoặc thẻ. Đồng bộ kịch bản sẽ bỏ qua chúng, điều này có thể dẫn đến mất dữ liệu nếu bạn tạo hoặc xóa kịch bản hoặc bắt đầu đồng bộ hóa với một phiên bản cũ hơn của các tệp trên đĩa.

• Đồng bộ kịch bản yêu cầu tên của kịch bản tương thích với hệ thống tệp của bạn—không có tên trùng lặp hoặc ký tự không được hỗ trợ. Nếu Studio gặp bất kỳ vấn đề nào trong số này, nó sẽ ném ra một lỗi và yêu cầu bạn giải quyết tình huống trước khi tiếp tục đồng bộ hóa.

• Nếu bất kỳ tệp hoặc thư mục đã đồng bộ nào thay đổi trong khi Studio bị đóng, Studio sẽ hỏi bạn cách muốn giải quyết tình huống khi bạn mở lại nơi.

• Việc xóa một đối tượng cấp một (hoặc "gốc")—đối tượng mà bạn đã đồng bộ hóa ban đầu—trên đĩa cứng địa phương có thể gây ra lỗi cho Studio. Để xóa một đối tượng cấp một:

  1. Trong Studio, nhấp chuột phải vào kịch bản hoặc thư mục và chọn Đồng bộ kịch bản ⟩ Dừng đồng bộ.
  2. Chọn tùy chọn Xóa tệp hoặc Xóa thư mục để xóa đối tượng từ đĩa cứng địa phương của bạn.
  3. Xóa kịch bản hoặc thư mục trong Studio.

  Bạn có thể xóa các đối tượng con trong Studio hoặc trên đĩa cứng địa phương của bạn mà không cần vô hiệu hóa đồng bộ hóa, và việc xóa sẽ đồng bộ hóa như bạn mong đợi.

Thiết lập máy chủ ngôn ngữ

Máy chủ ngôn ngữ cung cấp cho trình soạn thảo văn bản của bạn các tính năng ngôn ngữ cụ thể như tự động hoàn thành, kiểm tra kiểu, "đi đến định nghĩa", và nhiều hơn nữa. Đối với VS Code, chúng tôi khuyên dùng Máy chủ ngôn ngữ Luau.

Các tiện ích mở rộng giao thức máy chủ ngôn ngữ (LSP) cần hiểu cấu trúc phân cấp mô hình dữ liệu của một dự án để hoạt động đúng. Tiện ích mở rộng VS Code đi kèm với một plugin Studio bạn đồng hành (Máy chủ ngôn ngữ Luau Companion) cung cấp dữ liệu này.

Chúng tôi rất khuyến nghị cài đặt cả hai. Nếu bạn sử dụng tiện ích mở rộng VS Code và plugin Studio bạn đồng hành, các tính năng ngôn ngữ sẽ hoạt động chính xác trong VS Code khi sử dụng Đồng bộ kịch bản.

Tiện ích mở rộng được khuyến nghị

• Roblox Luau LSP và Luau Language Server Companion - Các tính năng ngôn ngữ (xem trên)
• selene - Phân tích mã tĩnh (kiểm tra cú pháp)
• StyLua - Định dạng mã tự động

Quy tắc đồng bộ

Khi đồng bộ một đối tượng với trẻ em với một thư mục trên đĩa, Studio sẽ tự động đồng bộ hóa các thao tác tạo, đổi tên, di chuyển và xóa trên trẻ em với các tệp và thư mục tương ứng trên đĩa. Phương pháp này cho phép bạn duy trì mã của mình mà không cần phải dừng và bắt đầu đồng bộ hóa thủ công trên các kịch bản cá nhân.

Trên đĩa, Đồng bộ kịch bản sử dụng các quy tắc sau để phân biệt các loại kịch bản khác nhau với nhau.

Cài đặt

Đồng bộ kịch bản có một số cài đặt trong cửa sổ Cài đặt Studio (AltS hoặc ⌥S). Các tùy chọn mặc định là phù hợp với hầu hết các trường hợp sử dụng.