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

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

Kho lưu trữ nào?

Kho lưu trữ chứa tất cả tệp cho một dự án. Blockly có hai kho lưu trữ: lõi blockly và blockly-samples.

Lõi Blockly 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 áp dụng cho tất cả người dùng thư viện.

Mẫu Blockly là kho lưu trữ cho các mẫu, trình bổ trợ và lớp học lập trình. Sử dụng kho lưu trữ này nếu bạn muốn tạo hoặc sửa đổi 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 thực hiệ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. Tạo 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 chia tách kho lưu trữ. Để áp dụng cho blockly, bạn chỉ cần thay thế mọi thực thể 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 của bạn. GitHub cũng cung cấp hướng dẫn về cách đồng bộ hoá một nhánh.
  4. Xem 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ụ xây dựng 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 phải giúp bạn nhớ được nội dung bạn đang làm.
  7. Thực hiện thay đổi.
  8. Xác thực các thay đổi theo hướng dẫn dành cho hạt nhân hoặc mẫu.
  9. Lưu các thay đổi bằng git commit -am "fix: My commit message". Đọc thêm về thông báo thay đổi.
  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 bài viết Quy trình xem xét nội dung quan hệ công chúng.