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