สนับสนุนบริการหลัก

ที่เก็บข้อมูลหลักของ Blockly มีโค้ดที่จําเป็นต่อการเรียกใช้แอปพลิเคชันที่ใช้ Blockly

ข้อมูลที่ต้องทราบ

ต่อไปนี้เป็นภาพรวมสั้นๆ ของข้อเท็จจริงเกี่ยวกับ Blockly Core ที่คุณจำเป็นต้องทราบเพื่อสร้าง PR

• สาขาที่ใช้งานคือ develop และควรส่ง PR ทั้งหมดเทียบกับ develop
• คุณต้องกรอกข้อมูลในเทมเพลตคำขอดึงข้อมูลตามข้อมูลที่ร้องขอ
• โค้ดต้องเป็นไปตาม TypeScript Style Guide ของ Google
• ใช้การคอมมิตแบบดั้งเดิมในข้อความการคอมมิตและชื่อคำขอดึง
• สตริงที่ผู้ใช้มองเห็นต้องอยู่ในไฟล์ /msg/messages.js เพื่อให้ได้รับการแปล ผู้คนทั่วโลกที่พูดภาษาอังกฤษเป็นภาษาแม่มีไม่ถึง 6%
• ข้อความบนบล็อกควรเป็นตัวพิมพ์เล็กทั้งหมด (เช่นเดียวกับคีย์เวิร์ดในภาษาโปรแกรมส่วนใหญ่)
• คงความเข้ากันได้แบบย้อนหลัง มีแอป Blockly อยู่มากมาย อย่าทำให้แอปอื่นๆ ใช้งานไม่ได้

• ไฟล์โค้ดใหม่ต้องมีคำนำหน้าเป็นใบอนุญาต Apache v2.0 ดังนี้

  /**
   *   @license
   *   Copyright <Current YYYY> Google LLC
   *   SPDX-License-Identifier: Apache-2.0
   */
  

ทำและยืนยันการเปลี่ยนแปลง

1. เรียกใช้ npm install เพื่อติดตั้งข้อกําหนดเบื้องต้น
2. เรียกใช้ npm run start เพื่อเริ่มเซิร์ฟเวอร์ที่เรียกใช้พื้นที่ทํางาน คุณใช้หน้านี้เพื่อทดสอบลักษณะการทำงานที่มีอยู่ได้ ดูหน้า playground สำหรับข้อมูลเพิ่มเติม
3. ทำการเปลี่ยนแปลงที่จำเป็นกับโค้ด
4. หากคุณไม่ได้ปิดเซิร์ฟเวอร์ ให้รีเฟรชเพื่อดูการเปลี่ยนแปลง หรือจะรีสตาร์ทเซิร์ฟเวอร์และตรวจสอบว่าโค้ดทํางานตามที่คาดไว้และไม่มีข้อผิดพลาดหรือคําเตือนในคอนโซลก็ได้
5. เรียกใช้ npm run build และตรวจสอบว่าไม่มีข้อผิดพลาดในการสร้าง
6. เขียนการทดสอบอัตโนมัติ ซึ่งโดยปกติจะเป็นการทดสอบมอคค่าในไดเรกทอรี tests/mocha แต่เราอาจขอให้ทดสอบประเภทอื่นๆ
7. เรียกใช้ npm run format เพื่อจัดรูปแบบโค้ดและแก้ไขปัญหาบางอย่างของ Lint โดยอัตโนมัติ
8. เรียกใช้ npm test เพื่อทำการทดสอบอัตโนมัติ ซึ่งจะเรียกใช้ eslint ด้วย
9. หากมีข้อผิดพลาดเกี่ยวกับโปรแกรมตรวจไวยากรณ์ ให้เรียกใช้ npm run lint:fix เพื่อแก้ไขปัญหาที่แก้ไขอัตโนมัติได้ แก้ไขคำเตือนหรือข้อผิดพลาดจาก Lint ที่เหลืออยู่
10. หากการทดสอบทั้งหมดผ่าน คุณก็พร้อมที่จะแสดงการประชาสัมพันธ์เทียบกับการพัฒนาพร้อมการเปลี่ยนแปลงของคุณ