بدء استخدام مصادقة 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.0.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متعدّدة في تطبيقك، ننصحك بشدة باستخدام 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.0.0")
   }

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

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

قبل الحديث عن كيفية مصادقة تطبيقك للمستخدمين، دعنا نقدّم مجموعة من الأدوات التي يمكنك استخدامها لإنشاء نماذج أولية واختبار وظيفة Authentication: 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.

Kotlin

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

Java

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.

Kotlin

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

Java

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.

Kotlin

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

Java

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
• المصادقة بدون الكشف عن الهوية