Chuyển tới nội dung chính

Trình soạn thảo văn bản

Trình soạn thảo văn bản dùng để chỉnh sửa dự án script trên thiết bị và các tệp văn bản thông thường. Sau khi mở dự án phát triển, trình soạn thảo còn có thể kết nối với thiết bị kiểm thử để trực tiếp chạy, dừng và gỡ lỗi script, đồng thời tạo sản phẩm mã hóa hoặc gói dành cho máy chủ điều khiển tập trung.

Mở trình soạn thảo văn bản​

Các cách mở thường dùng:

  • Nhấp đúp vào tệp văn bản trong trình quản lý tệp, hoặc nhấp chuột phải vào tệp rồi chọn chỉnh sửa văn bản.
  • Nhấp chuột phải vào thiết bị trong danh sách thiết bị, chọn duyệt tệp trên thiết bị rồi mở tệp văn bản trên thiết bị.
  • Nhấp chuột phải vào thư mục dự án trong Thư mục phát triển, chọn Mở dự án, sau đó nhấp vào tệp trong cây dự án.
  • Nhấp chuột phải vào thiết bị trong danh sách thiết bị và tạo tệp Lua tạm thời để nhanh chóng kiểm thử một đoạn script ngắn.

Thao tác chỉnh sửa thường dùng​

  • Nhấp vào Lưu để ghi các thay đổi hiện tại trở lại tệp.
  • Nhấp vào Đọc lại để tải lại nội dung tệp từ vị trí ban đầu.
  • Nhấp chuột phải vào thẻ để xem tệp trong trình quản lý tệp, đổi tên hoặc sao chép đường dẫn.
  • Thanh trạng thái phía dưới hiển thị hàng và cột, thụt lề, mã hóa, ký tự kết thúc dòng và loại tệp; nếu không chắc chắn, hãy giữ mặc định.
  • Nhấp vào nút bản đồ thu nhỏ để hiển thị hoặc ẩn bản đồ mã ở bên phải.

Nếu tệp bị thao tác khác sửa đổi sau khi mở, hệ thống sẽ yêu cầu xác nhận ghi đè khi lưu. Khi đọc lại hoặc đóng một thẻ chưa lưu, hệ thống cũng sẽ cảnh báo rằng thay đổi hiện tại có thể bị mất.

Thiết lập thiết bị kiểm thử phát triển​

Trước khi chạy và gỡ lỗi trực tuyến, phải thiết lập thiết bị kiểm thử phát triển. Thiết bị phải được nhập, đang trực tuyến và XXTouch có thể truy cập bình thường; thiết bị ngoại tuyến không thể duyệt tệp, chạy hoặc gỡ lỗi.

Các cách thiết lập thường dùng:

  1. Nhấp chuột phải vào thiết bị đích trong danh sách thiết bị và chọn Đặt làm thiết bị kiểm thử phát triển.
  2. Nhấp vào nút thiết bị ở góc trên bên trái của trình soạn thảo văn bản, mở Chọn thiết bị kiểm thử rồi chọn thiết bị đích.

Sau khi thiết lập, trình soạn thảo văn bản sẽ hiển thị thiết bị kiểm thử hiện tại và cung cấp các thao tác như Duyệt tệp trên thiết bị, Mở bàn làm việc mẫu, Chạy, Dừng và Gỡ lỗi.

Khi cần đổi thiết bị, chỉ cần chọn lại thiết bị khác; khi không còn cần kết nối trực tuyến, có thể nhấp vào Ngắt kết nối kiểm thử tại cùng vị trí.

Chạy trực tuyến​

Sau khi mở dự án phát triển hoặc tệp trong dự án, nhấp vào Chạy. Trình soạn thảo văn bản sẽ lưu các nội dung cần lưu trước, sau đó gửi dự án hiện tại đến thiết bị kiểm thử và khởi động. Trong khi chạy, có thể xem đầu ra ở vùng nhật ký phía dưới.

Nội dung có thể chạy thường là tệp script trong dự án phát triển hoặc tệp .lua có thể chạy trực tiếp. Đối với tệp văn bản thông thường, dự án không được nhận diện hoặc dự án không có điểm vào, hệ thống sẽ báo Tệp hiện tại không thể chạy.

Các trạng thái thường gặp:

  • Đang chạy: script đã khởi động hoặc đang chờ thiết bị thực thi.
  • Đang dừng: đang gửi yêu cầu dừng đến thiết bị.
  • Chưa có nhật ký: kết nối nhật ký hoạt động bình thường nhưng thiết bị tạm thời chưa có đầu ra.
  • Vui lòng chọn thiết bị phát triển: chưa thiết lập thiết bị kiểm thử.
  • Tệp hiện tại không thể chạy: thẻ hiện tại không thuộc dự án có thể chạy hoặc không có điểm vào có thể nhận diện.
  • Lưu thất bại, đã dừng chạy: không thể lưu tệp hiện tại nên quá trình chạy sẽ không tiếp tục.

Khi cần kết thúc script, nhấp vào Dừng.

Gỡ lỗi trực tuyến​

Nhấp vào Gỡ lỗi để khởi động dự án ở chế độ gỡ lỗi. Chế độ này phù hợp để xác định vấn đề về biến, ngăn xếp lời gọi và nhánh trong quá trình chạy.

