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

كانت المصادقة عبر رابط البريد الإلكتروني تعتمد سابقًا على Firebase Dynamic Links، وسيتم إيقافها في 25 أغسطس 2025. لقد نشرنا حلاً بديلاً في الإصدار 11.8.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS في Firebase Authentication. إذا كان تطبيقك يستخدم Firebase Dynamic Links، عليك نقل تطبيقك إلى النظام الجديد المستند إلى Firebase 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 بالنطاق المرتبط بتطبيقك.

    يجب ضبط النطاق المحدّد كنطاق مرتبط لروابط التطبيقات. لإعداد الاستحقاق في تطبيقك، افتح علامة التبويب Signing & Capabilities (التوقيع والإمكانات) الخاصة بالهدف في 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. اضبط مشروعك لاستخدام الروابط الجديدة.

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