Công cụ cho nhà phát triển của Blockly là một công cụ cho nhà phát triển dựa trên nền tảng web, có thể giúp bạn tạo các khối tuỳ chỉnh và đưa những khối đó vào ứng dụng của mình.
Xác định một khối
Không gian làm việc của Block Factory sẽ bắt đầu với một khối cấu hình trống. Bạn có thể thêm dữ liệu đầu vào và trường vào khối bằng cách kéo các khối từ các danh mục tương ứng trong hộp công cụ. Bạn cũng có thể đặt văn bản chú giải công cụ, URL trợ giúp, màu sắc và(các) kiểm tra kết nối cho khối bằng cách sửa đổi khối cấu hình.
Block Factory chỉ có thể tạo một loại khối tại một thời điểm. Nếu muốn thiết kế một số khối được kết nối với nhau, bạn phải thiết kế các khối riêng biệt và kết nối chúng trong phần định nghĩa hộp công cụ. Ngoài ra, các khối có thể có các tính năng nâng cao như người biến đổi (mutator) nhưng không thể tạo các tính năng nâng cao này trong Factory. Bạn sẽ phải sửa đổi định nghĩa khối theo tài liệu sau khi tạo xong dạng cơ bản của khối.
Khi bạn sửa đổi khối cấu hình trong không gian làm việc, bản xem trước của khối sẽ tự động cập nhật. Mã bạn cần thêm vào ứng dụng cũng sẽ cập nhật tự động.
Cấu hình đầu ra
Blockly hỗ trợ nhiều phương thức xác định khối và tải chính Blockly, cũng như có nhiều ngôn ngữ trình tạo mã tích hợp sẵn. Cách bạn xác định các khối và trình tạo mã khối phụ thuộc vào các yếu tố này, vì vậy, bạn có thể đặt chúng trong Block Factory để thay đổi đầu ra mã.
Chặn định dạng nhập
Bạn có thể tải Blockly thông qua các thẻ <script> trong HTML hoặc sử dụng câu lệnh import nếu bạn dùng công cụ xây dựng với ứng dụng của mình. Lựa chọn này ảnh hưởng đến cách bạn tham chiếu đến một số phần của API Blockly. Để biết thêm thông tin về lựa chọn, hãy xem tài liệu về cách tải Blockly.
Dù bạn sử dụng phương thức nào, hãy nhớ chọn lựa chọn tương ứng trong Block Factory để mã bạn sẽ thêm vào ứng dụng là chính xác cho ứng dụng của mình.
Định dạng định nghĩa khối
Blockly hỗ trợ xác định các khối trong JSON hoặc JavaScript. Bạn nên ưu tiên định dạng JSON, nhưng nếu định thêm các tính năng nâng cao như đối tượng biến đổi, thì bạn có thể sử dụng định dạng JavaScript.
Ngôn ngữ của trình tạo mã
Blockly cung cấp nhiều ngôn ngữ của trình tạo mã. Chọn(các) ngôn ngữ mà ứng dụng của bạn cần để hiển thị mã giả lập của trình tạo mã khối tương ứng. Nếu sử dụng trình tạo ngôn ngữ tuỳ chỉnh, bạn có thể sửa đổi tên của lớp CodeGenerator tuỳ chỉnh sau khi sao chép mã vào ứng dụng.
Kết quả chạy mã
Các phần tiếp theo của Block Factory sẽ hiển thị cho bạn mã bạn cần sao chép vào ứng dụng để tải khối bạn đã tạo. Nơi bạn sao chép mã sẽ tuỳ thuộc vào cách bạn cấu trúc ứng dụng, nhưng nhìn chung, bạn sẽ cần chạy tiêu đề mã trước phần định nghĩa và trình tạo mã khối, định nghĩa khối trước khi sử dụng trong hộp công cụ và trình tạo mã khối trước khi tạo mã cho không gian làm việc. Đối với mỗi phần, bạn có thể sử dụng nút sao chép để sao chép toàn bộ khối mã cho phần đó.
Nếu vẫn chưa chắc chắn về cách sử dụng kết quả đầu ra mã, bạn có thể quan tâm đến ứng dụng mẫu có ví dụ về các khối tuỳ chỉnh và trình tạo mã khối.
Tiêu đề mã
Phần tiêu đề mã cho thấy mã bạn cần để tải thư viện Blockly chính và trình tạo ngôn ngữ mà bạn đã chọn. Cũng có thể có cấu hình khác ở đây; ví dụ: một số trường bạn có thể đưa vào trong một khối là từ các trình bổ trợ Blockly. Các trình bổ trợ này sẽ có các câu lệnh nhập riêng và có thể bạn sẽ phải chạy những đoạn mã khác để khởi tạo trường này. Bạn phải đưa mã này vào trước bất kỳ phần mã nào sau đây.
Định nghĩa khối
Định nghĩa khối là cách bạn cho Blockly biết hình dạng của khối, chẳng hạn như khối đó có trường và dữ liệu đầu vào nào, màu sắc, v.v. Sau khi chạy mã này, Blockly sẽ biết cách tạo một khối dựa trên type của nó.
Nếu đang sử dụng ứng dụng mẫu, bạn có thể đưa mã này vào một tệp trong thư mục blocks/. Nếu bạn có cấu trúc ứng dụng của riêng mình, hãy nhớ bao gồm mã này trước khi bạn cố gắng tham chiếu một khối theo tên, chẳng hạn như trong định nghĩa hộp công cụ. Dù bằng cách nào, hãy đảm bảo các tiêu đề mã hiện diện trong tệp mà bạn thêm mã này.
Sơ đồ máy phát
Trình tạo mã khối là cách bạn mô tả mã sẽ được tạo cho một khối. Mã trình tạo mã giả lập do Block Factory tạo sẽ cung cấp cho bạn mã cơ bản để nhận giá trị của các dữ liệu đầu vào và trường có trong khối của bạn. Bạn có thể tuỳ ý kết hợp các giá trị này vào mã cuối cùng được tạo!
Nếu đang sử dụng ứng dụng mẫu, bạn có thể đưa mã này vào một tệp trong thư mục generators/. Nếu bạn có cấu trúc ứng dụng của riêng mình, hãy nhớ bao gồm mã này trước khi bạn cố gắng tạo mã cho không gian làm việc chứa các khối tuỳ chỉnh. Dù bằng cách nào, hãy đảm bảo các tiêu đề mã có trong tệp mà bạn đưa mã này vào.
Video hướng dẫn từng bước
Video này sẽ hướng dẫn chi tiết các bước xác định khối. Giao diện người dùng đã lỗi thời, nhưng các tính năng khối mà giao diện này làm nổi bật vẫn chính xác ít nhiều.
Chặn thư viện
Chặn sẽ tự động được lưu vào bộ nhớ cục bộ của trình duyệt bất cứ khi nào bạn thay đổi khối. Bạn có thể tạo một khối mới hoặc tải một khối hiện có từ bộ nhớ cục bộ bằng cách nhấp vào các nút tương ứng trong thanh công cụ trên cùng.
Nhập từ Block Factory cũ
Nếu đã sử dụng Block Factory cũ và muốn di chuyển các định nghĩa về khối hiện tại sang công cụ mới, thì bạn có thể làm theo các bước sau:
Trong Block Factory cũ, hãy nhấp vào nút
Export Block Librarytrên thanh công cụ. Thao tác này sẽ tải tệp có tất cả định nghĩa khối của bạn xuống.
Trong Block Factory mới, nhấp vào nút
Load blocktrên thanh công cụ.Chọn tuỳ chọn "Import from Block Factory" trong trình đơn.
Tải tệp mà bạn đã tải xuống ở Bước 1.
Các định nghĩa khối sẽ được tự động chuyển đổi sang định dạng mới và từ nay sẽ có trong trình đơn
Load block. Các khối có thể đã được đổi tên nếu có xung đột với các khối hiện có.Nếu có lỗi khi phân tích cú pháp bất kỳ quy tắc chặn nào của bạn, chúng tôi sẽ không thể tải các lần chặn đó. Bạn có thể giúp chúng tôi bằng cách báo lỗi với các mẫu bị chặn và bao gồm tệp không phân tích cú pháp được.