قيود الإصدارات وملف القفل

يخبر version constraint pub بإصدارات الحزمة التي يقبلها مشروعك. وهو يوازن بين الحصول على الإصلاحات وتجنب التغييرات التي تكسر التوافق. 🎯

تتبع حزم Dart semantic versioning: major.minor.patch. وتشير زيادة major إلى تغييرات كاسرة للتوافق، بينما تضيف minor ميزات، وتصلح patch الأخطاء.

يقبل caret ^1.2.0 أي إصدار يبدأ من 1.2.0 وحتى ما قبل 2.0.0. وهو الإعداد الافتراضي المرن الذي يستخدمه pub.

تعني كتابة رقم مجرد exactly ذلك الإصدار، ولا شيء غيره. استخدم هذا بحذر عندما تحتاج إلى إصدار واحد معروف.

يمكنك تحديد range باستخدام عوامل المقارنة. ويمنحك ذلك تحكماً دقيقاً في الحدين الأدنى والأقصى.

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

عندما يحل pub اعتمادياتك، يسجل الإصدارات المحددة التي اختارها في pubspec.lock. ويثبت هذا الملف ما يثبته الجميع فعلياً.

يضمن ملف القفل عمليات بناء reproducible: فعند تشغيل زميلك pub get، يحصل على الإصدارات نفسها التي اختبرتها، لا على ترقيات مفاجئة.

بالنسبة إلى التطبيقات، أودِع commit pubspec.lock في نظام التحكم بالإصدارات. أما الحزم القابلة لإعادة الاستخدام، فاتركه خارجاً حتى يحل المستهلكون الإصدارات بأنفسهم.

شغّل dart pub upgrade لتحديث pubspec.lock إلى أحدث الإصدارات التي تسمح بها قيودك. أما get العادي فيحافظ على التثبيتات الحالية.

إذا طلبت حزمتان إصدارات غير متوافقة، فسيبلغ pub عن conflict. عندها يمكنك تخفيف أحد القيود أو اختيار إصدارات متوافقة من الحزم.

ما الذي يسمح به القيد ^1.2.0؟

أصبحت الآن تقرأ constraints مثل caret والنطاقات، وتعرف أن pubspec.lock يثبت الإصدارات المحددة لعمليات بناء قابلة لإعادة الإنتاج وخالية من التعارضات. 🎉