Gỡ lỗi

Studio cung cấp nhiều công cụ gỡ lỗi và quy trình làm việc thường thấy trong các Môi trường Phát triển Tích hợp (IDE). Những công cụ này giúp bạn kiểm tra và giải quyết lỗi trong các kịch bản khi chúng chạy.

Gỡ lỗi với điểm dừng

Điểm dừng là các điểm kiểm tra tạm dừng hoặc "ngắt" việc thực thi kịch bản của bạn ở các dòng cụ thể. Bạn có thể sử dụng các điểm dừng để kiểm tra và gỡ lỗi trải nghiệm của mình, theo dõi biến và kiểm tra ngăn gọi. Điểm dừng là một trong những phương pháp hiệu quả nhất để gỡ lỗi các hàm, vì vậy chúng là một trong những công cụ gỡ lỗi quan trọng nhất.

Quản lý

Trong Trình chỉnh sửa kịch bản, bạn có thể chèn nhiều loại điểm dừng khác nhau và chỉnh sửa cấu hình của một điểm dừng bất kỳ lúc nào, bao gồm cả trong các phiên thử nghiệm. Nếu bạn chỉnh sửa điểm dừng trong một phiên thử nghiệm, các chỉnh sửa sẽ vẫn tồn tại ngay cả sau khi bạn hoàn thành nó. Bạn cũng có thể chỉnh sửa một điểm dừng đang tạm dừng phiên thử nghiệm của bạn, nhưng các thay đổi sẽ không được áp dụng cho đến phiên thử nghiệm tiếp theo.

Chèn

Các điểm dừng có nhiều biến thể và có thể được chèn vào bất kỳ dòng mã thực thi nào như sau:

Để chèn một điểm dừng tiêu chuẩn vào một dòng mã, hãy nhấp vào khoảng trống ngay bên phải số dòng của nó. Ngoài ra, bạn có thể nhấp chuột phải vào khoảng trống và chọn Chèn Điểm dừng. Biểu tượng điểm dừng xuất hiện dưới dạng một vòng tròn đỏ.

Vô hiệu hóa

Để tạm thời vô hiệu hóa một điểm dừng mà không xóa nó, hãy sử dụng bất kỳ quy trình nào sau đây:

• Nhấp vào biểu tượng điểm dừng.
• Nhấp chuột phải vào biểu tượng điểm dừng và chọn Vô hiệu hóa Điểm dừng.
• Chỉnh sửa điểm dừng và bỏ chọn ô Bật.

Một điểm dừng đã bị vô hiệu hóa sẽ xuất hiện dưới dạng một phiên bản rỗng của biểu tượng đã được bật, ví dụ như một vòng tròn rỗng cho một điểm dừng tiêu chuẩn đã bị vô hiệu hóa, hoặc một viên kim cương rỗng cho một logpoint đã bị vô hiệu hóa.

Xóa

Để xóa một điểm dừng, nhấp giữa vào biểu tượng của nó hoặc nhấp chuột phải vào biểu tượng của nó và chọn Xóa Điểm dừng.

Chỉnh sửa

Bạn có thể chỉnh sửa cấu hình của một điểm dừng bất kỳ lúc nào, bao gồm cả trong các phiên thử nghiệm. Nếu bạn chỉnh sửa điểm dừng trong một phiên thử nghiệm, các chỉnh sửa sẽ vẫn tồn tại ngay cả sau khi bạn hoàn thành nó. Bạn cũng có thể chỉnh sửa một điểm dừng đang tạm dừng phiên thử nghiệm của bạn, nhưng các thay đổi sẽ không được áp dụng cho đến phiên thử nghiệm tiếp theo.

Để chỉnh sửa một điểm dừng:

1. Nhấp chuột phải vào biểu tượng điểm dừng và chọn Chỉnh sửa Điểm dừng.

2. Trong cửa sổ Chỉnh sửa Điểm dừng, cấu hình điểm dừng theo mong muốn. Bạn có thể kết hợp các cấu hình này với nhau để phục vụ tốt nhất cho nhu cầu gỡ lỗi của mình.

   Tùy chọn	Mô tả
   Điều kiện	Một biểu thức tùy chọn xác định liệu điểm dừng có kích hoạt hay không. Nếu điều kiện trống, điểm dừng luôn kích hoạt. Nếu điều kiện tồn tại, điểm dừng trở thành một điểm dừng điều kiện và chỉ kích hoạt nếu điều kiện là đúng. Ví dụ, nếu bạn muốn điểm dừng chỉ kích hoạt khi biến var bằng 10, đặt điều kiện là var == 10.
   Thông điệp Log	Một biểu thức in ra cửa sổ Đầu ra khi điểm dừng bị kích hoạt. Định dạng thông điệp log giống như của câu lệnh print(). Ví dụ, đặt thông điệp log thành "Giá trị của var:", var để xuất ra cùng thông điệp như print("Giá trị của var:", var).
   Tiếp tục Thực thi	Quyết định liệu điểm dừng có tạm dừng kịch bản hay không nếu nó kích hoạt. Tùy chọn này bị vô hiệu hóa theo mặc định trừ khi điểm dừng được chèn là một logpoint.
   Xóa Điểm dừng khi Bị Kích hoạt	Nếu được kiểm tra, điểm dừng tự động xóa chính nó sau phiên thử nghiệm đầu tiên, qua đó khiến nó trở thành một điểm dừng tạm thời.
   Kích hoạt Tại	ngữ cảnh của một điểm dừng xác định xem nó có nên kích hoạt trên Khách hàng (kịch bản phía khách hàng), Máy chủ (kịch bản phía máy chủ) hoặc Chỉnh sửa (gỡ lỗi các kịch bản plugin). Nếu bạn chọn Ngữ cảnh Tùy chỉnh, cửa sổ sẽ cho biết các ngữ cảnh kích hoạt hiện tại.

