شارك المقالة
Google Sign In في Flutter مع Firebase وإعداد SHA-1 وSHA-256

Google Sign In في Flutter مع Firebase وإعداد SHA-1 وSHA-256

إعداد Google Sign In في Flutter مع Firebase، وفهم بصمات Debug وPlay App Signing ومعالجة الإلغاء واختلاف تسجيل الدخول على…

إعداد Google Sign In في Flutter مع Firebase، وفهم بصمات Debug وPlay App Signing ومعالجة الإلغاء واختلاف تسجيل الدخول على الويب.

تهيئة Firebase ومزود Google

أضف firebase_core وfirebase_auth وgoogle_sign_in بإصدارات متوافقة، ثم نفذ FlutterFire configure وهيئ Firebase قبل استدعاء المصادقة. فعّل مزود Google في Firebase Authentication وتأكد من تطابق تعريف Android وBundle ID في iOS. على Apple راجع إعداد URL scheme الخاص بمعرف عميل Google وفق دليل الحزمة؛ لا يكفي نسخ اسم المشروع إلى Info.plist. على الويب اضبط النطاقات المسموح بها واستخدم مسار المصادقة الملائم للمتصفح.

بصمة النسخة المثبتة أهم من اسم ملف المفتاح

اختبر تسجيل الدخول باستخدام النسخة نفسها التي سيحملها المستخدم. شهادة رفع التطبيق إلى Google Play قد تختلف عن شهادة App Signing التي توقع النسخة الموزعة. أضف البصمات المناسبة داخل إعدادات تطبيق Android في Firebase، وتحقق من applicationId بدل نسخ اسم مشروع Dart. عند تشغيل keytool للإصدار النهائي، اترك الأداة تطلب كلمة مرور المفتاح محليًا؛ لا تكتب كلمة المرور في الشرح أو تحفظها داخل سجل الأوامر.

تهيئة واحدة ومعالجة الإلغاء

عند استخدام واجهة google_sign_in الحديثة، نفذ initialize مرة في خدمة المصادقة قبل تمكين زر الدخول، ثم استخدم authenticate على المنصات التي تدعمه. الإلغاء اختيار طبيعي للمستخدم ويجب ألا يفتح الصفحة الرئيسية أو ينشئ مستندًا ناقصًا. لا تستدع signOut قبل كل محاولة دون سبب؛ اربط الخروج بزر واضح، وافصل بين الخروج من الجلسة وإلغاء ارتباط الحساب. مسار الويب يمكن تنفيذه باستخدام signInWithPopup مع GoogleAuthProvider.

اختبار تسجيل الدخول دون كشف بيانات الحساب

تحقق من Debug ومن نسخة الاختبار المنشورة عبر المتجر، ومن حساب جديد وآخر موجود، ومن رفض نافذة الدخول وانقطاع الشبكة. نجاح Firebase Authentication لا يعني أن ملف المستخدم في Firestore موجود؛ أنشئه أو حدّث حقولًا محددة بعد فحص وجوده، ولا تستبدل بياناته القديمة عشوائيًا. لا تسجل ID token أو بيانات اعتماد المستخدم في سجل التطبيق، واعرض رسالة مناسبة بدل طباعة الاستثناء الكامل للمستخدم.

كيف يعمل المثال؟

الخدمة أدناه تؤخر initialize إلى أول استخدام وتحتفظ بالـ Future لتجنب تكرار التهيئة داخل الخدمة نفسها، ثم تتحقق من دعم authenticate قبل بدء التفاعل. تنشئ Firebase credential من idToken وتنتظر نجاح signInWithCredential. أنشئ نسخة واحدة من الخدمة في التطبيق، وعالج الاستثناء والإلغاء في الواجهة دون انتقال عند الفشل. المثال لا ينشئ ملف Firestore ولا يخزن بيانات اعتماد محليًا؛ أضف ملف المستخدم حسب قواعدك بعد نجاح المصادقة.

المثال التطبيقي وحدوده

أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.

import 'package:firebase_auth/firebase_auth.dart';
import 'package:google_sign_in/google_sign_in.dart';

class GoogleFirebaseAuth {
  final GoogleSignIn _google = GoogleSignIn.instance;
  late final Future<void> _ready = _google.initialize();

  Future<UserCredential> signIn() async {
    await _ready;
    if (!_google.supportsAuthenticate()) {
      throw UnsupportedError('Use the web-specific sign-in flow');
    }
    final account = await _google.authenticate();
    final idToken = account.authentication.idToken;
    if (idToken == null) throw StateError('No Google ID token');
    return FirebaseAuth.instance.signInWithCredential(
      GoogleAuthProvider.credential(idToken: idToken),
    );
  }
}

مراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع