ที่เก็บข้อมูลหลักของ Blockly มีโค้ดที่จําเป็นต่อการเรียกใช้แอปพลิเคชันที่ใช้ Blockly
ข้อมูลที่ต้องทราบ
ต่อไปนี้เป็นภาพรวมสั้นๆ ของข้อเท็จจริงเกี่ยวกับ Blockly Core ที่คุณจำเป็นต้องทราบเพื่อสร้าง PR
- สาขาที่ใช้งานคือ develop และควรส่ง PR ทั้งหมดเทียบกับ develop
- คุณต้องกรอกข้อมูลในเทมเพลตคำขอดึงข้อมูลตามข้อมูลที่ร้องขอ
- โค้ดต้องเป็นไปตามคำแนะนำสไตล์ TypeScript ของ Google
- ใช้การคอมมิตแบบดั้งเดิมในข้อความการคอมมิตและชื่อคำขอดึง
- สตริงที่ผู้ใช้มองเห็นต้องอยู่ในไฟล์
/msg/messages.jsเพื่อให้ได้รับการแปล ผู้คนทั่วโลกที่พูดภาษาอังกฤษเป็นภาษาแม่มีไม่ถึง 6% - โดยทั่วไปแล้ว ข้อความในบล็อกควรเป็นตัวพิมพ์เล็กทั้งหมด (เช่นเดียวกับคีย์เวิร์ดในภาษาโปรแกรมส่วนใหญ่)
- คงความเข้ากันได้แบบย้อนหลัง มีแอป Blockly อยู่มากมาย อย่าทำให้แอปอื่นๆ ใช้งานไม่ได้
ไฟล์โค้ดใหม่ต้องมีคำนำหน้าเป็นใบอนุญาต Apache v2.0 ดังนี้
/** * @license * Copyright <Current YYYY> Google LLC * SPDX-License-Identifier: Apache-2.0 */
ทำและยืนยันการเปลี่ยนแปลง
- เรียกใช้
npm installเพื่อติดตั้งข้อกําหนดเบื้องต้น - เรียกใช้
npm run startเพื่อเริ่มเซิร์ฟเวอร์ที่เรียกใช้พื้นที่ทํางาน คุณใช้หน้านี้เพื่อทดสอบลักษณะการทำงานที่มีอยู่ได้ ดูข้อมูลเพิ่มเติมที่หน้าPlayground - ทำการเปลี่ยนแปลงที่จำเป็นกับโค้ด
- หากคุณเปิดเซิร์ฟเวอร์ไว้ ให้รีเฟรชเพื่อดูการเปลี่ยนแปลง หรือจะรีสตาร์ทเซิร์ฟเวอร์และตรวจสอบว่าโค้ดทํางานตามที่คาดไว้และไม่มีข้อผิดพลาดหรือคําเตือนในคอนโซลก็ได้
- เรียกใช้
npm run buildและตรวจสอบว่าไม่มีข้อผิดพลาดในการสร้าง - เขียนการทดสอบอัตโนมัติ โดยปกติแล้ว ไฟล์เหล่านี้จะเป็นไฟล์ทดสอบ mocha ในไดเรกทอรี
tests/mochaแต่เราอาจขอไฟล์ทดสอบประเภทอื่นๆ จากคุณ - เรียกใช้
npm run formatเพื่อจัดรูปแบบโค้ดและแก้ไขปัญหาบางอย่างของ Lint โดยอัตโนมัติ - เรียกใช้
npm testเพื่อทำการทดสอบอัตโนมัติ ซึ่งจะเรียกใช้eslintด้วย - หากมีข้อผิดพลาดเกี่ยวกับโปรแกรมตรวจไวยากรณ์ ให้เรียกใช้
npm run lint:fixเพื่อแก้ไขปัญหาที่แก้ไขอัตโนมัติได้ แก้ไขคำเตือนหรือข้อผิดพลาดจาก Lint ที่เหลืออยู่ - หากการทดสอบทั้งหมดผ่านแล้ว คุณก็พร้อมที่จะเปิด PR กับ develop ที่มีการเปลี่ยนแปลงของคุณ