ที่เก็บหลักของ Blockly มีโค้ดที่จำเป็นในการเรียกใช้แอปพลิเคชันที่ใช้ Blockly
สิ่งที่ควรทราบ
ต่อไปนี้เป็นภาพรวมโดยย่อเกี่ยวกับข้อเท็จจริงเกี่ยวกับ Blockly Core ที่คุณต้องทราบเพื่อสร้างคำขอส่งรวม
- สาขาที่ใช้งานคือ main และควรส่งคำขอ Pull ทั้งหมดไปยังสาขา main
- คุณต้องกรอกข้อมูลที่ร้องขอในเทมเพลตคำขอ Pull
- โค้ดต้องเป็นไปตามคำแนะนำเกี่ยวกับรูปแบบ TypeScript ของ Google
- ใช้การคอมมิตตามรูปแบบมาตรฐาน ในข้อความคอมมิตและชื่อคำขอพุล
- สตริงที่ผู้ใช้มองเห็นได้ต้องอยู่ในไฟล์
/msg/messages.jsเพื่อให้แปลได้ มีประชากรโลกน้อยกว่า 6% ที่พูดภาษาอังกฤษเป็นภาษาแม่ - โดยทั่วไปแล้ว ข้อความในบล็อกควรเป็นตัวพิมพ์เล็กทั้งหมด (เช่นเดียวกับคีย์เวิร์ดในภาษาโปรแกรมส่วนใหญ่)
- คงความเข้ากันได้แบบย้อนหลัง มีแอป Blockly มากมาย อย่าทำให้แอปอื่นๆ ใช้งานไม่ได้
ไฟล์โค้ดใหม่ต้องมีคำนำหน้าเป็น Apache License 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ด้วย - หากมีข้อผิดพลาดของ Lint ให้เรียกใช้
npm run lint:fixเพื่อแก้ไขปัญหาที่ แก้ไขอัตโนมัติได้ จัดการคำเตือนหรือข้อผิดพลาดที่เหลืออยู่ของ Lint - หากการทดสอบทั้งหมดผ่าน คุณก็พร้อมที่จะเปิด PR กับ main พร้อมการเปลี่ยนแปลง แล้ว