بدء استخدام مصادقة Firebase على نظام التشغيل Android

ربط تطبيقك بمنصّة Firebase

أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك، .

إضافة Firebase Authentication إلى تطبيقك

1. في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً ما يكون <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle)، أضِف الاعتمادية لمكتبة Firebase Authentication على Android. ننصحك باستخدام الـ Firebase Android BoM للتحكّم في تحديد إصدار المكتبة.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:34.15.0"))
   
       // Add the dependency for the Firebase Authentication library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth")
   }

   باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

   (بديل)  إضافة اعتماديات مكتبة Firebase بدون استخدام BoM

   إذا اخترت عدم استخدام Firebase BoM، عليك تحديد إصدار كل مكتبة من مكتبات Firebase في سطر الاعتمادية الخاص بها.

   ملاحظة: إذا كنت تستخدم مكتبات متعدّدة من Firebase في تطبيقك، ننصحك بشدة باستخدام BoM لإدارة إصدارات المكتبات، ما يضمن توافق جميع الإصدارات.

   dependencies {
       // Add the dependency for the Firebase Authentication library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth:24.1.0")
   }

2. لاستخدام أحد مزوّدي المصادقة، عليك تفعيله في الـ Firebaseوحدة تحكّم. انتقِل إلى صفحة طريقة تسجيل الدخول في قسم Firebase Authentication لتفعيل تسجيل الدخول باستخدام البريد الإلكتروني وكلمة المرور وأي مزوّدي هويّة آخرين تريده لتطبيقك.

(اختياري) إنشاء نموذج أولي وإجراء اختبار باستخدام Firebase Local Emulator Suite

قبل التحدّث عن كيفية مصادقة تطبيقك للمستخدمين، لنقدّم مجموعة من الأدوات التي يمكنك استخدامها لإنشاء نموذج أولي واختبار Authentication functionality: Firebase Local Emulator Suite. إذا كنت بصدد الاختيار بين تقنيات المصادقة ومزوّديها، أو تجربة نماذج بيانات مختلفة باستخدام بيانات عامة وخاصة باستخدام Authentication وFirebase Security Rules، أو إنشاء نماذج أولية لتصاميم واجهة مستخدم تسجيل الدخول، يمكن أن يكون العمل محليًا بدون نشر الخدمات المباشرة فكرة رائعة.

يُعدّ برنامج محاكاة Authentication جزءًا من Local Emulator Suite، ما يتيح لتطبيقك التفاعل مع محتوى قاعدة البيانات والإعدادات المحاكاة، بالإضافة إلى موارد مشروعك المحاكاة اختياريًا (الدوال وقواعد البيانات الأخرى وقواعد الأمان).

لا يتطلّب استخدام برنامج محاكاة Authentication سوى بضع خطوات:

1. إضافة سطر من الرمز البرمجي إلى إعدادات الاختبار في تطبيقك للاتصال بالمحاكي
2. من جذر دليل مشروعك على جهاز المستخدم، تنفيذ الأمر firebase emulators:start.
3. استخدام واجهة المستخدم Local Emulator Suite لإنشاء نماذج أولية تفاعلية، أو واجهة برمجة تطبيقات REST لبرنامج المحاكاة Authentication لإجراء اختبار غير تفاعلي

يتوفّر دليل مفصّل في مقالة ربط تطبيقك ببرنامج محاكاة Authentication. لمزيد من المعلومات، يُرجى الاطّلاع على مقدّمة Local Emulator Suite.

لنتابع الآن كيفية مصادقة المستخدمين.

التحقّق من حالة المصادقة الحالية

1. حدِّد مثيلاً من FirebaseAuth.

   Kotlin

   private lateinit var auth: FirebaseAuth
   EmailPasswordActivity.kt

   Java

   private FirebaseAuth mAuth;
   EmailPasswordActivity.java

2. في طريقة onCreate()، ابدأ مثيل FirebaseAuth.

   Kotlin

   // Initialize Firebase Auth
   auth = Firebase.auth
   EmailPasswordActivity.kt

   Java

   // Initialize Firebase Auth
   mAuth = FirebaseAuth.getInstance();
   EmailPasswordActivity.java

3. عند بدء نشاطك، تحقَّق مما إذا كان المستخدم قد سجّل الدخول حاليًا.

   Kotlin

   public override fun onStart() {
       super.onStart()
       // Check if user is signed in (non-null) and update UI accordingly.
       val currentUser = auth.currentUser
       if (currentUser != null) {
           reload()
       }
   }
   EmailPasswordActivity.kt

   Java

   @Override
   public void onStart() {
       super.onStart();
       // Check if user is signed in (non-null) and update UI accordingly.
       FirebaseUser currentUser = mAuth.getCurrentUser();
       if(currentUser != null){
           reload();
       }
   }
   EmailPasswordActivity.java

تسجيل مستخدمين جدد

