إخفاء شريط DEBUG في Flutter باستخدام debugShowCheckedModeBanner، مع التمييز بين العلامة البصرية وأوضاع debug وprofile وrelease وفحص التطبيق قبل النشر.
ما الذي تغيره الخاصية؟
debugShowCheckedModeBanner تتحكم في إظهار علامة checked-mode التي يضيفها تطبيق Flutter في وضع التطوير. اجعلها false داخل MaterialApp إذا أردت لقطة أو تجربة واجهة دون الشريط. هذا لا يحول البناء إلى release ولا يلغي asserts ولا يغير إعدادات التوقيع أو صلاحيات التطبيق. لا تستنتج من غياب كلمة DEBUG أن التطبيق جاهز للنشر أو أنه لا يحتوي أدوات تشخيص أخرى. الخاصية تتعامل مع عنصر بصري محدد، وليست مفتاح تحسين أمان أو أداء عام.
المكان الصحيح للإعداد
ضع الخاصية على MaterialApp أو CupertinoApp المناسب، لا داخل ThemeData أو Scaffold أو build خاص ببطاقة. إذا كانت لديك أكثر من نقطة تشغيل أو flavor فراجع التطبيق الفعلي الذي تشغله، لأن تعديل ملف main غير المستخدم لن يغير النتيجة. المثال يتيح إظهار العلامة وإخفاءها بتغيير حالة الجذر، ويعرض وضع البناء من ثوابت foundation. في مشروع عادي قد يكفي ضبط ثابت false؛ الزر هنا لتوضيح الفرق واختباره فقط.
debug وprofile وrelease
أوضاع التشغيل تحدد أدوات وتشخيصات وتحسينات مختلفة. debug مناسب للتطوير، وprofile لقياس الأداء في سياق مناسب، وrelease لاختبار نسخة التسليم. استخدام flutter run –release أو بناء حزمة release مسألة منفصلة عن إخفاء الشريط، مع مراعاة المنصات والأجهزة المدعومة. لا تقارن زمن debug بزمن release ثم تنسب الفرق إلى الخاصية البصرية. عند تقييم البطء استخدم أدوات قياس وبيانات تمثل المنتج بدل مراقبة وجود الشريط في زاوية الشاشة.
أشياء لا تختفي معها
إخفاء العلامة لا يزيل تلقائيًا سجلات print أو رسائل خطأ واجهتك أو صفحة اختبار تركتها في التطبيق. راجع ما تعرضه للمستخدم وما تسجله، ومفاتيح الخدمة والإعدادات وواجهات الشبكة والتوقيع وفق متطلبات النشر الحقيقية. لا تحذف معالجة الأخطاء أو تعطل تقاريرها كي تبدو لقطة الشاشة نظيفة. وكذلك لا تعدل إعداد نظام التشغيل أو ملف الاستضافة لحل شريط خاص بتطبيق Flutter؛ حدد أولًا مصدر العلامة التي تراها.
واجهات أخرى ومسارات التشغيل
في تطبيقات واختبارات خاصة قد يبنى WidgetsApp أو تطبيق متداخل بطريقة مختلفة. راجع مالك العلامة بدل إضافة MaterialApp جديد داخل كل صفحة لإخفائها، فذلك قد يضيف Navigator وثيمًا ونطاقات أخرى بلا حاجة. إذا كنت تستخدم Router أو حزمة توجيه فالإعداد يبقى في جذر التطبيق المناسب، مع مراجعة constructor المستخدم. لا تنس أن اسم package أو أيقونة app وlaunch screen عناصر أخرى لا تغيرها هذه الخاصية، حتى لو ظهرت جميعها أثناء تجربة التطوير.
قائمة فحص مفيدة
اختبر المثال في debug مع الخاصية true ثم false وراجع أن عنصر checked-mode يتبعها. تحقق من أن نص Build mode لا يتحول إلى release لمجرد إخفائها. بعد ذلك جرّب بناء التسليم على جهاز مستهدف وفق سير مشروعك وافحص البدء والتنقل والأخطاء والشبكة، دون افتراض أن لقطة خالية من الشريط دليل جودة كامل. المثال لا ينفذ بناء release أو يوقع التطبيق أو يرفعه إلى متجر؛ هو شرح قابل للتجربة لإعداد واجهة واحد وحدود أثره حتى لا تختلط الخطوات.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
void main() => runApp(const DemoApp());
class DemoApp extends StatefulWidget {
const DemoApp({super.key});
@override
State<DemoApp> createState() => _DemoAppState();
}
class _DemoAppState extends State<DemoApp> {
bool _showBanner = false;
@override
Widget build(BuildContext context) => MaterialApp(
debugShowCheckedModeBanner: _showBanner,
home: Scaffold(appBar: AppBar(title: const Text('Debug banner setting')),
body: ListView(padding: const EdgeInsets.all(16), children: [
const Text(kDebugMode ? 'Build mode: debug' : kProfileMode ? 'Build mode: profile' : 'Build mode: release'),
SwitchListTile(title: const Text('Show checked-mode banner'), value: _showBanner,
onChanged: (value) => setState(() { _showBanner = value; })),
const Text('Hiding this banner does not change the build mode.'),
])),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.






