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