أنشئ طريقة createAccount جديدة تأخذ عنوان بريد إلكتروني وكلمة مرور، وتتحقّق منهما، ثم تنشئ مستخدمًا جديدًا باستخدام createUserWithEmailAndPassword الطريقة.

auth.createUserWithEmailAndPassword(email, password)
    .addOnCompleteListener(this) { task ->
        if (task.isSuccessful) {
            // Sign in success, update UI with the signed-in user's information
            Log.d(TAG, "createUserWithEmail:success")
            val user = auth.currentUser
            updateUI(user)
        } else {
            // If sign in fails, display a message to the user.
            Log.w(TAG, "createUserWithEmail:failure", task.exception)
            Toast.makeText(
                baseContext,
                "Authentication failed.",
                Toast.LENGTH_SHORT,
            ).show()
            updateUI(null)
        }
    }
EmailPasswordActivity.kt

mAuth.createUserWithEmailAndPassword(email, password)
        .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    // Sign in success, update UI with the signed-in user's information
                    Log.d(TAG, "createUserWithEmail:success");
                    FirebaseUser user = mAuth.getCurrentUser();
                    updateUI(user);
                } else {
                    // If sign in fails, display a message to the user.
                    Log.w(TAG, "createUserWithEmail:failure", task.getException());
                    Toast.makeText(EmailPasswordActivity.this, "Authentication failed.",
                            Toast.LENGTH_SHORT).show();
                    updateUI(null);
                }
            }
        });
EmailPasswordActivity.java

أضِف نموذجًا لتسجيل مستخدمين جدد باستخدام عنوان بريدهم الإلكتروني وكلمة المرور، واستدعِ هذه الطريقة الجديدة عند إرسال النموذج. يمكنك الاطّلاع على مثال في نموذج البدء السريع .

تسجيل دخول المستخدمين الحاليين

أنشئ طريقة signIn جديدة تأخذ عنوان بريد إلكتروني وكلمة مرور، وتتحقّق منهما، ثم تسجّل دخول المستخدم باستخدام الطريقة signInWithEmailAndPassword.

auth.signInWithEmailAndPassword(email, password)
    .addOnCompleteListener(this) { task ->
        if (task.isSuccessful) {
            // Sign in success, update UI with the signed-in user's information
            Log.d(TAG, "signInWithEmail:success")
            val user = auth.currentUser
            updateUI(user)
        } else {
            // If sign in fails, display a message to the user.
            Log.w(TAG, "signInWithEmail:failure", task.exception)
            Toast.makeText(
                baseContext,
                "Authentication failed.",
                Toast.LENGTH_SHORT,
            ).show()
            updateUI(null)
        }
    }
EmailPasswordActivity.kt

mAuth.signInWithEmailAndPassword(email, password)
        .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    // Sign in success, update UI with the signed-in user's information
                    Log.d(TAG, "signInWithEmail:success");
                    FirebaseUser user = mAuth.getCurrentUser();
                    updateUI(user);
                } else {
                    // If sign in fails, display a message to the user.
                    Log.w(TAG, "signInWithEmail:failure", task.getException());
                    Toast.makeText(EmailPasswordActivity.this, "Authentication failed.",
                            Toast.LENGTH_SHORT).show();
                    updateUI(null);
                }
            }
        });
EmailPasswordActivity.java

أضِف نموذجًا لتسجيل دخول المستخدمين باستخدام عنوان بريدهم الإلكتروني وكلمة المرور، واستدعِ هذه الطريقة الجديدة عند إرسال النموذج. يمكنك الاطّلاع على مثال في نموذج البدء السريع .

الوصول إلى معلومات المستخدم

إذا سجّل المستخدم الدخول بنجاح، يمكنك الحصول على بيانات حسابه في أي وقت باستخدام الطريقة getCurrentUser.

val user = Firebase.auth.currentUser
user?.let {
    // Name, email address, and profile photo Url
    val name = it.displayName
    val email = it.email
    val photoUrl = it.photoUrl

    // Check if user's email is verified
    val emailVerified = it.isEmailVerified

    // The user's ID, unique to the Firebase project. Do NOT use this value to
    // authenticate with your backend server, if you have one. Use
    // FirebaseUser.getIdToken() instead.
    val uid = it.uid
}
MainActivity.kt

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    // Name, email address, and profile photo Url
    String name = user.getDisplayName();
    String email = user.getEmail();
    Uri photoUrl = user.getPhotoUrl();

    // Check if user's email is verified
    boolean emailVerified = user.isEmailVerified();

    // The user's ID, unique to the Firebase project. Do NOT use this value to
    // authenticate with your backend server, if you have one. Use
    // FirebaseUser.getIdToken() instead.
    String uid = user.getUid();
}
MainActivity.java

الخطوات التالية

استكشِف الأدلة حول إضافة خدمات أخرى للتحقّق من الهوية والمصادقة:

• تسجيل الدخول باستخدام حساب Google
• تسجيل الدخول باستخدام Facebook
• المصادقة المجهولة