تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

بالإضافة إلى ذلك، إذا كنت تستخدم الإصدار الأقدم من 20.0.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بـ "Firebase Authentication" (أو الإصدار الأقدم من 26.0.0 من Firebase BoM) لإدارة عمليات 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 console. بالإضافة إلى ذلك، يجب تقديم SHA-1 وSHA-256 لشهادة التطبيق.
2. إذا أردت أن تؤدي روابط Firebase Hosting إلى إعادة التوجيه إلى نشاط معيّن، عليك إعداد intent filter في ملف AndroidManifest.xml. يجب أن يرصد intent filter 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" والمخطط والمضيف اللذين تحدّدهما، سيبدأ تطبيقك النشاط باستخدام intent filter هذا للتعامل مع الرابط.

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

عندما تكون مستعدًا للتعامل مع روابط النطاق الجديدة، يمكنك استخدام 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);
  }
};
```
ملاحظة مهمة: للعودة إلى الحالة السابقة إلى 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