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