Các thao tác thường dùng:

  • Đặt hoặc xóa điểm ngắt trong vùng số dòng bên trái trình soạn thảo.
  • Dùng Tiếp tục, Bước qua, Bước vào và Bước ra để điều khiển việc thực thi script.
  • Xem script đang dừng ở tầng hàm nào trong ngăn xếp lời gọi; sau khi nhấp vào một mục, trình soạn thảo sẽ chuyển đến vị trí tương ứng.
  • Xem các biến khả dụng tại vị trí tạm dừng trong bảng biến; nhấp chuột phải để sao chép hoặc sửa giá trị biến.
  • Nhập một dòng Lua trong bảng điều khiển gỡ lỗi; khi script đang tạm dừng, có thể thực thi biểu thức.
  • Nhấp vào Ngắt kết nối gỡ lỗi để kết thúc kết nối gỡ lỗi hiện tại.

Bảng gỡ lỗi sẽ hiển thị các trạng thái như Chưa gỡ lỗi, Đang chạy, Đã tạm dừng và Gỡ lỗi đã kết thúc. Chỉ dự án và thiết bị hỗ trợ gỡ lỗi mới có thể bắt đầu gỡ lỗi; nếu hệ thống báo dự án hiện tại không thể gỡ lỗi, trước tiên có thể chạy theo cách thông thường để xác nhận điểm vào của dự án là chính xác.

Cấu hình dự án​

Sau khi mở dự án, thanh tiêu đề của trình soạn thảo văn bản sẽ có mục Cấu hình dự án. Tại đây có thể quản lý tên dự án, ID dự án, phiên bản, mô tả, đường dẫn bỏ qua, thư viện dùng chung và cấu hình bàn làm việc mẫu.

Sau khi sửa cấu hình dự án, nhấp vào Lưu. Nếu chỉ chỉnh sửa nội dung script, không cần mở cấu hình dự án mỗi lần; chỉ mở khi cần điều chỉnh tên dự án, thông tin phát hành, đường dẫn tài nguyên hoặc cấu hình chọn màu.

Sản phẩm đầu ra của dự án​

Các thao tác dự án trong trình soạn thảo văn bản còn cung cấp khả năng tạo sản phẩm đầu ra:

  • Mã hóa: tạo sản phẩm mã hóa phù hợp để phân phối hoặc triển khai. Sau khi hoàn tất, hệ thống sẽ hiển thị vị trí lưu; cũng có thể xem hoặc tải xuống trong cây dự án hay trình quản lý tệp.
  • Gói điều khiển tập trung: đóng gói dự án thành gói script có thể cài đặt và quản lý trong thư mục script của máy chủ điều khiển tập trung. Thao tác này chỉ áp dụng cho loại dự án có hỗ trợ đóng gói.

Trước khi tạo sản phẩm đầu ra, nên lưu tất cả tệp dự án đang mở và chạy thử một lần bằng thiết bị kiểm thử phát triển.

Nếu nút không khả dụng, nguyên nhân thường là thẻ hiện tại không thuộc dự án, loại dự án không hỗ trợ thao tác đó hoặc dự án chưa được lưu ở trạng thái có thể thao tác.

Hoàn thành bằng AI​

Hoàn thành bằng AI là một chức năng bổ sung của trình soạn thảo văn bản. Sau khi bật, trình soạn thảo có thể hiển thị gợi ý hoàn thành dạng văn bản mờ do AI tạo trong lúc nhập.

Để sử dụng, trước tiên hãy hoàn tất cấu hình trong cài đặt chung:

  1. Mở Cấu hình hệ thống → Nhà cung cấp AI.
  2. Nhấp vào Thêm cấu hình, nhập tên cấu hình, dịch vụ AI, mô hình và API Key. Khi dùng dịch vụ tương thích không yêu cầu xác thực, có thể để trống API Key.
  3. Khi cần xác nhận tên mô hình, có thể nhấp vào Lấy mô hình hoặc nhập thủ công tên mô hình.
  4. Mở Cấu hình hệ thống → Trình soạn thảo văn bản.
  5. Trong Cấu hình AI, chọn cấu hình vừa tạo.
  6. Bật Hoàn thành bằng AI, sau đó nhấp vào Lưu cài đặt.

Sau khi bật, khi nhập trong tệp văn bản phù hợp, trình soạn thảo sẽ tự động hiển thị gợi ý hoàn thành màu xám. Các thao tác thường dùng:

  • Nhấn Tab để chấp nhận gợi ý hiện tại.
  • Nhấn Esc để bỏ qua gợi ý hiện tại.
  • Nhấn Alt + Backslash để kích hoạt hoàn thành thủ công.
  • Nếu có nhiều ứng viên, nhấn Alt + [ / Alt + ] để chuyển giữa các ứng viên.

Có thể tiếp tục điều chỉnh các tùy chọn sau trong Cấu hình hệ thống → Trình soạn thảo văn bản:

  • Tùy chọn hoàn thành: nhập phong cách mã hoặc quy ước dự án mà bạn muốn AI tuân theo.
  • Phần mở rộng tệp áp dụng: giới hạn những tệp sẽ kích hoạt hoàn thành bằng AI; cũng có thể thêm phần mở rộng tùy chỉnh.
  • Ngữ cảnh hoàn thành: ngoài tệp hiện tại, có thể thêm Tài liệu XXTouch hoặc Tệp dự án để gợi ý phù hợp hơn với dự án script.

Nếu gợi ý không xuất hiện, trước tiên hãy kiểm tra đã thêm cấu hình nhà cung cấp AI hay chưa, đã bật Hoàn thành bằng AI hay chưa, phần mở rộng của tệp hiện tại có nằm trong phạm vi áp dụng hay không, và mô hình / API Key có sử dụng được hay không. Sau khi mở dự án, nếu tệp dự án vừa thay đổi đáng kể, có thể nhấp vào Làm mới ngữ cảnh hoàn thành bằng AI để hệ thống đọc lại nội dung dự án hiện tại.