شارك المقالة
إعداد Android Flavors في Flutter ومعرف وموارد كل نسخة

إعداد Android Flavors في Flutter ومعرف وموارد كل نسخة

تعريف productFlavors في Flutter Android وفصل applicationId والاسم والأيقونة وموارد Firebase، مع أمثلة تشغيل صحيحة لكل نكهة.

تعريف 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"
        }
    }
}
شرح الكود:
flavorDimensions : يحدد البعد الذي تنتمي إليه النكهات.
applicationIdSuffix : يضيف لاحقة إلى اسم الحزمة (Package Name) لكل Flavor.
versionNameSuffix : يضيف لاحقة إلى اسم الإصدار للتمييز بين النكهات.

كيفيه تغيير الصوره وملف firebase لكل flavor

تقوم في ملف src بعمل انشاء لاسم ال flavor وبداخله res
وتضع به ملفات الصور و الfirebase واي شيئ اخر ترغب به مخصصه لهذا المشروع

كيف تضيف Flavors في Flutter لأندرويد وتبني نسخ متعددة من تطبيقك بسهولة


في النهايه انتقل الي الاعلي وتحديدا الي ايقونه main الموجوده بالاعلي وعمل تخصيص لكل flavor

كيف تضيف Flavors في Flutter لأندرويد وتبني نسخ متعددة من تطبيقك بسهولة


في هذا المثال نكتب — falvor وبعدها اسم ال flavour وعند عمل run يتم اختياره ليبدء عمل التطبيق منه

–flavor pos

كيف تضيف Flavors في Flutter لأندرويد وتبني نسخ متعددة من تطبيقك بسهولة


والان اذا كنت ترغب بعمل run release او build يجب تحديد ال flavour مثل

flutter run –release –flavor pos

Flavors تساعدك على إدارة نسخ متعددة من التطبيق بسهولة وكفاءة دون الحاجة إلى كتابة كود جديد لكل نسخة.

مرجع للتنفيذ

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

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع