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

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

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

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

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

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

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

  1. ربط نطاق Firebase Hosting بالنطاق المرتبط بتطبيقك

    عليك ضبط النطاق الذي تم اختياره كنطاق مرتبط لروابط التطبيقات. لإعداد الاستحقاق في تطبيقك، افتح علامة التبويب التوقيع والإمكانات للهدف في Xcode وأضِف نطاقات Firebase Hostingمن الخطوة السابقة إلى إمكانية النطاقات المرتبطة. إذا كنت تستخدم النطاق التلقائي Firebase Hosting، سيكون applinks:PROJECT_ID.firebaseapp.com.

    اطّلِع على مقالة دعم النطاقات المرتبطة على موقع مستندات Apple الإلكتروني لمزيد من المعلومات.

    تم نشر ملف نطاق مرتبط ضمن جميع نطاقاتك Firebase Hosting. للوصول إليه، انتقِل إلى PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. يمكن استبدال ملف AASA هذا. اطّلِع على مقالة إنشاء ملفات إعداد الروابط العامة واستضافتها لمزيد من المعلومات.

  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. اربط النطاق المخصّص بالنطاق المرتبط بتطبيقك.
  3. أرسِل رابط مصادقة إلى عنوان البريد الإلكتروني للمستخدم باستخدام كائن ActionCodeSettings معدَّل يتضمّن نطاقًا مخصّصًا كـ linkDomain.
  1. يمكنك إعادة استخدام أي من نطاقاتك Firebase Dynamic Links كنطاقك المخصّص. ومع ذلك، لن يعود بإمكانك استخدام أي من وظائف Firebase Dynamic Links (على سبيل المثال، لا يمكن إعادة توجيه المستخدمين إلى متجر التطبيقات إذا لم يكن التطبيق مثبّتًا على أجهزتهم).
  2. أرسِل رابط مصادقة إلى عنوان البريد الإلكتروني للمستخدم باستخدام كائن ActionCodeSettings معدَّل يتضمّن نطاقًا مخصّصًا كـ linkDomain.