Đóng góp cho kênh cốt lõi

Kho lưu trữ lõi Blockly chứa mã cần thiết để chạy bất kỳ ứng dụng nào dựa trên Blockly.

Những điều cần biết

Dưới đây là thông tin tổng quan nhanh về các yếu tố cốt lõi theo khối mà bạn cần biết để tạo mối quan hệ công chúng.

  • Nhánh hoạt động là phát triển và mọi PR phải được thực hiện dựa trên phát triển.
  • Bạn phải điền thông tin được yêu cầu vào mẫu yêu cầu lấy dữ liệu.
  • Mã phải tuân thủ Hướng dẫn về kiểu chữ TypeScript của Google.
  • Sử dụng các thay đổi thông thường trong thông báo cam kết và tiêu đề của yêu cầu lấy dữ liệu.
  • Các chuỗi mà người dùng nhìn thấy phải nằm trong tệp /msg/messages.js thì mới có thể được dịch. Chưa đến 6% dân số thế giới nói tiếng Anh bản địa.
  • Văn bản trên các khối thường phải là chữ thường (giống như các từ khoá trong hầu hết các ngôn ngữ lập trình).
  • Duy trì khả năng tương thích ngược. Có rất nhiều ứng dụng Blockly trên thị trường, bạn đừng nên chia sẻ với bất kỳ ứng dụng nào khác.

  • Mọi tệp mã mới đều phải có tiền tố là Giấy phép Apache phiên bản 2.0:

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

Thực hiện và xác minh thay đổi

  1. Chạy npm install để cài đặt các phần phụ thuộc.
  2. Chạy npm run start để khởi động một máy chủ chạy Playground. Bạn có thể sử dụng trang này để kiểm thử hành vi hiện có. Vui lòng xem trang playground để biết thêm thông tin.
  3. Thực hiện mọi thay đổi cần thiết đối với mã.
  4. Nếu bạn vẫn để máy chủ chạy, hãy làm mới để xem các thay đổi. Nếu không, hãy khởi động lại máy chủ và xác minh mã hoạt động như dự kiến và không có lỗi hoặc cảnh báo trong bảng điều khiển.
  5. Chạy npm run build và đảm bảo không có lỗi bản dựng.
  6. Viết bài kiểm thử tự động. Thông thường, đây sẽ là kiểm thử mocha trong thư mục tests/mocha, nhưng chúng tôi có thể yêu cầu bạn thực hiện các loại kiểm thử khác.
  7. Chạy npm run format để định dạng mã và tự động khắc phục một số vấn đề về tìm lỗi mã nguồn.
  8. Chạy npm test để chạy kiểm thử tự động. Hàm này cũng chạy eslint.
  9. Nếu xảy ra lỗi tìm lỗi mã nguồn, hãy chạy npm run lint:fix để khắc phục các vấn đề có thể tự động khắc phục. Giải quyết mọi cảnh báo hoặc lỗi còn lại liên quan đến việc tìm lỗi mã nguồn.
  10. Nếu tất cả bài kiểm thử đều đạt, bạn đã sẵn sàng để mở PR dựa trên việc phát triển các thay đổi của mình.