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

كانت مصادقة رابط البريد الإلكتروني تعتمد في السابق على Firebase Dynamic Links، الذي سيتم إيقافه نهائيًا في 25 آب (أغسطس) 2025. لقد نشرنا حلًا بديلاً في الإصدار 23.2.0 والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Firebase Authentication والإصدار 33.9.0 والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Firebase BoM. إذا كان تطبيقك يستخدم الروابط القديمة وأردت استخدام طريقة بديلة لنقل بيانات تطبيقك، يمكنك الاطّلاع على مقالة المصادقة باستخدام Firebase باستخدام رابط البريد الإلكتروني في Android لاستخدام النظام الجديد المستنِد إلى Firebase Hosting.

بالإضافة إلى ذلك، إذا كنت تستخدم حزمة SDK لنظام التشغيل Android من Firebase Authentication الإصدار 20.0.0 أو إصدارًا أقدم (أو Firebase BoM الإصدار 26.0.0 أو إصدارًا أقدم) لإدارة عمليات OAuth باستخدام Firebase Authentication، عليك التحديث إلى أحدث إصدار من حزمة SDK لنظام التشغيل Authentication أو الإصدار BoM (Authentication الإصدار 20.0.0 أو إصدار أحدث أو BoM الإصدار 26.0.0 أو إصدار أحدث) لمواصلة إدارة عمليات OAuth في Firebase Authentication.

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

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

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

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

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

ضبط تطبيق Android لمعالجة رابط Firebase Hosting
1. لمعالجة هذه الروابط من تطبيق Android، يجب تحديد اسم حزمة تطبيقك في إعدادات مشروع Firebase console. بالإضافة إلى ذلك، يجب تقديم SHA-1 وSHA-256 لشهادة التطبيق.
2. إذا أردت أن تعيد روابط Firebase Hosting هذه التوجيه إلى نشاط معيّن، عليك ضبط فلتر أهداف في ملف AndroidManifest.xml. من المفترض أن يرصد فلتر الأهداف روابط Firebase Hosting نطاقك. في AndroidManifest.xml:
```
<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.BROWSABLE" />
  <category android:name="android.intent.category.DEFAULT" />
  <data
    android:scheme="https"
    android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
    android:pathPrefix="/__/auth/links" />
</intent-filter>
```
عندما يفتح المستخدمون رابط استضافة باستخدام المسار "‎/__/auth/links" و المخطّط والمضيف اللذين تحدّدهما، سيبدأ تطبيقك النشاط باستخدام ملف ترشيح عناوين البريد الإلكتروني هذا لمعالجة الرابط.

ملاحظة مهمة: لضمان التراجع بسلاسة، ننصحك بإبقاء فلتر الأهداف الحالي الذي يعالج Firebase Dynamic Links أثناء تجربة حلّ Firebase Hosting للرابط. سيكون حلّ Firebase Dynamic Links متاحًا حتى 25 آب (أغسطس) 2025.
ضبط مشروعك لاستخدام الروابط الجديدة

عندما تكون مستعدًا للتعامل مع روابط النطاق الجديد، يمكنك استخدام حزمة 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);
  });
}
```
ملاحظة مهمة: للرجوع إلى الإصدار Firebase Dynamic Links أثناء تنفيذ حلّ الاحتفاظ بنسخة احتياطية و اختباره، عليك ضبط النطاق على FIREBASE_DYNAMIC_LINK مرة أخرى. سيكون حلّ Firebase Dynamic Links متاحًا حتى 25 آب (أغسطس) 2025.
إرسال رابط الرسالة الإلكترونية والاستفادة منه

أرسِل رابط تسجيل الدخول عبر البريد الإلكتروني كما في السابق. عندما ينقر المستخدم النهائي على الرابط، ستتم إعادة توجيهه إلى التطبيق إذا كان مثبّتًا لإكمال عملية تسجيل الدخول.

تخصيص روابط الأجهزة الجوّالة

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

استخدام نطاق Firebase Hosting مخصّص

اتّبِع تعليمات Firebase Hosting لإعداد نطاق مخصّص.
اضبط تطبيق Android لمعالجة رابط Firebase Hosting. (التعليمات الواردة في القسم السابق أعلاه)
أرسِل رابط مصادقة إلى عنوان البريد الإلكتروني للمستخدم مع عنصر ActionCodeSettings معدَّل يتضمّن نطاقًا مخصّصًا على النحو التالي: linkDomain.

إعادة استخدام نطاق Firebase Dynamic Links المخصّص

يمكنك إعادة استخدام أيّ من نطاقات Firebase Dynamic Links كنطاقك المخصّص. ومع ذلك، لن تعود أي وظائف Firebase Dynamic Links متاحة (على سبيل المثال، لا يمكن إعادة توجيه المستخدمين إلى متجر تطبيقات إذا لم يكن التطبيق مثبّتًا على أجهزتهم).
اضبط تطبيق Android لمعالجة رابط Firebase Hosting (التعليمات في القسم السابق أعلاه).
أرسِل رابط مصادقة إلى عنوان البريد الإلكتروني للمستخدم مع عنصر ActionCodeSettings معدَّل يتضمّن نطاقًا مخصّصًا على النحو التالي: linkDomain.