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

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

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

   ملاحظة مهمة: لضمان عملية العودة إلى الحالة السابقة سلسة، ننصحك بالاحتفاظ بـ intent filter الحالي الذي يتعامل مع Firebase Dynamic Links أثناء تجربة حلّ رابط Firebase Hosting. سيتوفّر حلّ Firebase Dynamic Links حتى 25 أغسطس 2025.

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);
     }
   };
   

   ملاحظة مهمة: للعودة إلى الحالة السابقة إلى Firebase Dynamic Links أثناء تنفيذ حلّ النسخ الاحتياطي واختباره، عليك إعادة ضبط النطاق على FIREBASE_DYNAMIC_LINK. سيتوفّر حلّ Firebase Dynamic Links حتى 25 أغسطس 2025.

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.