Quy trình

Quy trình điển hình cho việc gỡ lỗi với điểm dừng như sau:

1. Mở kịch bản mà bạn muốn gỡ lỗi và chèn điểm dừng vào các dòng mã mà bạn muốn kiểm tra.

2. Từ tầng mezzanine của Studio, khởi động một phiên thử nghiệm để bắt đầu gỡ lỗi.

   

3. Khi kịch bản chạm vào một điểm dừng, phiên thử nghiệm tạm dừng trừ khi điểm dừng đó được cấu hình để tiếp tục thực thi. Một mũi tên màu vàng trên điểm dừng cho biết dòng mã nào sẽ được thực thi tiếp theo.

   

4. Khi kịch bản tạm dừng, hãy kiểm tra cửa sổ Điểm dừng, cửa sổ Theo dõi, cửa sổ Ngăn gọi, cửa sổ Đầu ra và Trình chỉnh sửa kịch bản để tìm thông tin về giá trị biến và các lần thực thi hàm.

5. Để tiếp tục thực thi mã sau khi chạm vào điểm dừng, hãy nhấp vào Tiếp tục Kịch bản trên tầng mezzanine.

   

   Bạn cũng có thể thực thi mã từng dòng một bằng các nút bước trong tầng mezzanine:

   

   Hành động	Tổ hợp phím	Mô tả
   Bước vào	F11	Nút Bước vào di chuyển trình gỡ lỗi vào mã của hàm trên dòng hiện tại. Nếu không có hàm nào trên dòng hiện tại, trình gỡ lỗi di chuyển đến dòng tiếp theo.
   Bước qua	F10	Nút Bước qua di chuyển trình gỡ lỗi đến dòng mã tiếp theo, không vào các hàm.
   Bước ra	ShiftF11	Nút Bước ra di chuyển trình gỡ lỗi ra khỏi hàm hiện tại và đến dòng mã tiếp theo sau cuộc gọi hàm. Nếu dòng hiện tại không nằm trong một hàm, trình gỡ lỗi di chuyển đến dòng tiếp theo.

6. Khi bạn hoàn thành gỡ lỗi phiên hiện tại, hãy nhấp vào nút Dừng.

   

Giám sát

Studio bao gồm nhiều cửa sổ và công cụ để giám sát giá trị biến và các lần thực thi hàm trong quá trình gỡ lỗi. Với thông tin này, bạn có thể tìm ra nguyên nhân gốc rễ của hầu hết các vấn đề trong các kịch bản của mình.

Điểm dừng

Cửa sổ Điểm dừng là một cái nhìn hợp nhất cho thấy tất cả các điểm dừng trong tất cả các kịch bản. Để mở nó, hãy nhấp vào Điểm dừng từ thanh công cụ Kịch bản của Studio, hoặc điều hướng đến menu Cửa sổ ⟩ Gỡ lỗi và bật Điểm dừng.

Trong cửa sổ, các cột Kịch bản và Dòng sẽ luôn hiển thị, và bạn có thể bật/tắt các cột cấu hình khác thông qua menu ⋮ ở góc trên bên phải. Trong cột Kịch bản, nhấp chuột phải vào bất kỳ điểm dừng nào để hiện menu tùy chọn để chỉnh sửa, vô hiệu hóa/bật, xóa, hoặc nhảy đến dòng của điểm dừng trong kịch bản.

Khi ở trong một phiên gỡ lỗi, cột xa bên trái cho thấy (x3) điều này cho thấy nhiều ngữ cảnh (Khách hàng, Máy chủ, Chỉnh sửa) cho điểm dừng. Bằng cách mở rộng nhánh của bất kỳ điểm dừng nào, bạn có thể nhấp vào biểu tượng bên cạnh một ngữ cảnh cụ thể để vô hiệu hóa/bật nó cho ngữ cảnh đó, chẳng hạn như chỉ vô hiệu hóa một điểm dừng trong ngữ cảnh Khách hàng trong khi giữ nó bật trong ngữ cảnh Máy chủ.

Ngăn gọi

