إنشاء حساب وتسجيل الدخول في Flutter باستخدام Firebase Auth وحفظ ملف المستخدم في Firestore دون تخزين كلمة المرور، مع معالجة فشل الكتابة والجلسة.
حساب المصادقة وملف المستخدم شيئان مختلفان
createUserWithEmailAndPassword تنشئ حساب Firebase Authentication، أما users/{uid} في Firestore فيحوي بيانات الملف التي يختار تطبيقك حفظها. لا تخزن password أو confirmPassword داخل المستند أو CacheHelper؛ تتولى خدمة المصادقة التعامل مع كلمة المرور. استخدم UID كمعرف الملف لتسهيل الربط، وافصل الحقول العامة عن البريد والهاتف والحقول الخاصة التي لا يجوز أن يقرأها كل مستخدم.
التحقق قبل الطلب ومتابعة الجلسة
استخدم Form للتحقق من الإدخال ومطابقة تأكيد كلمة المرور، واعرض كلمة المرور مخفية دون تسجيلها في logs. امنع النقر المتكرر أثناء انتظار الطلب، واستخدم authStateChanges لمتابعة الدخول والخروج بدل الثقة بمعرف مخزن محليًا وحده. لا تعتمد على زر الواجهة كحماية؛ قواعد Firestore تتحقق من request.auth.uid ومن الحقول المسموح كتابتها. عالج أخطاء المصادقة برسائل مناسبة دون كشف معلومات حسابات الآخرين.
فشل خطوة حفظ الملف
نجاح إنشاء الحساب وفشل Firestore يعني أن الحساب قد أصبح موجودًا فعلًا. لا تطلب من المستخدم التسجيل مرة ثانية وكأن العملية كلها لم تنفذ، ولا تحذف الحساب تلقائيًا دون سياسة واضحة. وفر مسار استكمال ملف بعد الدخول أو خدمة خلفية موثوقة لإنشائه. المثال يعزل الدالتين حتى يمكن عرض حالة الحساب والملف كلًا على حدة. يجب أن ترفض القواعد انتحال UID أو إضافة دور إداري يختاره العميل.
الدخول والتحقق من البريد
signInWithEmailAndPassword تعيد جلسة مستخدم عند النجاح، ويمكن إرسال بريد تحقق حسب متطلبات المنتج. مجرد حفظ emailVerified في بيانات محلية لا يوفر تحققًا موثوقًا؛ راجع حالة المستخدم والسياسات المطلوبة للخدمات الحساسة. تسجيل الدخول لا يثبت اكتمال الملف، لذلك افحص المستند وتعامل مع غيابه دون استخدام data()! بالقوة. إذا فتحت شاشة بعد await داخل Widget، تحقق من بقاء mounted قبل التنقل.
اختبار تدفق الحساب
جرب بريدًا غير صالح وكلمة مرور مرفوضة وحسابًا قائمًا ورفض قواعد الملف وانقطاع الشبكة بعد إنشاء الحساب. اختبر الخروج ثم دخول حساب آخر وتأكد من تفريغ بيانات الحساب السابق. لا تضف Storage ورفع صورة إجباريًا إلى أول تجربة تسجيل إذا كان الهدف فهم المصادقة؛ يمكن إكمال الصورة بعد نجاح الحساب. المثال منطق خدمة مستقل بدل الاعتماد على Cubit وWidgets غير مرفقة قد تمنع القارئ من تشغيل الجزء الأساسي.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'package:firebase_auth/firebase_auth.dart';
import 'package:cloud_firestore/cloud_firestore.dart';
Future<UserCredential> createEmailAccount(String email, String password) =>
FirebaseAuth.instance.createUserWithEmailAndPassword(email: email.trim(), password: password);
Future<void> saveOwnProfile(String displayName) async {
final user = FirebaseAuth.instance.currentUser;
if (user == null) throw StateError('Sign in first');
await FirebaseFirestore.instance.collection('users').doc(user.uid).set({
'displayName': displayName.trim(),
}, SetOptions(merge: true));
}
Future<UserCredential> signInWithEmail(String email, String password) =>
FirebaseAuth.instance.signInWithEmailAndPassword(email: email.trim(), password: password);الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.










