Đó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 mọi ứng dụng dựa trên Blockly.

Thông tin cần biết

Sau đây là thông tin tổng quan ngắn gọn về các thông tin cốt lõi về khối mà bạn cần biết để tạo một hoạt động PR.

  • Nhánh đang hoạt động là develop và tất cả các yêu cầu phát hành phải được tạo dựa trên nhánh develop.
  • Bạn phải điền thông tin được yêu cầu vào mẫu yêu cầu thay đổi.
  • Mã phải tuân thủ Hướng dẫn về kiểu TypeScript của Google.
  • Sử dụng các thay đổi thông thường trong thông báo thay đổi và tiêu đề yêu cầu kéo.
  • Các chuỗi mà người dùng thấy phải nằm trong tệp /msg/messages.js để có thể dịch các chuỗi này. 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 nhìn chung 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, đừng làm hỏng ứng dụng của người 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 Kotlin Playground. Bạn có thể sử dụng trang này để kiểm thử hành vi hiện có. Hãy xem trang playground (sân chơi) để biết thêm thông tin.
  3. Hãy thực hiện mọi thay đổi cần thiết đối với mã.
  4. Nếu bạ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 nà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à các bài kiểm thử mocha trong thư mục tests/mocha, nhưng chúng tôi có thể yêu cầu bạn cung cấp 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 các bài kiểm thử tự động. Thao tác này cũng chạy eslint.
  9. Nếu có 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 tìm lỗi mã nguồn còn lại.
  10. Nếu tất cả các bài kiểm thử đều thành công, bạn có thể mở một yêu cầu thay đổi đối với develop bằng các thay đổi của mình.