تعريف productFlavors في Flutter Android وفصل applicationId والاسم والأيقونة وموارد Firebase، مع أمثلة تشغيل صحيحة لكل نكهة.
الموارد تتبع source set
موارد Android تكون داخل src/<flavor>/res، بينما google-services.json يوضع وفق دليل Google Services في source set المدعوم مثل src/development/google-services.json وليس داخل res اعتباطيًا. راجع هل ملفك build.gradle أو build.gradle.kts؛ صيغة Groovy لا تُلصق داخل Kotlin DSL كما هي.
تحقق من المنتج النهائي
شغل flutter run –flavor pos أو flutter build apk –release –flavor pos حسب النكهة الموجودة، وأضف -t إذا استعملت entrypoint آخر. لا تجعل اسم flavor بديلًا عن debug/release. اختبر تثبيت نسختين مع applicationId مختلفين، وراجع الأيقونة والاسم والاتصال بالخادم وFirebase في artifact بدل الاعتماد على اسم زر التشغيل.
الفرق بين source sets
يمكن لموارد src/main أن تكون مشتركة ثم تتخصص داخل src/development أو src/production؛ لا تنسخ كل الشجرة إلى كل flavor دون حاجة. افحص أولوية الدمج إذا وجدت قيمة مكررة للاسم أو الأيقونة. تعارُض manifest أو resource لا يعالج بتغيير اسم عشوائي قد يكسر استدعاءات أخرى، بل بتحديد المورد الذي ينبغي أن يكون عامًا أو خاصًا. إذا استعملت أكثر من flavor dimension فاسم variant الناتج قد يجمع قيمًا متعددة، ولذلك اختبر أمر البناء الذي يستعمله CI بدل افتراض أن اسم بُعد واحد يحدد النسخة كاملة.
مراجعة أخيرة للتطبيق
استخدم اسم flavor نفسه في أمر التطوير وأمر بناء نسخة التوزيع.
خطوات التطبيق والشرح
كيف تضيف Flavors في Flutter لأندرويد وتبني نسخ متعددة من تطبيقك بسهولة
في عالم تطوير التطبيقات، تعد ميزة Flavor واحدة من الأدوات القوية التي توفرها Flutter لتسهيل إدارة البيئات المختلفة داخل نفس المشروع. سواء كنت تعمل على إصدار تطوير (Development) ، اختبار (Staging) ، أو إنتاج (Production) ، فإن استخدام Flavors يساعدك على تنظيم الكود وتقليل الفوضى. في هذا المقال، سنشرح بالتفصيل كيفية إعداد واستخدام Flavor في Flutter للأندرويد،
ما هو Flavor؟
Flavor هو مفهوم يُستخدم لإنشاء متغيرات مختلفة من نفس التطبيق باستخدام نفس الكود الأساسي. يمكن لكل “Flavor” أن يكون له إعداداته الخاصة مثل:
API URLs (مثل واجهة برمجة التطبيقات الخاصة بالبيئة).
أيقونات التطبيق وأسمائه .
إعدادات أخرى خاصة بالبيئة (مثل Firebase Configuration).
على سبيل المثال:
Development : يستخدم API الخاص بالخادم المحلي.
Staging : يستخدم API الخاص بالخادم التجريبي.
Production : يستخدم API الخاص بالخادم الحيوي.
لماذا يجب استخدام Flavors؟
إدارة البيئات المختلفة : يمكنك فصل الإعدادات بين البيئات دون الحاجة إلى تغيير الكود يدويًا.
تحسين الإنتاجية : لا حاجة لإعادة بناء التطبيق بالكامل عند الانتقال بين البيئات.
تقليل الأخطاء البشرية : تقليل فرص الخطأ الناتج عن تغيير الإعدادات يدويًا.
سهولة الاختبار : اختبر ميزات جديدة في بيئة التطوير دون التأثير على الإصدار النهائي.
android {
...
flavorDimensions "pos"
productFlavors {
pos {
dimension "pos"
resValue "string", "app_name", "App 1"
}
selfservice {
dimension "pos"
applicationIdSuffix ".selfservice"
resValue "string", "app_name", "App 2"
versionNameSuffix ".selfservice"
}
}
}
كيفيه تغيير الصوره وملف firebase لكل flavor
مرجع للتنفيذ
راجع التوثيق الخاص بهذا الموضوع وطابق إعداداته مع إصدار أدوات مشروعك. اختبر السلوك المستهدف وحالة الفشل قبل إدماج المثال في تطبيق منشور.