Cửa sổ Ngăn gọi, có thể truy cập từ thanh công cụ Kịch bản của Studio hoặc menu Cửa sổ ⟩ Gỡ lỗi, cho biết dòng mã nào sẽ được thực thi tiếp theo khi trình gỡ lỗi chạm vào một điểm dừng. Nếu bạn gọi các hàm từ bên trong các hàm khác, nó cho biết các dòng mà các hàm đó đã được gọi ra, cho phép bạn xác nhận xem luồng gọi thực tế có phù hợp với luồng mong đợi hay không.

Khi kịch bản tạm dừng tại các điểm dừng, hãy sử dụng các nút bước trong tầng mezzanine để bước vào, vượt qua, hoặc ra khỏi một hàm/dòng như được nêu trong quy trình.

Theo dõi

Cửa sổ Theo dõi, có thể truy cập từ thanh công cụ Kịch bản của Studio hoặc menu Cửa sổ ⟩ Gỡ lỗi, cho phép bạn theo dõi giá trị biến và biểu thức khi bạn bước qua các điểm dừng.

Tab Biến cho thấy thông tin về các biến hiện tại trong phạm vi, có thể lọc bằng cách nhấp vào nút Tất cả Phạm vi trong thanh trên của cửa sổ. Mở rộng một nhánh cho thấy các thành viên của biến hoặc thể hiện đó và giá trị của chúng. Bạn cũng có thể theo dõi bất kỳ biến nào bằng cách nhấn đúp để làm nổi bật nó trong Trình chỉnh sửa Kịch bản, nhấp chuột phải và chọn Thêm Theo dõi từ menu popup.

Trình chỉnh sửa kịch bản

Trình gỡ lỗi được tích hợp với Trình chỉnh sửa kịch bản. Khi trải nghiệm của bạn tạm dừng ở một điểm dừng trong một kịch bản, bạn có thể di chuột qua tên một biến để xem giá trị của nó. Ví dụ, bạn có thể xem thành phần của một bảng và các khóa/giá trị chứa trong nó.

Các công cụ gỡ lỗi bổ sung

Ngoài trình gỡ lỗi, Studio còn cung cấp các công cụ gỡ lỗi bổ sung để bạn khắc phục các vấn đề và lỗi trong trải nghiệm của mình.

Thanh lệnh

Thanh lệnh cho phép bạn chạy các lệnh Luau trong khi trải nghiệm đang chạy. Nó có sẵn trong Studio từ menu Cửa sổ ⟩ Kịch bản và trong Bảng điều khiển Phát triển.

Bảng điều khiển Phát triển

Bảng điều khiển Phát triển cung cấp nhiều chi tiết bao gồm đầu ra của máy khách và máy chủ, mức sử dụng bộ nhớ, hiệu suất mạng, và nhiều hơn nữa. Để mở bảng điều khiển trong khi thử nghiệm hoặc chơi một trải nghiệm, hãy gõ /console vào trò chuyện hoặc nhấn F9.

Tệp log

Khi một kịch bản in ra hoặc lỗi trong Studio hoặc ứng dụng người chơi, ứng dụng ghi lại thông điệp vào một tệp log trong hệ thống tệp cục bộ. Những tệp này nằm ở những nơi khác nhau tùy thuộc vào hệ điều hành.

Windows

Để truy cập các tệp log trên Windows:

1. Mở File Explorer.
2. Điều hướng đến thư mục %LOCALAPPDATA%\Roblox\logs.
3. Nhấp đúp vào một tệp log để mở nó. Các log có cùng giá trị XXXXX là từ cùng một phiên Studio.

Mac

Để truy cập các tệp log trên Mac:

1. Mở Finder.
2. Trong thanh menu, chọn Đi tới ⟩ Đi đến Thư mục....
3. Trong hộp thoại, nhập ~/Library/Logs/Roblox.
4. Nhấp đúp vào kết quả để điều hướng đến thư mục log của Roblox.
5. Bên trong thư mục, nhấp đúp vào một tệp log để mở nó.

iOS

Bạn có thể thu thập các log iOS bằng cách sử dụng Mac hoặc bằng cách sử dụng một thiết bị iOS.

Để truy cập các tệp log iOS trên Mac:

1. Kết nối thiết bị iOS với một Mac.
2. Mở Finder.
3. Điều hướng đến Utilities và mở ứng dụng Console.
4. Để làm mới các log thời gian thực trong ứng dụng Console, hãy chọn thiết bị iOS từ thanh bên, nhấp vào nút Bắt đầu, và tái tạo vấn đề trên thiết bị iOS.
5. Để thu thập các log đã lưu trữ trong ứng dụng Console, hãy chạy sudo log collect --device-name "[Tên Thiết bị iOS]" trong Terminal. Đảm bảo rằng không có dấu nháy trong tên thiết bị hoặc bạn có thể gặp lỗi khi chạy lệnh.

Android

Để truy cập các tệp log trên Android:

1. Điều hướng đến Cài đặt ⟩ Hệ thống ⟩ Tùy chọn nhà phát triển.
2. Bật Tùy chọn nhà phát triển.
3. Trên máy tính, tải xuống và cài đặt Android Studio.
4. Trong Android Studio, nhấp vào Logcat.
5. Kết nối thiết bị Android với máy tính để tự động làm mới Logcat với các log.