شرح تحديث حالة المهام باستخدام Cubit وSQLite في Flutter: الإكمال والأرشفة والحذف، ومشاركة مصدر بيانات واحد وإعادة تحميل القوائم بعد نجاح التعديل.
مشاركة البيانات لا تعني نسخ القائمة
تحديث حالة المهام باستخدام Cubit يحتاج أن تقرأ الصفحات من مصدر حقيقة واحد. إنشاء ثلاث قوائم قابلة للتعديل في كل شاشة ثم محاولة تحديثها يدويًا قد يترك عناصر مكررة أو قديمة. في هذا الدرس تخزن SQLite حالة المهمة ويعيد TodoCubit قراءة اللقطة بعد التعديل. تشتق كل صفحة قائمتها بحسب TaskStatus بدل امتلاك نسخة مستقلة غير مرتبطة بالسجل الأصلي.
ابدأ بمستودع الإضافة والقراءة
يعتمد المثال على الملفات المشتركة الموضحة هنا وعلى تهيئة Todo App لفتح القاعدة وتوفير Cubit. لا تُنشئ قاعدة أخرى لكل صفحة، ولا تستخدم متغير database غير مهيأ قبل اكتمال openDatabase. الملفات المتكررة في الشرح هي ملفات المشروع نفسها وليست دعوة لإنشاء كلاس Task أو TodoCubit مرتين. احفظ كل ملف باسمه مرة واحدة واستورده من الشاشات التي تحتاجه.
حالات typed وقيم قاعدة معروفة
تعرف TaskStatus القيم active وdone وarchived، وتكتبها العمليات باستخدام name بدل نصوص مبعثرة بأخطاء إملائية. يفرض الجدول قيدًا على القيم المقبولة، ويحول النموذج الحالة المقروءة إلى enum. لا تفسر كل قيمة غير active أوdone على أنها أرشيف تلقائيًا، لأن صفًا تالفًا أو قيمة قديمة قد تحتاج ترحيلًا أو خطأ واضحًا بدل إخفاء المشكلة.
التعديل بواسطة المعرف لا الفهرس
تستخدم changeStatus معرف المهمة وwhereArgs لتحديث صف واحد، وتتحقق أن عدد الصفوف المتأثرة واحد. فهرس العنصر في ListView ليس معرفًا دائمًا؛ قد يتغير بعد الفرز أو الحذف أو الانتقال لتبويب آخر. عند فشل العثور على المهمة يعرض Cubit خطأ ويحافظ على اللقطة السابقة بدل حذفها من الواجهة وكأن التعديل نجح. يمكن بعدها إعادة تحميل البيانات وفق تصميم التطبيق.
إعادة التحميل بعد نجاح الكتابة
تنتظر العملية اكتمال كتابة SQLite ثم تقرأ all لإصدار حالة جديدة. هذا يبقي التبويبات متفقة على السجل نفسه، ويجنب استدعاء emit لنجاح التعديل قبل اكتماله. أثناء loading تتعطل الأزرار في المثال لتقليل العمليات المتداخلة. إذا طلبت الأداء المتفائل، حدّد كيف ستستعيد العنصر عند الفشل وكيف تتعامل مع تعديل آخر وصل في الفترة نفسها.
الإكمال والأرشفة والحذف ليست عملية واحدة
الإكمال يغير حالة المهمة، والأرشفة تبقي السجل لكن تنقله لتصنيف مختلف، أما remove فيحذف الصف. في منتج فعلي قد تحتاج تأكيدًا مناسبًا أو خيار تراجع أو حذفًا منطقيًا بدل الحذف النهائي؛ اختر السياسة حسب أهمية البيانات. الكود يوضح عمليات المستودع ولا يقرر نيابة عنك سياسة استرجاع مهام المستخدم. اختبر كل عملية على قاعدة تجريبية قبل نقلها لتطبيق قائم.
ربط الشاشات بنطاق واحد
يمكن عرض TaskStatusList(status:…) لكل قسم تحت TodoCubit واحد، مع NavigationBar أو تبويبات مناسبة. لا تسجل Cubit جديدًا داخل كل قائمة إن كنت تريد مشاركة الحالة بين الصفحات. يوضح MultiBlocProvider توفير أنواع حالة أخرى بجواره، لكنه ليس سببًا لإنشاء نسخ متعددة من النوع نفسه دون تصور لنطاقها. حافظ على مالك واضح للقاعدة والمتحكمات والاشتراكات.
اختبار الحركة بين القوائم
أضف مهمة ثم أكملها وتأكد أنها تغادر قسم النشط وتظهر في المكتمل، ثم أرشفها واحذفها وفق سياسة التجربة. اختبر معرفًا غير موجود وفشل قاعدة البيانات والضغط المتكرر أثناء التحميل. تأكد أن حالة الخطأ لا تُفقد البيانات المعروضة وأن نجاح العملية التالية يمسح رسالة الخطأ السابقة. ظهور العنصر في شاشة واحدة لا يكفي إذا بقيت نسخة قديمة منه في شاشة أخرى.
الإعداد أو عقد التكامل المطلوب
طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.
flutter pub add flutter_bloc sqflite pathالملف المشترك: task_store.dart
احفظ هذا الملف مرة واحدة داخل مجلد lib، واستورده من المثال التالي. لا تجمع تعريفات الملفات في ملف واحد بتكرار الكلاسات.
import 'package:path/path.dart' as paths;
import 'package:sqflite/sqflite.dart';
enum TaskStatus { active, done, archived }
class Task {
const Task(this.id,this.title,this.status);
final int id;
final String title;
final TaskStatus status;
factory Task.fromMap(Map<String,Object?> row)=>Task(
row['id'] as int,row['title'] as String,
TaskStatus.values.byName(row['status'] as String));
}
Future<Database> openTasksDatabase({DatabaseFactory? factory,String? databasePath}) async {
final f=factory??databaseFactory;
final path=databasePath??paths.join(await f.getDatabasesPath(),'geecoders_tasks.db');
return f.openDatabase(path,options:OpenDatabaseOptions(version:1,
onCreate:(db,version)async{
await db.execute("CREATE TABLE tasks(id INTEGER PRIMARY KEY AUTOINCREMENT, "
"title TEXT NOT NULL, status TEXT NOT NULL CHECK(status IN ('active','done','archived')))");
}));
}
class SqliteTaskStore {
SqliteTaskStore(this.database);
final Database database;
Future<List<Task>> all()async=>(await database.query('tasks',orderBy:'id DESC'))
.map(Task.fromMap).toList(growable:false);
Future<int> add(String title) {
final value=title.trim();
if(value.isEmpty)throw ArgumentError('Task title is required');
return database.insert('tasks',{'title':value,'status':TaskStatus.active.name});
}
Future<void> changeStatus(int id,TaskStatus status)async{
final count=await database.update('tasks',{'status':status.name},where:'id = ?',whereArgs:[id]);
if(count!=1)throw StateError('Task not found');
}
Future<void> remove(int id)async{
final count=await database.delete('tasks',where:'id = ?',whereArgs:[id]);
if(count!=1)throw StateError('Task not found');
}
}
الملف المشترك: todo_cubit.dart
احفظ هذا الملف مرة واحدة داخل مجلد lib، واستورده من المثال التالي. لا تجمع تعريفات الملفات في ملف واحد بتكرار الكلاسات.
import 'package:flutter_bloc/flutter_bloc.dart';
import 'task_store.dart';
class TodoState {
TodoState({Iterable<Task> tasks=const [],this.loading=false,this.error}):tasks=List.unmodifiable(tasks);
final List<Task> tasks;
final bool loading;
final String? error;
List<Task> matching(TaskStatus status)=>tasks.where((t)=>t.status==status).toList(growable:false);
}
class TodoCubit extends Cubit<TodoState> {
TodoCubit(this.store):super(TodoState());
final SqliteTaskStore store;
bool busy=false;
Future<void> _run(Future<void> Function() operation)async{
if(busy || isClosed)return;
busy=true;emit(TodoState(tasks:state.tasks,loading:true));
try{
await operation();final tasks=await store.all();
if(!isClosed)emit(TodoState(tasks:tasks));
}catch(_){if(!isClosed)emit(TodoState(tasks:state.tasks,error:'تعذر حفظ أو تحميل المهام'));}
finally{busy=false;}
}
Future<void> refresh()=>_run(()async{});
Future<void> add(String title)=>_run(()async{await store.add(title);});
Future<void> changeStatus(int id,TaskStatus status)=>_run(()=>store.changeStatus(id,status));
Future<void> remove(int id)=>_run(()=>store.remove(id));
}
المثال التطبيقي المراجع
احفظ المثال في ملف مستقل داخل مشروع تجريبي مع الحزم المذكورة. يوضح الكود نطاق الدرس؛ أضف إعدادات مشروعك واختبر المنصة المستهدفة قبل الاعتماد عليه في تطبيق قائم.
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'task_store.dart';
import 'todo_cubit.dart';
class TaskStatusList extends StatelessWidget {
const TaskStatusList({super.key,required this.status});
final TaskStatus status;
@override
Widget build(BuildContext context)=>BlocBuilder<TodoCubit,TodoState>(builder:(context,state){
final tasks=state.matching(status);
return Column(children:[
if(state.loading)const LinearProgressIndicator(),
if(state.error!=null)Text(state.error!),
Expanded(child:ListView(children:[for(final task in tasks)ListTile(
key:ValueKey(task.id),title:Text(task.title),trailing:Row(mainAxisSize:MainAxisSize.min,children:[
IconButton(tooltip:'إكمال',onPressed:state.loading?null:()=>context.read<TodoCubit>()
.changeStatus(task.id,TaskStatus.done),icon:const Icon(Icons.done)),
IconButton(tooltip:'أرشفة',onPressed:state.loading?null:()=>context.read<TodoCubit>()
.changeStatus(task.id,TaskStatus.archived),icon:const Icon(Icons.archive)),
IconButton(tooltip:'حذف',onPressed:state.loading?null:()=>context.read<TodoCubit>()
.remove(task.id),icon:const Icon(Icons.delete)),
])),])),
]);
});
}
مراجع التنفيذ الرسمية
تكامل حالات المهام مع الحذف
تغيير الحالة إلى archived لا يحذف الصف، بينما remove يزيله من قاعدة البيانات. عرّف هذا الفرق في واجهة المستخدم حتى لا يُفهم زر الأرشفة على أنه مسح دائم. إذا أضفت Dismissible فاستخدم معرف المهمة وانتظر نجاح التخزين ثم أزلها من القائمة المعروضة. عند تبديل التبويب اعرض تصفية المصدر نفسه بدل إنشاء نسخة قاعدة مستقلة لكل حالة.
لإكمال هذا الجزء، انتقل إلى Todo App في Flutter باستخدام Cubit وSQLite: إضافة وعرض المهام، ثم طبّق الربط الذي يناسب بنية مشروعك.






