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

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

بالإضافة إلى ذلك، إذا كنت تستخدم حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Firebase Authentication بإصدار أقدم من 20.0.0 (أو Firebase BoM بإصدار أقدم من 26.0.0) لإدارة عمليات OAuth باستخدام Firebase Authentication، عليك التحديث إلى أحدث إصدار من حزمة تطوير البرامج (SDK) من Authentication أو الإصدار الأحدث من BoM (الإصدار 20.0.0 أو أحدث من Authentication أو الإصدار 26.0.0 أو أحدث من BoM) لمواصلة إدارة عمليات 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" والمخطط والمضيف اللذين تحدّدهما، سيبدأ تطبيقك النشاط باستخدام intent filter هذا لمعالجة الرابط.

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

   عندما تكون مستعدًا للتعامل مع روابط النطاق الجديد، يمكنك استخدام مدير SDK في Firebase لتعديل طريقة إنشاء روابط البريد الإلكتروني وإصدار تعليمات إلى الواجهة الخلفية لبدء إنشاء الروابط باستخدام نطاق 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.