Blockly เป็นโอเพนซอร์สและได้รับการดูแลเป็นหลักโดยทีมงานกลุ่มเล็กๆ เรายินดีรับ การมีส่วนร่วมจากนักพัฒนาแอปภายนอกทีมหลัก เราไม่สามารถ สร้างฟีเจอร์ที่ขอมาทั้งหมดหรือแก้ไขข้อบกพร่องที่รายงานทั้งหมดได้หากไม่มีชุมชน ส่วนนี้มีคำแนะนำทั่วไปที่อาจเป็นประโยชน์ต่อคุณ โดยเฉพาะอย่างยิ่งหากคุณเพิ่งเริ่มต้นพัฒนาโอเพนซอร์ส
ดูข้อมูลเฉพาะของ Blockly ที่คุณควรอ่านก่อนทำการ มีส่วนร่วมได้ที่ส่วน การมีส่วนร่วมในส่วนหลักและ การมีส่วนร่วมในตัวอย่าง
ที่เก็บใด
ที่เก็บมีไฟล์ทั้งหมดสำหรับโปรเจ็กต์เดียว Blockly มีที่เก็บ 2 แห่ง ได้แก่ blockly core และ blockly-samples
Blockly Core คือที่เก็บสำหรับไลบรารี Blockly ใช้ที่เก็บนี้ หากต้องการเปลี่ยนแปลงลักษณะการทำงานหลักของ Blockly ในลักษณะที่จะมีผล ต่อผู้ใช้ไลบรารีทุกคน
ตัวอย่าง Blockly เป็นที่เก็บตัวอย่าง ปลั๊กอิน และ Codelab ใช้ที่เก็บนี้หากต้องการสร้างหรือแก้ไขปลั๊กอิน เขียน Codelab หรือ สร้างหรือแก้ไขตัวอย่าง
คำแนะนำทีละขั้นตอน
ต่อไปนี้เป็นขั้นตอนทั่วไปที่คุณจะทำตามได้ทุกครั้งที่ทำการเปลี่ยนแปลง
- ติดตั้ง Git และ Node โดยใช้ลิงก์ในส่วนเครื่องมือ
- แยกและโคลนที่เก็บ GitHub มีบทแนะนำที่ยอดเยี่ยมเกี่ยวกับ การแยกที่เก็บ หากต้องการใช้กับ Blockly เพียงแทนที่ทุกอินสแตนซ์ของ octocat/Spoon-Knife ด้วย RaspberryPiFoundation/blockly หรือ RaspberryPiFoundation/blockly-samples ขึ้นอยู่กับที่เก็บที่คุณต้องการทำงาน ด้วย
- ซิงค์ Fork GitHub มีบทแนะนำสำหรับการซิงค์ Fork ด้วย
- ดูสาขาหลัก ใน Blockly Core ค่านี้คือกิ่ง
developใน blockly-samples จะเป็นmasterbranch - ติดตั้งการอ้างอิงและเครื่องมือสร้างโดยเรียกใช้
npm installใน ไดเรกทอรีราก - สร้างกิ่งใหม่โดยเรียกใช้
git checkout -b myBranchNameในเทอร์มินัล ชื่อควรช่วยให้คุณจำได้ว่ากำลังทำอะไรอยู่ - ทำการเปลี่ยนแปลง
- ตรวจสอบการเปลี่ยนแปลงตามคำแนะนำสำหรับ หลักหรือ ตัวอย่าง
- บันทึกการเปลี่ยนแปลงด้วย
git commit -am "fix: My commit message"อ่านเพิ่มเติมเกี่ยวกับข้อความคอมมิต - พุชการเปลี่ยนแปลงไปยัง GitHub ด้วย
git push origin myBranchName - เปิดคำขอพุลเมื่อโค้ดพร้อมใช้งาน สมาชิกในทีม Blockly จะตรวจสอบการเปลี่ยนแปลงของคุณและผสานรวมเข้ากับ Blockly หากได้รับอนุมัติ ดูข้อมูลเพิ่มเติมได้ที่ กระบวนการตรวจสอบคำขอส่งรวม