การตรวจรูปแบบ การจัดรูปแบบ และคะแนน pana

ก่อนเผยแพร่ Dart มีเครื่องมือช่วยปรับปรุงโค้ดของคุณโดยอัตโนมัติ การตรวจสอบคุณภาพช่วยพบปัญหาได้ตั้งแต่เนิ่น ๆ และทำให้แพ็กเกจดูเป็นมืออาชีพ 🧹

คำสั่ง dart format จะเขียนไฟล์ของคุณใหม่ตามรูปแบบมาตรฐาน การเว้นวรรคและการขึ้นบรรทัดที่สอดคล้องกันจะเกิดขึ้นทันที ช่วยยุติการถกเถียงเรื่องรูปแบบทั้งหมด

เรียกใช้ dart analyze เพื่อค้นหาข้อผิดพลาด คำเตือน และรูปแบบที่มีความเสี่ยงโดยไม่ต้องเรียกใช้โค้ด เครื่องมือนี้เปรียบเสมือนผู้ตรวจสอบที่ละเอียดและไม่รู้จักเหน็ดเหนื่อย

ไฟล์ analysis_options.yaml ควบคุมว่าจะใช้กฎตรวจรูปแบบใดบ้าง คุณสามารถเลือกใช้การตรวจสอบที่เข้มงวดขึ้น หรือผ่อนปรนกฎที่ไม่เหมาะกับโครงการของคุณ

กฎตรวจรูปแบบคือคำแนะนำด้านรูปแบบหรือความถูกต้อง ไม่ใช่ข้อผิดพลาดร้ายแรง การทำตามกฎที่แนะนำช่วยให้โค้ดเป็นไปตามแนวทางของภาษาและอ่านง่ายขึ้นสำหรับผู้อื่น

แพ็กเกจส่วนใหญ่มีแพ็กเกจ lints และเลือกใช้ชุดกฎที่แนะนำของแพ็กเกจนั้น การเพิ่มเพียงบรรทัดเดียวใน analysis_options ก็ทำให้คุณได้รายการกฎที่คัดสรรและได้รับความเชื่อถือจากชุมชน

เครื่องมือ pana จำลองวิธีที่ pub.dev ใช้ให้คะแนนแพ็กเกจของคุณได้อย่างแม่นยำ การเรียกใช้ภายในเครื่องจะแสดงระดับคะแนนของคุณก่อนที่ผู้อื่นจะเห็น

คะแนน pub ให้รางวัลแก่การทำตามธรรมเนียม การจัดทำเอกสาร API การผ่านการวิเคราะห์ และการรองรับแพลตฟอร์ม แต่ละหมวดจะรวมกันเป็นคะแนนสาธารณะทั้งหมด

ตั้งเป้าให้การเรียกใช้ analyze ผ่านโดยไม่มีคำเตือน pana จะหักคะแนนจากปัญหาต่าง ๆ ดังนั้นการแก้ปัญหาเหล่านั้นจึงช่วยเพิ่มคะแนนที่มองเห็นได้โดยตรง

เรียกใช้ format, analyze และการทดสอบในกระบวนการ CI ทุกการพุชจะได้รับการตรวจสอบด้วยวิธีเดียวกัน ปัญหาจึงไม่หลุดเข้าไปถึงรุ่นที่จะเผยแพร่ 🤖

ก่อนเผยแพร่จริง ให้เรียกใช้ format, analyze, test และ pana พร้อมกัน รายการตรวจสอบสั้น ๆ นี้ช่วยเปลี่ยนเรื่องไม่คาดคิดขณะอัปโหลดให้กลายเป็นการเผยแพร่ที่ราบรื่นและคาดเดาได้

ตอนนี้คุณสามารถ จัดรูปแบบ วิเคราะห์ ตรวจรูปแบบ และเรียกใช้ pana เพื่อดูตัวอย่างคะแนน pub ได้แล้ว โค้ดที่สะอาดในวันนี้หมายถึงคะแนนที่สูงขึ้นในวันพรุ่งนี้ ✅