إنشاء قاعدة بيانات SQLite في Flutter يبدأ بتحديد المخطط ووقت التهيئة، ثم انتظار فتح القاعدة قبل تنفيذ أي استعلام. نستخدم sqflite 2.4.5 وpath، ولا نضع إنشاء الجدول في build. Null Safety تساعد على التعبير عن القيم التي قد تغيب، لكنها لا تزيد سرعة قاعدة البيانات تلقائيًا ولا تعوّض انتظار العمليات غير المتزامنة.
تثبيت الحزم وتحديد مخطط واحد
نفذ flutter pub add sqflite path. المثال التالي يستخدم جدول tasks بعمود id مولد تلقائيًا، وعنوان وتاريخ ووقت وحالة. تتشارك دروس الإضافة والقراءة والحذف هذا المخطط؛ تغيير أسماء الأعمدة في درس واحد دون البقية يؤدي إلى أخطاء وقت التشغيل. SQLite محلية ولا توفر مزامنة خادم أو تشفيرًا تلقائيًا.
import 'package:path/path.dart' as paths;
import 'package:sqflite/sqflite.dart';
Future<Database> openNotes({DatabaseFactory? factory, String? path}) async {
final f = factory ?? databaseFactory;
final file = path ?? paths.join(await f.getDatabasesPath(), 'notes_v1.db');
return f.openDatabase(file, options: OpenDatabaseOptions(
version: 1,
onCreate: (db, version) async {
await db.execute('CREATE TABLE tasks('
'id INTEGER PRIMARY KEY AUTOINCREMENT, '
'title TEXT NOT NULL, date TEXT NOT NULL, '
'time TEXT NOT NULL, status TEXT NOT NULL)');
},
));
}
Future<int> addTask(Database db, String title, String date, String time) {
final text = title.trim();
if (text.isEmpty) throw ArgumentError('Empty title');
return db.insert('tasks', {
'title': text, 'date': date, 'time': time, 'status': 'active',
});
}
Future<List<Map<String, Object?>>> readTasks(Database db) =>
db.query('tasks', orderBy: 'id DESC');
Future<int> removeTask(Database db, int id) =>
db.delete('tasks', where: 'id = ?', whereArgs: [id]);
انتظار إنشاء الجدول قبل الاستخدام
الدالة onCreate غير متزامنة وتنتظر execute. لا تكتب then داخل callback لا يعيد Future، لأن فتح القاعدة قد ينتهي قبل اكتمال منطق التهيئة المقصود. تحتفظ طبقة Repository بمرجع Database وتحقنه في الخدمات؛ لا تفتح القاعدة من جديد عند كل رسم لعنصر في القائمة.
في شاشة البداية يمكن حفظ Future<Database> في initState وعرض حالة تحميل ثم خطأ أو المحتوى. initState نفسها لا تصبح async؛ استدعِ دالة تعيد Future أو خزّنها في متغير. لا تستخدم late دون ضمان التهيئة، ولا تمرر database! إلى شاشة قد تسبق اكتمال الفتح.
ترقية قاعدة بيانات موجودة
تغيير CREATE TABLE لا يغير جدولًا سبق إنشاؤه. عند تعديل مخطط تطبيق منشور، ارفع version وأضف onUpgrade ينفذ الترحيل المناسب، مع اختبار الترقية من كل إصدار تدعمه. حذف القاعدة لإصلاح خطأ عمود ليس حلًا مقبولًا لبيانات المستخدم؛ احفظ نسخة واختبر الترحيل بدل فقدها.
ملكية الاتصال والاختبارات
الجهة التي تفتح قاعدة البيانات هي المسؤولة عن إغلاقها بعد انتهاء المستهلكين. لا تغلق اتصالًا مشتركًا عند إغلاق بطاقة واحدة. المثال يقبل DatabaseFactory ومسارًا للاختبار، مما يسمح بتجربة مخطط فعلي في الذاكرة باستخدام sqflite_common_ffi. اختبر فتح قاعدة جديدة وإعادة فتحها وإضافة عنوان يحتوي على اقتباس وقراءة جدول فارغ قبل بناء الواجهة النهائية.
مراجع التنفيذ
لإكمال هذا الجزء، انتقل إلى إضافة بيانات إلى SQLite في Flutter باستخدام معاملات آمنة، ثم طبّق الربط الذي يناسب بنية مشروعك.






