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

Blockly là nguồn mở và chủ yếu do một nhóm nhỏ duy trì. Chúng tôi hoan nghênh sự đóng góp của các nhà phát triển bên ngoài nhóm nòng cốt; chúng tôi không thể xây dựng mọi tính năng được yêu cầu hoặc sửa mọi lỗi đã báo cáo nếu 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 là nếu bạn mới bắt đầu phát triển nguồn mở.

Để biết thông tin cụ thể về Blockly mà bạn nên đọc trước khi đóng góp, hãy xem các phần Đóng góp cho Core và Đóng góp cho các mẫu.

Kho lưu trữ nào?

Một kho lưu trữ chứa tất cả các tệp cho một dự án duy nhất. Blockly có 2 kho lưu trữ: blockly core và blockly-samples.

Blockly core là kho lưu trữ cho thư viện Blockly. Hãy sử 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 Blockly theo cách sẽ áp dụng cho tất cả người dùng thư viện.

Blockly samples là kho lưu trữ các mẫu, trình bổ trợ và lớp học lập trình. Hãy sử 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 thay đổi.

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