Bắt đầu đóng góp cho Blockly

Blockly là nguồn mở và chủ yếu được duy trì bởi một nhóm nhỏ. Chúng tôi hoan nghênh đóng góp của các nhà phát triển bên ngoài nhóm cốt lõi. Không có cách nào để chúng tôi xây dựng mọi tính năng được yêu cầu hoặc sửa mọi lỗi được báo cáo mà không có cộng đồng của chúng tôi. Phần này chứa các hướng dẫn chung có thể hữu ích cho bạn, đặc biệt nếu bạn mới bắt đầu phát triển nguồn mở.

Để biết thông tin dành riêng cho Blockly, bạn nên đọc trước khi đóng góp, hãy xem nội dung Đóng góp cho Core và Đóng góp cho mẫu.

Kho lưu trữ nào?

Một kho lưu trữ chứa tất cả tệp cho một dự án. Khối có hai kho lưu trữ: khối chặn và khối mẫu.

Blockly core là kho lưu trữ của thư viện Blockly. Dùng kho lưu trữ này nếu bạn muốn thay đổi hành vi cốt lõi của khối theo cách áp dụng cho tất cả người dùng của thư viện.

Mẫu khối là kho lưu trữ mẫu, trình bổ trợ và lớp học lập trình. Dùng kho lưu trữ này nếu bạn muốn tạo hoặc sửa đổi một trình bổ trợ; viết một lớp học lập trình; hoặc tạo hoặc sửa đổi một mẫu.

Từng bước

Đây là các bước chung mà bạn sẽ thực hiện bất cứ khi nào bạn thực hiện thay đổi.

  1. Cài đặt Git và nút, đi theo các đường liên kết trong phần Công cụ.
  2. Phân nhánh và nhân bản kho lưu trữ. GitHub có một hướng dẫn tuyệt vời về cách tạo kho lưu trữ. Để áp dụng khối này, bạn chỉ cần thay thế mọi bản sao của octocat/Spoon-Knife bằng google/blockly hoặc google/blockly-samples, tuỳ thuộc vào kho lưu trữ bạn muốn làm việc.
  3. Đồng bộ hoá nhánh. GitHub cũng cung cấp hướng dẫn về cách đồng bộ hoá một nhánh phát triển.
  4. Xem nhánh chính. Trong lõi, đây là các nhánh develop. Trong các mẫu khối, đây là nhánh master.
  5. Cài đặt các phần phụ thuộc và xây dựng các công cụ bằng cách chạy npm install trong thư mục gốc.
  6. Tạo nhánh mới bằng cách chạy git checkout -b myBranchName ở một thiết bị đầu cuối. Tên này giúp bạn ghi nhớ những công việc bạn đang làm.
  7. Thực hiện thay đổi.
  8. Xác thực các thay đổi của bạn, làm theo hướng dẫn dành cho mẫu hoặc mẫu.
  9. Lưu các thay đổi với git commit -am "fix: My commit message". Đọc thêm về thông báo cam kết.
  10. Đẩy các thay đổi của bạn lên GitHub bằng git push origin myBranchName.
  11. Mở một yêu cầu gộp khi mã của bạn đã sẵn sàng. Một thành viên của nhóm Blockly sẽ xem xét các thay đổi của bạn và hợp nhất các thay đổi đó vào Blockly nếu được phê duyệt. Để biết thêm thông tin, hãy xem nội dung Quy trình xem xét PR.