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

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

    عليك ضبط النطاق المحدّد كنطاق مرتبط ل روابط التطبيقات. لإعداد الإذن في تطبيقك، افتح علامة التبويب التوقيع والإمكانات للهدف في 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.

    const updateRequest = {
mobileLinksConfig: {
    domain: 'HOSTING_DOMAIN'
}
}
const updateProjectConfig = () => {
projectConfigManager.updateProjectConfig(updateRequest)
.then((response) => {
    // updated project config
}).catch((error) => {
    console.log('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.