มีส่วนร่วมในโค้ดหลัก

ที่เก็บหลักของ 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
     */
    

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

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