معالجة اختلاف شاشة بدء Flutter على Android 12 عبر ثيم الإطلاق وموارد API 31 وتطابق الخلفية بدل افتراض أن الشفافية تلغي شاشة النظام.
الشفافية ليست إلغاءً لشاشة النظام
تبدأ Android 12 بشاشة نظامية للتطبيق؛ لا يضمن Theme.Translucent إزالة السلوك وقد يسبب ظهور الواجهة السابقة أو قفزة بصرية. العلاج يبدأ بتوحيد windowSplashScreenBackground وموارد الأيقونة في الثيم الملائم للإصدار، ثم NormalTheme وأول إطار Flutter. لا تستخدم وصف «حل نهائي» لمجرد أن تجربة واحدة لم تظهر فيها الشاشة المزدوجة.
انتقال سريع قابل للقياس
افحص values وvalues-night وvalues-v31 وما يقابلها من موارد ليلية، ثم جرب cold start وwarm start وتغيير الثيم. انقل طلبات الشبكة غير الضرورية إلى ما بعد الواجهة الأولى مع حالة تحميل واضحة. احتفاظ النظام بشاشة البدء يجب أن يظل قصيرًا وله سبب، ولا تضف انتظارًا ثابتًا لمزامنة فيديو أو حركة. قِس وقت أول محتوى مفيد على جهاز فعلي.
مراحل فتح التطبيق
افصل بدء العملية وشاشة النظام وتهيئة Flutter وأول إطار ثم تحميل البيانات. قد تكون شاشة الشعار داخل Dart سريعة في debug ولا تعكس بدءًا باردًا بعد تثبيت release. صمم أول إطار بخلفية تتفق مع launch theme وبحالة يمكن استخدامها، ثم حمّل البيانات اللازمة تدريجيًا. لا تجعل SplashActivity إضافية هي الطريق الافتراضي إذا كان المطلوب فقط مطابقة لون وشعار؛ قد تزيد زمن الوصول وتضاعف شاشة البدء بدل إزالة المشكلة الأصلية.
موارد Android حسب الإصدار
راجع ملفات styles الموجودة قبل الإضافة، فقد يعرف القالب LaunchTheme وNormalTheme في أكثر من qualifier. موارد values-v31 تخص أنظمة تدعم خصائص شاشة البدء الجديدة، وموارد values الافتراضية تبقى مطلوبة لأجهزة أقدم. غيّر المورد الذي يستعمله manifest للـActivity الصحيحة، واحتفظ ببيانات Flutter embedding اللازمة. عند استعمال مولد مثل flutter_native_splash راجع مخرجاته ولا تجمع يدويًا إعدادين يطغى أحدهما على الآخر في كل تشغيل للأداة.
الشعار الثابت والرسوم المتحركة
شاشة النظام ليست حاوية Flutter عامة ولا تسمح بتكرار كل تصميم الصفحة الرئيسية. التزم بنوع الأصل والمقاسات التي توضحها واجهة Android، ولا تفترض أن ملف Lottie JSON يصلح مكان animated vector. إذا احتجت حركة تالية فحدد لها وظيفة وشرط انتهاء عند الجاهزية ولا تعرض المحتوى نفسه مرتين. اختبر إزالة مؤقت اصطناعي: إذا اختفى التقطع فقد كان الانتظار جزءًا من المشكلة، وليس تهيئة المحرك وحدها.
خطة قياس لا تعتمد على الانطباع
اختبر جهازين إن أمكن، وإصدارات قبل Android 12 وبعده، مع فتح بارد وفتح دافئ ودخول بإشعار أو رابط. سجل زمن أول إطار وزمن أول إجراء مفيد وأي صفحة وسيطة تظهر أثناء الفتح. جرّب الوضع الليلي لأن لونًا أبيض في ثيم launch قد يصنع ومضة حتى لو كانت Dart داكنة. افحص بطء قراءة تخزين أو اتصال شبكة في main دون تحميل بيانات مستخدم حقيقي في السجل. هذه الخطوات تجعل تعديل الثيم قرارًا يمكن قياسه ومراجعته بدل ضمان عام لكل جهاز.
مطابقة الخلفية في تجربة حقيقية
جرب أيقونة صغيرة وكبيرة وخلفية فاتحة وداكنة ثم صور الانتقال إطارًا بإطار إذا بدا التقطع غامضًا. قد تأتي الومضة من إطار Flutter الأول لا من LaunchTheme، لذلك افحص لون Scaffold والصفحة الأولية أيضًا. احتفظ بموارد fallback للأجهزة القديمة، ولا تجعل شاشة البدء تنفذ اتصالًا يعتمد على إذن لم يوافق المستخدم عليه بعد. جرّب التثبيت لأول مرة والعودة بعد إيقاف العملية لتغطية اختلاف حالة التخزين والجلسة.
مراجعة أخيرة للتطبيق
اختبر أيقونة النظام واسم النشاط ومورد الثيم في ملف البناء النهائي لا في معاينة المحرر فقط.
مثال الشفرة بعد المراجعة
اقرأ التعليقات ومتطلبات الإعداد قبل النقل إلى مشروعك. أمثلة الواجهات ذات main مستقلة، أما العقود والمقاطع الأصلية وملفات الإعداد فموضح نطاقها داخل المثال.
<!-- android/app/src/main/res/values-v31/styles.xml -->
<!-- Merge into existing resources; also review night resources. -->
<resources>
<style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
<item name="android:windowSplashScreenBackground">@android:color/white</item>
<item name="android:windowSplashScreenAnimatedIcon">@mipmap/ic_launcher</item>
</style>
</resources>
<!-- Keep the existing Flutter NormalTheme metadata and match the first frame.
This customizes system splash; it does not disable it. -->مرجع للتنفيذ
راجع التوثيق الخاص بهذا الموضوع وطابق إعداداته مع إصدار أدوات مشروعك. اختبر السلوك المستهدف وحالة الفشل قبل إدماج المثال في تطبيق منشور.






