نقل ميزة تسجيل الدخول باستخدام رابط البريد الإلكتروني من "روابط Firebase الديناميكية" (لنظام التشغيل Android)

كانت مصادقة رابط البريد الإلكتروني تعتمد سابقًا على Firebase Dynamic Links، وسيتم إيقافها في 25 أغسطس 2025. لقد نشرنا حلاً بديلاً في الإصدار 23.2.0 والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Android والإصدار 33.9.0 والإصدارات الأحدث من Firebase BoM. إذا كان تطبيقك يستخدم الروابط القديمة وأردت استخدام طريقة بديلة لنقل تطبيقك، يمكنك الاطّلاع على مقالة المصادقة باستخدام رابط البريد الإلكتروني في Firebase على Android لاستخدام النظام الجديد المستند إلى Firebase Hosting.Firebase AuthenticationFirebase BoMFirebase Hosting

بالإضافة إلى ذلك، إذا كنت تستخدم Firebase Authentication لنظام التشغيل Android التي تقلّ عن الإصدار 20.0.0 (أو Firebase BoM الذي يقلّ عن الإصدار 26.0.0) لإدارة مسارات OAuth باستخدام Firebase Authentication، عليك التحديث إلى أحدث إصدار من Authentication أو BoM ( Authentication الإصدار 20.0.0 أو الإصدارات الأحدث أو BoM الإصدار 26.0.0 أو الإصدارات الأحدث) لمواصلة إدارة مسارات OAuth في Firebase Authentication.

نقل النطاق المرتبط Firebase Dynamic Links إلى نطاق Firebase Hosting

بدلاً من استخدام نطاق Firebase Dynamic Links، سيستخدم Firebase Authentication النطاق التلقائي Firebase Hosting لمشروعك لإنشاء روابط لربط البريد الإلكتروني وإجراءات الروابط الأخرى خارج النطاق في التطبيقات على الأجهزة الجوّالة. وهذا يعني أنّه يجب أيضًا تعديل تطبيقك لاستخدام هذا النطاق التلقائي كنطاق مرتبط لروابط مصادقة البريد الإلكتروني في تطبيقك على الأجهزة الجوّالة.

يمكنك اتّباع التعليمات الواردة في مقالة المصادقة باستخدام رابط البريد الإلكتروني في Firebase على Android لتعديل روابط تطبيقك على الأجهزة الجوّالة لاستخدام النطاق التلقائي الجديد الذي يتم توفيره تلقائيًا Firebase Hosting.

استخدِم التعليمات التالية للتعامل مع الروابط من النطاق الجديد ول إخبار Firebase Authentication ببدء استخدام النطاق الجديد لإنشاء روابط التطبيقات على الأجهزة الجوّالة من الآن فصاعدًا.

إذا أردت مواصلة استخدام أي من نطاقاتك المخصّصة Firebase Hosting أو حتى نطاقك المخصّص Firebase Dynamic Links ليكون نطاقك الجديد المرتبط ، اتّبِع الخطوات التي تتطابق مع النطاق المقصود الذي تريد استخدامه. يُرجى العِلم أنّه بعد إكمال التعليمات الواردة في القسم التالي، ستتم إزالة ميزة الربط بصفحة معيّنة في النطاق المخصّص لـ Firebase Dynamic Links، وسيظل النطاق نفسه فقط لإنشاء روابط البريد الإلكتروني.

1. ضبط تطبيق Android للتعامل مع رابط Firebase Hosting

   1. للتعامل مع هذه الروابط من تطبيق Android، يجب تحديد اسم حزمة تطبيقك في Firebase إعدادات مشروع وحدة التحكم. بالإضافة إلى ذلك، يجب تقديم SHA-1 وSHA-256 لشهادة التطبيق.

   2. إذا أردت أن تتم إعادة توجيه روابط Firebase Hosting هذه إلى نشاط معيّن ، عليك ضبط intent filter في ملف AndroidManifest.xml يجب أن يرصد intent filter Firebase Hosting روابط نطاقك. في AndroidManifest.xml:

      <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data
          android:scheme="https"
          android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
          android:pathPrefix="/__/auth/links" />
      </intent-filter>
      

   عندما يفتح المستخدمون رابط استضافة يتضمّن المسار "/__/auth/links" والمخطط والمضيف اللذين تحدّدهما، سيبدأ تطبيقك النشاط باستخدام فلتر الهدف هذا للتعامل مع الرابط.

2. ضبط مشروعك لاستخدام الروابط الجديدة

   عندما تصبح جاهزًا للتعامل مع روابط النطاق الجديد، يمكنك استخدام الـ Firebase Admin SDK لتعديل طريقة إنشاء روابط البريد الإلكتروني وأخبِر نظامنا الخلفي ببدء إنشاء الروابط باستخدام النطاق الجديد Firebase Hosting.

   import { getAuth } from 'firebase-admin/auth';
   
   const updateEmailAuthDomain = async () => {
     const updateRequest = {
       mobileLinksConfig: {
         domain: 'HOSTING_DOMAIN',
       },
     };
   
     const projectConfigManager = getAuth().projectConfigManager();
   
     try {
       const response = await projectConfigManager.updateProjectConfig(updateRequest);
       // Updated project config
       console.log('Project configuration updated successfully:', response);
     } catch (error) {
       console.error('Error updating the project:', error);
     }
   };
   

3. إرسال رابط البريد الإلكتروني واستخدامه

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

تخصيص روابط الأجهزة الجوّالة

يمكنك استخدام نطاق Firebase Hosting مخصّص أو إعادة استخدام نطاق Firebase Dynamic Links مخصّص ليكون نطاق روابط الأجهزة الجوّالة الجديد.

استخدام نطاق Firebase Hosting مخصّص

1. اتّبِع الـ Firebase Hostingدليل لإعداد نطاق مخصّص.
2. اضبط تطبيق Android للتعامل مع رابط Firebase Hosting. (التعليمات في القسم السابق أعلاه).
3. أرسِل رابط مصادقة إلى عنوان البريد الإلكتروني للمستخدم باستخدام عنصر ActionCodeSettings مُعدَّل يتضمّن نطاقًا خاصًا كـ linkDomain.

إعادة استخدام نطاقك المخصّص Firebase Dynamic Links

1. يمكنك إعادة استخدام أي من نطاقاتك Firebase Dynamic Links كنطاق مخصّص. ومع ذلك، لن يعود أي من وظائف Firebase Dynamic Links متاحًا (على سبيل المثال، لا يمكن إعادة توجيه المستخدمين إلى أحد متاجر التطبيقات إذا لم يكن التطبيق مثبّتًا على أجهزتهم).
2. اضبط تطبيق Android للتعامل مع رابط Firebase Hosting (التعليمات في القسم السابق أعلاه).
3. أرسِل رابط مصادقة إلى عنوان البريد الإلكتروني للمستخدم باستخدام عنصر ActionCodeSettings مُعدَّل يتضمّن نطاقًا خاصًا كـ linkDomain.