نقل ميزة تسجيل الدخول باستخدام رابط البريد الإلكتروني من "روابط 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 النطاق التلقائي لخدمة Firebase Hosting في مشروعك لإنشاء روابط لإجراءات رابط البريد الإلكتروني والإجراءات الأخرى خارج النطاق في التطبيقات على الأجهزة الجوّالة. يعني ذلك أنّه يجب أيضًا تعديل تطبيقك لاستخدام هذا النطاق التلقائي كنطاق مرتبط لروابط المصادقة عبر البريد الإلكتروني في تطبيقك على الأجهزة الجوّالة.

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

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

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

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

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

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

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

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