الفحص والتنسيق ودرجة pana

قبل الإطلاق، توفر لكم Dart أدوات لتحسين شيفرتكم تلقائيًا. تكتشف Quality checks المشكلات مبكرًا وتجعل حـزمتكم تبدو احترافية. 🧹

يعيد الأمر dart format كتابة ملفاتكم وفق النمط الرسمي. ويصبح تناسق المسافات وفواصل الأسطر فوريًا، لتنتهي بذلك جميع نقاشات التنسيق.

شغّلوا dart analyze للعثور على الأخطاء والتحذيرات والأنماط المحفوفة بالمخاطر دون تشغيل شيفرتكم. فهو يشبه مراجعًا دقيقًا لا يتعب أبدًا.

يتحكم ملف analysis_options.yaml في قواعد lint المطبّقة. ويمكنكم اختيار عمليات تحقق أكثر صرامة أو تخفيف القواعد التي لا تناسب مشروعكم.

إن lint اقتراح متعلق بالنمط أو الصحة، وليس خطأً حتميًا. ويساعد اتباع قواعد lint الموصى بها على إبقاء شيفرتكم متوافقة مع أسلوب Dart وأسهل قراءةً للآخرين.

تضم معظم الحزم حزمة lints وتختار مجموعتها الموصى بها. ويمنحكم سطر واحد في analysis_options قائمة قواعد منتقاة وموثوقة من المجتمع.

تحاكي أداة pana الطريقة التي يقيّم بها pub.dev حزمتكم بدقة. ويُظهر تشغيلها محليًا درجتكم قبل أن يراها أي شخص آخر.

تكافئكم pub points على اتباع الاصطلاحات، وتوثيق API، واجتياز التحليل، ودعم المنصات. وتُجمع نقاط كل فئة في إجمالي عام.

استهدفوا تشغيل analyze نظيفًا بلا أي تحذيرات. تخصم pana نقاطًا مقابل المشكلات، لذا فإن إزالتها ترفع نتيجتكم الظاهرة مباشرةً.

شغّلوا format وanalyze والاختبارات ضمن مسار CI لديكم. وهكذا يخضع كل push للتحقق بالطريقة نفسها، فلا تتسلل المشكلات إلى الإصدار. 🤖

قبل النشر مباشرةً، شغّلوا format وanalyze وtest وpana معًا. وتحول هذه checklist السريعة مفاجآت وقت الرفع إلى إصدار هادئ ومتوقع.

ما الأداة التي تعيد حساب النتيجة الدقيقة التي يمنحها pub.dev لحزمتكم؟

يمكنكم الآن إجراء format والتحليل وفحص lint وتشغيل pana لمعاينة pub points. الشيفرة النظيفة اليوم تعني نتيجة أعلى غدًا. ✅