نقل ميزة تسجيل الدخول باستخدام رابط البريد الإلكتروني من "روابط 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. ضبط مشروعك لاستخدام الروابط الجديدة

    عندما تصبح جاهزًا للتعامل مع روابط النطاق الجديد، يمكنك استخدام حزمة 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.