‏dart pub publish إلى pub.dev

عندما تصبح حزمتكم جاهزة، يرسلها أمر واحد إلى العالم. يضع Publishing مكتبتكم على pub.dev حتى يتمكن أي شخص من الاعتماد عليها. 🌍

حدّدوا version واضحةً في pubspec.yaml وفق semantic versioning. وتخبر أرقام الإصدار الرئيسي والثانوي وإصلاح الأخطاء المستخدمين بمقدار التغيير بدقة.

يحتاج كل إصدار إلى إدخال مطابق في CHANGELOG لديكم. يقرأه المستخدمون ليقرروا ما إذا كانوا سيحدّثون وكيفية ذلك، لذا صفوا التغييرات بوضوح.

يجب أن تتضمن الحزمة المنشورة ملف LICENSE. فهو يخبر المستخدمين بحقوقهم القانونية، ويتعرف pub.dev تلقائيًا إلى تراخيص المصادر المفتوحة الشائعة.

شغّلوا publish مع الخيار dry-run للتحقق من كل شيء دون رفعه. وسيكشف ذلك الملفات المفقودة أو التحذيرات ما دامت التغييرات لا تزال سهلة الإصلاح.

يفتح أول نشر متصفحًا لتسجيل الدخول. ويربط pub.dev عملية الرفع بـ account الخاص بكم، ويمكنكم لاحقًا إضافة مستخدمين آخرين بصفتهم رافعين.

عندما ينجح التشغيل التجريبي، احذفوا الخيار وانشروا الحزمة. يرفع أمر publish ملفاتكم ويجعل الإصدار متاحًا خلال ثوانٍ.

بعد نشره، لا يمكن حذف إصدار، بل يمكن فقط سحبه للحد من استخدامه الجديد. تحقّقوا من ملفاتكم جيدًا، إذ إن الخطأ يبقى في السجل.

أبقوا الأسرار والملفات غير الضرورية خارج عملية الرفع. يتجاهل Dart الملفات المطابقة لـ .gitignore، لذلك يضمن الالتزام السليم بقاء أرشيفكم المنشور نظيفًا.

انشروا بصفتكم ناشرًا موثَّقًا مرتبطًا بنطاق تملكونه. تعزّز الشارة الثقة وتجمع جميع حزمكم تحت هوية واحدة. 🛡️

في كل تحديث، ارفعوا رقم الإصدار، وأضيفوا إدخالًا إلى CHANGELOG، وأعيدوا تشغيل الفحوصات، ثم انشروا من جديد. وتتكرر هذه الدورة السلسة طوال عمر الحزمة.

ما الخطوة الأولى الآمنة قبل رفع حزمتكم فعليًا؟

تعلّمتم إدارة الإصدار، وتوثيق التغييرات، وتحديد الترخيص، وإجراء تشغيل تجريبي، وأخيرًا تنفيذ dart pub publish. أصبحت حزمتكم الآن جزءًا من المنظومة. 🎉