حفظ Model في SharedPreferences في Flutter لا يعني تخزين كائن Dart مباشرة. خزّن تمثيل JSON نصيًا ثم أعد بناء النموذج بعد التحقق من بنيته. هذه الطريقة مناسبة لملف شخصي بسيط أو إعداد صغير، وليست بديلًا عن قاعدة بيانات للآلاف من السجلات أو وسيلة لحماية كلمة المرور.
نموذج واضح وإصدار للتخزين
نستخدم SharedPreferencesAsync من shared_preferences 2.5.6 بدل helper عام يقبل dynamic ويحوّل كل نوع غير معروف إلى double. يحتوي الغلاف على schema، حتى تستطيع رفض بيانات قديمة أو ترحيلها عند تغيير شكل النموذج. حقول النموذج وأنواعها هنا عقد صريح، لا تخمين من النص الموجود في التخزين.
import 'dart:convert';
import 'package:shared_preferences/shared_preferences.dart';
class UserProfile {
const UserProfile(this.name, this.age);
final String name;
final int age;
Map<String, Object> toJson() => {'name': name, 'age': age};
static UserProfile fromJson(Map<String, dynamic> json) {
final name = json['name'];
final age = json['age'];
if (name is! String || age is! int || age < 0) {
throw const FormatException('Invalid profile');
}
return UserProfile(name, age);
}
}
class ProfileStore {
ProfileStore(this.prefs);
final SharedPreferencesAsync prefs;
static const key = 'profile_v1';
Future<void> save(UserProfile profile) => prefs.setString(
key, jsonEncode({'schema': 1, 'profile': profile.toJson()}));
Future<UserProfile?> read() async {
final raw = await prefs.getString(key);
if (raw == null) return null;
try {
final value = jsonDecode(raw);
if (value is! Map<String, dynamic> || value['schema'] != 1) return null;
final profile = value['profile'];
if (profile is! Map<String, dynamic>) return null;
return UserProfile.fromJson(profile);
} on FormatException {
return null;
}
}
}
class NamesStore {
NamesStore(this.prefs);
final SharedPreferencesAsync prefs;
static const key = 'saved_names_v1';
Future<void> save(List<String> names) => prefs.setStringList(key, names);
Future<List<String>> read() async => await prefs.getStringList(key) ?? [];
Future<void> remove() => prefs.remove(key);
}
الحفظ والقراءة من الواجهة
أنشئ ProfileStore(SharedPreferencesAsync())، ثم انتظر save مع UserProfile صالح. عند القراءة قد ترجع read قيمة null إذا لم توجد بيانات أو لم تتوافق مع المخطط. تعامل معها كحالة تحتاج إنشاء ملف أو إعادة تحميله، ولا تستخدم users[2] دون التحقق من طول القائمة إذا وسّعت المثال إلى مجموعة نماذج.
الكود يتضمن NamesStore للمقارنة: القائمة النصية البسيطة لها setStringList مخصصة، بينما النموذج ذو حقول متعددة يحتاج JSON. لا تستخدم split للفصل بين عناصر JSON؛ فقد يحتوي الاسم على فاصلة أو علامات اقتباس أو نص عربي متعدد الكلمات، وجميعها بيانات صحيحة يجب أن تبقى كما هي.
حدود SharedPreferences والترحيل
هذه الحزمة للتفضيلات البسيطة، ولا تعتمد عليها وحدها لحفظ بيانات حرجة يجب ضمان دوامها. انتظار العملية ينظم التسلسل في برنامجك، لكنه لا يحول التفضيلات إلى قاعدة بيانات معاملات. إذا كانت لديك علاقات أو عمليات بحث أو تحديثات متزامنة فاختر SQLite أو مخزنًا مناسبًا.
SharedPreferencesAsync وواجهة SharedPreferences القديمة لا تتطابقان في التخزين والإعدادات في كل منصة؛ إضافة مفاتيح جديدة لا ترحّل القديمة تلقائيًا. عند تحديث تطبيق منشور، افحص backend المستخدم وخطّط لنقل المفاتيح قبل إزالة النسخة السابقة. افصل بيانات كل حساب وامسحها وفق سياسة تسجيل الخروج دون حذف إعدادات واجهة لا تخصه.
اختبار البيانات غير المتوقعة
اختبر غياب المفتاح، وJSON غير صالح، وإصدار مخطط مختلف، وعمرًا من نوع نص بدل int، واسمًا يحتوي على فاصلة أو اقتباس. لا تحوّل كل استثناء تخزين إلى ملف فارغ بصمت؛ المثال يميز أخطاء البنية المتوقعة، بينما فشل المنصة في القراءة يمر للمستدعي ليعرض حالة مناسبة. تجنب طباعة محتوى الملف أو الرموز الحساسة في سجلات الإنتاج.
مراجع التنفيذ
لإكمال هذا الجزء، انتقل إلى حفظ List String في SharedPreferences دون تقسيم JSON بالفواصل، ثم طبّق الربط الذي يناسب بنية مشروعك.








