Khi hack vào phần lõi của Blockly hoặc phát triển trình bổ trợ, sân chơi là một công cụ cực kỳ hữu ích. Ứng dụng này có một thực thể Blockly được định cấu hình sẵn mà bạn có thể sử dụng để kiểm thử, gỡ lỗi hoặc tạo bản minh hoạ. Tại Google, hầu như tất cả sự phát triển của Blockly đều diễn ra bằng cách sử dụng Playground. Dưới đây là môi trường thử nghiệm đơn giản trên máy chủ minh hoạ.
Có 3 loại sân chơi cho Blockly cốt lõi: đơn giản, nâng cao và nhiều. Trong các mẫu blockly, thường chỉ sử dụng sân chơi nâng cao.
Điều kiện tiên quyết
Blockly hiện sử dụng hệ thống mô-đun Closure. Do cách tải, các mô-đun Closure chưa biên dịch phải được tìm nạp từ URL http: hoặc https: và không thể được tìm nạp trực tiếp từ URL file:. Do đó, để tải sân chơi ở chế độ chưa biên dịch, bạn phải tải sân chơi đó từ máy chủ web cục bộ.
Chúng ta đã tạo một tập lệnh khởi động máy chủ cục bộ và tải tất cả mã cần thiết để tải các mô-đun Blockly. Bạn cần cài đặt npm trên máy và chạy npm install từ thư mục gốc của Blockly để cài đặt tất cả các phần phụ thuộc.
Sử dụng Internet Explorer
Blockly hiện sử dụng các tính năng nâng cao trong cơ sở mã có thể không tương thích với Internet Explorer. Trong mã nén (đã biên dịch), các tính năng này được chuyển đổi để hoạt động với IE, nhưng việc tải mã không nén có thể không hoạt động. Nếu bạn tải sân chơi trong IE, ngay cả thông qua máy chủ http cục bộ, thì sân chơi sẽ tự động tải mã Blockly đã nén để đảm bảo khả năng tương thích. Hãy xem phần "Truy cập trực tiếp vào sân chơi" để biết thêm thông tin chi tiết về việc kiểm thử các thay đổi trong sân chơi ở chế độ nén.
Sân chơi đơn giản
Sân chơi đơn giản là nền tảng cho hai sân chơi khác. Cửa sổ này hiển thị một hộp công cụ và không gian làm việc, đồng thời cho phép bạn điều chỉnh một số chế độ cài đặt có giới hạn.
Để mở Kotlin Playground, hãy chạy
npm run start
từ thư mục gốc của Blockly. Đảm bảo không có ứng dụng nào khác đang nghe trên cổng 8080. Lệnh này sẽ khởi động một máy chủ lưu trữ các mô-đun Blockly và tự động mở trình duyệt của bạn đến trang sân chơi. Khi bạn đã sẵn sàng đóng sân chơi, hãy kết thúc quá trình (ctrl-c trong môi trường Mac và Linux).
Sân chơi có:
- Tất cả mã đều không nén để phát triển nhanh.
- Tất cả các quy tắc chặn mặc định (ngoại trừ một số quy tắc chặn không dùng nữa).
- Tất cả trình tạo ngôn ngữ (JavaScript, Python, PHP, Lua và Dart).
- Tuần tự hoá và giải tuần tự trạng thái không gian làm việc (JSON hoặc XML).
- Chuyển đổi giữa bố cục LTR và RTL.
- Chuyển đổi giữa các bố cục hộp công cụ.
- Kiểm thử tải cho trình kết xuất.
- Ghi lại tất cả sự kiện trong bảng điều khiển.
Sân chơi nâng cao
Sân chơi nâng cao chứa các tính năng bổ sung giúp gỡ lỗi Blockly dễ dàng hơn nữa. Đây cũng là sân chơi mặc định được sử dụng trong các mẫu blockly cho tất cả các trình bổ trợ.
Kotlin Playground này có tất cả các tính năng đơn giản của Kotlin Playground, cộng với:
- Bạn có thể định cấu hình các chế độ cài đặt bổ sung, chẳng hạn như kích thước lưới, chế độ điều khiển thu phóng/di chuyển, trình kết xuất, giao diện và nhiều chế độ khác.
- Các chế độ cài đặt và chặn được dùng sẽ được lưu vào bộ nhớ đệm và tự động sử dụng vào lần tải sân chơi tiếp theo.
- Xem kết quả của từng trình tạo trong cùng một cửa sổ.
Để bắt đầu sân chơi nâng cao cho bất kỳ trình bổ trợ nào trong blockly-samples, hãy chạy npm run
start từ thư mục gốc của trình bổ trợ. Hiện tại, chỉ có một trình bổ trợ có thể chạy cùng một lúc và trình bổ trợ này sử dụng cổng 3000. Nếu bạn gặp sự cố khi khởi động trình bổ trợ, trước tiên, hãy đảm bảo không có ứng dụng nào khác đang nghe trên cổng đó.
Để bắt đầu sân chơi nâng cao trong lõi, hãy chạy npm run start từ thư mục gốc của Blockly, sau đó nhấp vào đường liên kết "Nâng cao" bên dưới tiêu đề.
Bạn cũng có thể tạo trang thử nghiệm của riêng mình bao gồm sân chơi nâng cao bằng cách sử dụng gói công cụ cho nhà phát triển của Blockly.
Nhiều sân chơi
Khu vui chơi nhiều chứa một số khu vui chơi ở các cấu hình khác nhau
cho chế độ LTR và vị trí của hộp công cụ. Công cụ này chủ yếu dùng để kiểm tra nhanh rằng Blockly không bị lỗi gì liên quan đến LTR trước khi phát hành. Để mở Playground này, hãy làm theo các bước cho sân chơi đơn giản, sau đó thay đổi URL thành /tests/multi_playground.html.
Kiểm thử các thay đổi
Khi chạy bất kỳ sân chơi nào từ một máy chủ cục bộ, bạn chỉ cần làm mới trang để xem các thay đổi của mình trong Blockly trong hầu hết các trường hợp. Nếu đã thêm một tệp mới hoặc thêm một phần phụ thuộc mới vào một tệp, trước tiên, bạn có thể cần chạy npm run
build để cập nhật tệp test/deps.js nhằm đảm bảo các phần phụ thuộc được tải chính xác, sau đó làm mới trang.
Nếu đang chạy sân chơi nâng cao của một trình bổ trợ, bạn thậm chí không cần làm mới trang. Các thay đổi được tải nóng tự động!
Trực tiếp sử dụng sân chơi
Trước đây, bạn có thể truy cập vào sân chơi đơn giản trên máy bằng cách chuyển trực tiếp đến tệp test/playground.html trong trình duyệt. Bạn vẫn có thể làm việc này với sân chơi đơn giản và nhiều sân chơi, nhưng không nên làm như vậy nữa. Nếu bạn làm như vậy, sân chơi sẽ phát hiện rằng bạn không chạy máy chủ cục bộ và sẽ tự động sử dụng các tệp Blockly đã nén (xem trang Tạo Blockly để biết thêm thông tin) và bất cứ khi nào bạn thay đổi nội dung nào đó trong Blockly cốt lõi, bạn sẽ phải tạo lại cốt lõi và phân chia các thay đổi. Bạn vẫn có thể truy cập vào các trang này nếu chúng được lưu trữ trên một máy chủ từ xa, chẳng hạn như ví dụ của chúng tôi được lưu trữ trên trang web minh hoạ. Nền sẽ có màu xanh dương sáng bất cứ khi nào bạn ở chế độ nén.
Bạn không thể sử dụng sân chơi nâng cao thông qua quyền truy cập file:.