حفظ الوضع الليلي في Flutter باستخدام SharedPreferencesAsync مع خيارات system وlight وdark، وقراءة الاختيار قبل التشغيل ومعالجة فشل القراءة والكتابة دون Cubit مجهول.
احفظ الاختيار لا المظهر الحالي
إذا اختار المستخدم System ثم كان نظامه داكنًا، فإن حفظ dark بناءً على Brightness الحالي يحول اختياره دون قصد إلى وضع ثابت. خزّن قيمة ThemeMode الأصلية مثل system أو light أو dark، وافصلها عن الثيم الفعلي الناتج. هذا المقال يكمل ما لم ينفذه المثال القديم: خدمة قراءة وكتابة فعلية داخل التطبيق التجريبي، دون الاعتماد على Cubit أو cacheHelper غير معرف. لا حاجة لحزمة hexcolor لأن تخزين اسم الوضع مستقل عن طريقة إنشاء الألوان.
واجهة تخزين محدودة
SharedPreferencesAsync من حزمة shared_preferences يتيح قراءة وكتابة قيم بسيطة عبر عمليات غير متزامنة. نستخدم مفتاحًا محددًا بإصدار بدل clear الذي قد يمحو إعدادات أخرى لا تخص الثيم. حزمة التفضيلات مناسبة لاختيار مظهر غير حرج، ولا تعد مخزنًا للأسرار أو ضمانًا لحفظ بيانات حرجة على القرص بعد عودة العملية. لا تخزن كلمة مرور أو token فيها لمجرد أن مثال الثيم يستعملها. راجع دعم المنصة والإصدار عند تثبيت الحزمة في مشروعك.
قراءة البداية والفشل
نهيئ WidgetsFlutterBinding ثم نقرأ الاختيار قبل runApp لتجنب عرض ثيم خاطئ ثم تبديله في هذا المثال. قد يؤخر ذلك أول إطار قليلًا، لذلك لا تضف إلى هذا المسار طلب شبكة أو معالجة طويلة بلا سبب. إذا فشلت القراءة نبدأ system ونظهر رسالة توضح ذلك، ولا نمسح المفتاح أو نفترض أن المستخدم اختار الفاتح. إذا كانت القيمة غير معروفة من إصدار أقدم أو تعديل خارجي نرجع إلى system وفق سياسة معلنة بدل رمي خطأ من byName دون معالجة.
الكتابة ومنع السباق
نمنع تغييرًا جديدًا أثناء حفظ الاختيار ونحدث الوضع المعروض بعد نجاح طلب الكتابة. بذلك لا تتنافس كتابتان من ضغط سريع لتتركا قيمة غير التي تظهر. عند الفشل يبقى الوضع السابق وتظهر رسالة واضحة ويمكن إعادة المحاولة. هذه سياسة بسيطة؛ يمكنك اختيار تحديث متفائل مع rollback في منتج آخر إذا عرفت عواقبه. لا تنفذ الكتابة داخل build، ولا تربط حفظ القيمة بتغيير الأيقونة في دالتين تقلبان bool مرتين فترجع الحالة إلى البداية.
خدمة قابلة للاختبار
ThemeStore يفصل عقد load وsave عن واجهة MaterialApp، وPrefsThemeStore يطبق التخزين الحقيقي. يمكن للاختبار تمرير خدمة وهمية لحالات النجاح والفشل دون تغيير إعدادات المستخدم، ثم اختبار محول الحزمة أيضًا بعقد منصتها الاختباري. هذا لا يعادل إعادة تشغيل تطبيق فعلي على كل جهاز؛ اختبر ذلك على Android وiOS والويب المستهدف. إذا استعمل التطبيق عدة engines أو أكوادًا أصلية تغير التفضيلات فراجع اختيار الواجهة وسياسة التزامن، ولا تضف cache يدويًا ينسى تحديث القيم.
خطة المراجعة
اختر dark ثم أعد تشغيل التطبيق على الجهاز المستهدف وتأكد من استعادة الاختيار، ثم كرر مع system وغيّر سطوع النظام. اختبر قيمة مخزنة مجهولة وفشل القراءة وفشل الكتابة والضغط السريع، وتأكد من بقاء إعدادات أخرى دون مسح. المثال يخزن تفضيلًا محليًا ولا يزامنه بين حسابات أو أجهزة، وقد يزول مع حذف بيانات التطبيق أو سياسات المتصفح. وصف الحفظ يجب أن يذكر هذه الحدود، ولا تعد بأن نجاح setter يضمن بقاء البيانات في كل حالة توقف أو عطل مفاجئ.
تثبيت الحزمة
شغّل flutter pub add shared_preferences داخل مشروع التجربة. اختُبر المثال مع shared_preferences 2.5.6؛ راجع توافق SDK ودعم منصات مشروعك قبل دمجه.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يحتاج حزمة shared_preferences كما في الإعداد أعلاه، ولا يعتمد assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';
abstract interface class ThemeStore {
Future<ThemeMode> load();
Future<void> save(ThemeMode mode);
}
ThemeMode parseThemeMode(String? value) => switch (value) {
'light' => ThemeMode.light,
'dark' => ThemeMode.dark,
_ => ThemeMode.system,
};
class PrefsThemeStore implements ThemeStore {
PrefsThemeStore({SharedPreferencesAsync? prefs}) : _prefs = prefs ?? SharedPreferencesAsync();
final SharedPreferencesAsync _prefs;
static const key = 'theme_mode_v1';
@override
Future<ThemeMode> load() async => parseThemeMode(await _prefs.getString(key));
@override
Future<void> save(ThemeMode mode) => _prefs.setString(key, mode.name);
}
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
final store = PrefsThemeStore();
var mode = ThemeMode.system;
var failed = false;
try { mode = await store.load(); } catch (_) { failed = true; }
runApp(DemoApp(store: store, initialMode: mode, loadFailed: failed));
}
class DemoApp extends StatefulWidget {
const DemoApp({super.key, required this.store, required this.initialMode, this.loadFailed = false});
final ThemeStore store;
final ThemeMode initialMode;
final bool loadFailed;
@override
State<DemoApp> createState() => _DemoAppState();
}
class _DemoAppState extends State<DemoApp> {
late ThemeMode _mode;
late String _status;
bool _saving = false;
@override
void initState() {
super.initState(); _mode = widget.initialMode;
_status = widget.loadFailed ? 'Could not load preference; using system' : 'Ready';
}
Future<void> _select(ThemeMode mode) async {
if (_saving) return;
setState(() { _saving = true; });
try {
await widget.store.save(mode);
if (!mounted) return;
setState(() { _mode = mode; _status = 'Preference write completed'; });
} catch (_) {
if (mounted) setState(() { _status = 'Could not save; previous mode kept'; });
} finally {
if (mounted) setState(() { _saving = false; });
}
}
@override
Widget build(BuildContext context) => MaterialApp(
theme: ThemeData(colorScheme: ColorScheme.fromSeed(seedColor: Colors.teal)),
darkTheme: ThemeData(colorScheme: ColorScheme.fromSeed(seedColor: Colors.teal, brightness: Brightness.dark)),
themeMode: _mode,
home: Scaffold(appBar: AppBar(title: const Text('Saved theme preference')),
body: ListView(padding: const EdgeInsets.all(16), children: [
Text('Selected: ${_mode.name}'), Text(_status),
const SizedBox(height: 16),
Wrap(spacing: 8, runSpacing: 8, children: [
for (final mode in ThemeMode.values)
OutlinedButton(onPressed: _saving ? null : () => _select(mode), child: Text(mode.name)),
]),
])),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.
الفرق عن مظهر تطبيق الأخبار
هذا الدرس يدعم ThemeMode.system إلى جانب الفاتح والداكن، بينما درس تطبيق الأخبار المرتبط يستخدم bool للتبديل الثنائي. اختر نموذجًا واحدًا واضحًا داخل تطبيقك ولا تجمع مفتاحين يتحكمان في المظهر نفسه. راجع ترحيل مفتاح SharedPreferences القديم إذا انتقلت إلى SharedPreferencesAsync، وأبقِ إعداد المظهر خارج بيانات الحساب التي تمسح عند الخروج إن كان اختيارًا يخص الجهاز.
لإكمال هذا الجزء، انتقل إلى حفظ تبديل الوضع الداكن في تطبيق الأخبار باستخدام Flutter وCubit، ثم طبّق الربط الذي يناسب بنية مشروعك.






