Trình bổ trợ

Giới thiệu

Trình bổ trợ là một đoạn mã độc lập có chức năng bổ sung chức năng cho Blockly. Trình bổ trợ có thể thêm trường, xác định giao diện, tạo trình kết xuất và làm nhiều việc khác.

Người dùng mục tiêu của trình bổ trợ là một nhà phát triển tìm và sử dụng trình bổ trợ thông qua npm. Để biết thêm thông tin về cách tạo trình bổ trợ, bạn cũng có thể xem buổi trò chuyện về Cách tạo trình bổ trợ năm 2021 và buổi trò chuyện Tổng quan về trình bổ trợ năm 2021.

Bên thứ nhất so với bên thứ ba

Các trình bổ trợ được xác định trong kho lưu trữ blockly-samples là trình bổ trợ của bên thứ nhất, có nghĩa là các trình bổ trợ này được nhóm Blockly hỗ trợ và được phát hành trong phạm vi @blockly trên npm.

Các trình bổ trợ tuyệt vời của bên thứ nhất:

  • có các trường hợp sử dụng rõ ràng
  • là mục đích chung
  • ổn định
  • dễ sử dụng

Các trình bổ trợ của bên thứ ba được duy trì và phát hành một cách độc lập. Các trình bổ trợ của bên thứ ba có thể phức tạp hơn, có tính thử nghiệm cao hơn hoặc được nhắm mục tiêu nhiều hơn.

Ví dụ: một trường để đặt tốc độ động cơ có thể được sử dụng trong nhiều dự án robot. Mặt khác, một trường để chỉnh sửa một đối tượng cụ thể do giản đồ cơ sở dữ liệu xác định sẽ phù hợp hơn với vai trò là trình bổ trợ của bên thứ ba.

Tiêu chí của bên thứ nhất

Trình bổ trợ của bên thứ nhất phải đáp ứng các yêu cầu sau:

  • Hoạt động trên tất cả các nền tảng chính, trừ phi được nhóm Blockly cấp quyền miễn trừ.
    • Chrome, Firefox, Safari, Edge
  • Có một tác giả sẵn sàng xử lý các lỗi trong năm đầu tiên.
  • Không vá lỗi Blockly.
  • Có API được xác định và ghi nhận rõ ràng.
  • Không gọi các hàm riêng tư hoặc đóng gói từ lõi Blockly, trừ phi được nhóm Blockly cấp quyền miễn trừ.
    • Việc ghi đè các hàm của gói trên một lớp con mà bạn xác định là được phép.
    • Nếu bạn muốn được miễn trừ, hãy yêu cầu chúng tôi về vấn đề liên quan đến mẫu theo khối.
  • Có thử nghiệm.

Tìm trình bổ trợ

  • Trên các trang GitHub, hãy khám phá bản minh hoạ trực tiếp về các trình bổ trợ của bên thứ nhất.
  • Vào npm Tìm kiếm @blockly để xem danh sách các trình bổ trợ do nhóm Blockly phát hành.
  • Trên GitHub, hãy xem thư mục trình bổ trợ trong kho lưu trữ mẫu khối. Mỗi trình bổ trợ có một README mô tả hành vi và mục đích sử dụng của trình bổ trợ đó.

Cài đặt trình bổ trợ

  1. Tìm trình bổ trợ bạn muốn cài đặt bằng một trong các tài nguyên ở trên và tìm tệp README.

  2. Hãy làm theo mọi hướng dẫn cài đặt trong tệp README. Nhìn chung, bạn cần cài đặt trình bổ trợ từ npm, ví dụ:

    npm install @blockly/block-plus-minus --save

    và nhập vào mã của bạn, ví dụ:

    import Blockly from 'blockly';
import '@blockly/block-plus-minus';

  3. Một số trình bổ trợ có thể yêu cầu thêm một số bước, chẳng hạn như khởi chạy hoặc đăng ký trình bổ trợ. Các bước này sẽ được liệt kê trong tệp README.

Phiên bản trình bổ trợ

Các trình bổ trợ trong mẫu khối tuân theo phiên bản ngữ nghĩa, vì vậy, mọi thay đổi có thể gây lỗi sẽ nằm trong phiên bản lớn mới. Mọi trình bổ trợ mới dựa vào lõi vá lỗi khỉ đều có phiên bản lớn là 0 để biểu thị quá trình phát triển ban đầu như đã nêu trong phần thông số kỹ thuật của trình mô phỏng.

Hầu hết các trình bổ trợ đều bao gồm gói blockly chính dưới dạng phần phụ thuộc ngang hàng thay vì phần phụ thuộc. Điều này là do chúng tôi dự kiến bạn đã tự cài đặt Blockly trong ứng dụng của riêng mình (sẽ không hợp lý nếu bạn sử dụng trình bổ trợ mà không sử dụng Blockly nếu không dùng Blockly). Do đó, bạn có thể tự quản lý phiên bản của Blockly. Tuy nhiên, nhiều trình bổ trợ được phát triển để sử dụng các API mới có trong phiên bản mới nhất của Blockly, vì vậy, bạn cần nắm được các yêu cầu về phiên bản. package.json của trình bổ trợ sẽ cho bạn biết phiên bản tối thiểu của Blockly tương thích với trình bổ trợ đó. Nếu một trình bổ trợ được cập nhật để cần phiên bản Blockly mới hơn, chẳng hạn như để tận dụng một API hoàn toàn mới, thì phiên bản chính của trình bổ trợ đó sẽ được tăng lên, vì chúng tôi coi đây là thay đổi có thể gây lỗi.

Khi bạn thêm trình bổ trợ vào package.json, theo mặc định, hãy thêm một con nháy trước phiên bản, chẳng hạn như

"@blockly/block-plus-minus": "^2.0.15"

Điều này sẽ cho phép npm cài đặt mọi phiên bản nhỏ ở mức bằng hoặc cao hơn phiên bản đã liệt kê, vì vậy, phiên bản 2.0.20 hoặc 2.1.0 có thể hoạt động, ngoại trừ phiên bản lớn mới như 3.0.1. Khi cập nhật lên phiên bản mới của Blockly, bạn nên kiểm tra xem có trình bổ trợ nào có thể được cập nhật lên phiên bản lớn mới hay không.

Cài đặt trình bổ trợ mà không cần npm

Mặc dù thường thì bạn nên sử dụng npm để dễ dàng nhận bản cập nhật, nhưng bạn có thể sử dụng các trình bổ trợ mà không cần npm.

Bạn có thể sử dụng unpkg để bao gồm các tệp trình bổ trợ mà không cần sao chép chúng, ví dụ:

<script src="https://unpkg.com/@blockly/block-plus-minus"></script>

Bạn cũng có thể sao chép kho lưu trữ blockly-samples và đưa các tệp vào cục bộ tương tự như khi sao chép Blockly. Tuy nhiên, bạn nên sử dụng trình quản lý gói nếu có thể, vì trình quản lý này sẽ giúp bạn cập nhật các tính năng và bản sửa lỗi mới nhất trong trình bổ trợ.

Với phương thức này, bạn vẫn cần thực hiện mọi bước khởi chạy hoặc đăng ký được liệt kê trong tệp README của trình bổ trợ.