تسجيل الدخول برقم الهاتف في Flutter باستخدام Firebase OTP، ومعالجة codeSent والتحقق التلقائي والإرسال المتكرر واختلاف مسار الويب.
تجهيز الخدمة قبل شاشة الرمز
فعّل Phone provider في Firebase Authentication وراجع إعداد المنصات والبلدان والحصص والفوترة وفق حسابك قبل الاختبار. أدخل الرقم بالصيغة الدولية، ولا تفترض أن أي رقم محلي صالح كما هو. اختبار Android وiOS يحتاج إعداد التحقق الخاص بكل منصة، أما الويب فله مسار signInWithPhoneNumber وتحقق reCAPTCHA مختلف. استخدم أرقام الاختبار المعتمدة أثناء التطوير لتجنب إرسال رسائل فعلية متكررة دون حاجة.
وظيفة callbacks الأربعة
verifyPhoneNumber على المنصات الأصلية يبلغك بالفشل وبإرسال الرمز وبانتهاء فترة الالتقاط التلقائي، وقد يكمل التحقق تلقائيًا على Android. codeSent لا يعني أن الدخول نجح؛ خزّن verificationId مؤقتًا لربطه بالرمز الذي يدخله المستخدم. انتهاء auto-retrieval لا يساوي دائمًا بطلان إمكانية إدخال الرمز يدويًا. لا تستخدم معرفًا عامًا غير مهيأ بدل verificationId القادم من callback.
الرمز المؤقت ليس كلمة مرور قابلة للحفظ
بعد إدخال الرمز أنشئ PhoneAuthCredential ثم استخدم signInWithCredential، وأظهر النجاح بعد اكتمال Future. لا تطبع smsCode أو verificationId في السجلات ولا تخزنهما في Firestore. تعامل مع رمز غير صالح وانتهاء الجلسة وتجاوز الحصة ورفض التحقق برسائل مفهومة. وفر مهلة لزر إعادة الإرسال، ولا تسمح بالنقر المتكرر الذي يرسل عدة رسائل ويخلط معرفات المحاولات.
منع التنقل مرتين واختبار الحالات
قد يتزامن مسار التحقق التلقائي مع إدخال المستخدم، لذلك اجعل انتقال النجاح عملية واحدة مرتبطة بحالة الخدمة. لا تنفذ setState بعد إغلاق الشاشة، وألغِ المؤقتات المرتبطة بها. جرب رقم اختبار صحيحًا ورمزًا خاطئًا وإعادة إرسال وانقطاع شبكة وعودة التطبيق من الخلفية. المقطع التالي يوضح إتمام الرمز فقط؛ يلزم قبله تنفيذ verifyPhoneNumber ومعالجة callbacks وفق واجهة مشروعك.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'package:firebase_auth/firebase_auth.dart';
Future<UserCredential> completePhoneSignIn({
required String verificationId,
required String smsCode,
}) {
final credential = PhoneAuthProvider.credential(
verificationId: verificationId,
smsCode: smsCode.trim(),
);
return FirebaseAuth.instance.signInWithCredential(credential);
}الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.








