تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

بالإضافة إلى ذلك، إذا كنت تستخدم حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Firebase Authentication بإصدار أقل من 20.0.0 (أو Firebase BoM بإصدار أقل من 26.0.0) لإدارة عمليات OAuth مع Firebase Authentication، عليك الترقية إلى أحدث إصدار من حزمة تطوير البرامج (SDK) من Authentication أو BoM (الإصدار 20.0.0 أو إصدار أحدث من Authentication أو الإصدار 26.0.0 أو إصدار أحدث من BoM) لمواصلة إدارة عمليات 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 على وحدة التحكّم. بالإضافة إلى ذلك، يجب تقديم خوارزميتَي 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.
ضبط مشروعك لاستخدام الروابط الجديدة

عندما تكون مستعدًا للتعامل مع روابط النطاق الجديدة، يمكنك استخدام Firebase Admin SDK لتعديل طريقة إنشاء روابط البريد الإلكتروني وإصدار تعليمات إلى الخلفية لبدء إنشاء الروابط باستخدام النطاق الجديد 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