أطلقنا ميزة "روابط Firebase الديناميكية" منذ أكثر من 7 أعوام لجعل عناوين URL أكثر فعالية، - مثلاً من خلال تغيير وجهة الرابط بشكل ديناميكي استنادًا إلى ظروف وقت التشغيل.
على مرّ الأعوام، تطورت المنظومتان المتكاملتان للويب والأجهزة الجوّالة باستخدام تقنيات مثل روابط التطبيقات وتطبيقات Google Play الفورية والروابط العامة وApp Clips وأصبحت رحلات المستخدمين على التطبيقات والويب أكثر سلاسة وقابلية للتوقّع لـ مستخدمي تطبيقاتك. نعتقد أنّك أنت ومستخدميك ستستفيدون أكثر من اعتماد هذه التقنيات مباشرةً ومواصلة تطوير المنظومة المتكاملة. ومع ذلك، إلى جانب هذه التغييرات الجديدة، تطورت أيضًا واجهات برمجة التطبيقات الأصلية التي تم إنشاء "روابط Firebase الديناميكية" عليها، ما أدى إلى ظهور تحديات جديدة.
على سبيل المثال، أثرت التغييرات في المنظومة المتكاملة في قدرتنا على توفير تجربة مستقرة باستمرار لإحدى الميزات الأساسية في "روابط Firebase الديناميكية"، وهي منح مستخدمي التطبيقات عملية انتقال سلسة إلى التطبيق بعد التثبيت، بغض النظر عن المنصة.
بدلاً من مواصلة تقديم تجربة غير مثالية، قرّرنا إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا، وإعادة تركيز مواردنا على حلّ المشاكل الأخرى التي يواجهها المطوّرون.
ندرك أنّ هذا التغيير سيتطلب منك وقتًا لتقييم الحلول أو موفّري المنصات البديلة واعتمادها في السوق.
نواصل تطوير Firebase لتلبية احتياجاتك مع استمرار تطور المنظومة المتكاملة وتغيّرها. سنواصل إطلاق ميزات جديدة و تحديثات على مستوى منتجات Firebase، ونحن ملتزمون بمساعدتك على التميّز في رحلات تطوير تطبيقاتك.
ما هي المعلومات التي يجب معرفتها؟
في 25 أغسطس 2025، سيتم إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا. ستتوقف جميع الروابط التي تقدّمها ميزة "روابط Firebase الديناميكية" (سواء المستضافة على نطاقات مخصّصة أو على نطاقات فرعية من page.link) عن العمل، ولن يعود بإمكانك إنشاء روابط جديدة.
لمساعدتك في تحديد كيفية نقل البيانات من "روابط Firebase الديناميكية"، سنواصل تعديل مستند الأسئلة الشائعة هذا بمعلومات إضافية لتأخذها في الاعتبار، بالإضافة إلى توفير أدلة نقل البيانات لسيناريوهات نقل البيانات المختلفة التي قد تتطابق مع طريقة استخدامك لميزة "روابط Firebase الديناميكية" اليوم.
سنواصل أيضًا تعديل هذا الدليل بإضافة المزيد من الأسئلة الشائعة مع تقدّم عملية الإيقاف النهائي نحو تاريخ الإيقاف النهائي في 25 أغسطس 2025، وفي حال اكتشاف أي مشاكل إضافية أثناء مساعدتك في جهود نقل البيانات.
يُرجى الاطّلاع على الأسئلة الشائعة أدناه للمساعدة في الإجابة عن بعض أهم أسئلتك.
لبدء عملية نقل البيانات، يُرجى الاطّلاع على "كيف يمكنني نقل البيانات من الخدمة؟" السؤال الشائع أدناه.
متى سيتوقف عمل ميزة "روابط Firebase الديناميكية"؟
في 25 أغسطس 2025، سيتم إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا. ستتوقف جميع الروابط التي تقدّمها ميزة "روابط Firebase الديناميكية" (سواء المستضافة على نطاقات مخصّصة أو على نطاقات فرعية من page.link) عن العمل.
ما هو الوقت المتاح لي لنقل البيانات؟
لديك حتى 25 أغسطس 2025 لإكمال عملية نقل البيانات.
هل ستستمر الروابط الجديدة والحالية في العمل؟
نعم، ستستمر روابطك الجديدة والحالية في العمل حتى يتم إيقاف خدمة "الروابط الديناميكية" نهائيًا في 25 أغسطس 2025.
هل سيظل بإمكاني الاحتفاظ بالنطاقات .page.link التي تم توفيرها تلقائيًا والمستخدَمة للروابط أو نقلها؟
لا، لن تعود أي نطاقات .page.link متاحة بعد إيقاف خدمة "روابط Firebase الديناميكية" نهائيًا. ننصحك بالاطّلاع على قائمة الأسئلة هذه لـ تقييم أفضل طريقة لنقل البيانات من الخدمة، وإذا كنت بحاجة إلى ميزات مماثلة تمامًا، اتّبِع هذا الدليل بشأن تصدير بياناتك الوصفية ونقلها إلى موفّر خدمة آخر للربط بصفحات في التطبيق باستخدام نطاق جديد.
ماذا سيحدث لروابطي وفي تطبيقاتي عند إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا (في 25 أغسطس 2025)؟
عند إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا، يمكنك توقّع ما يلي:
- ستعرض جميع الروابط التي يتم النقر عليها استجابة حالة HTTP 404 للمستخدمين النهائيين.
ستعرض جميع طلبات HTTP إلى:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (واجهة برمجة تطبيقات الروابط القصيرة)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (واجهة برمجة تطبيقات إحصاءات الروابط)
استجابة حالة HTTP 400/403.
ستبدأ استجابات الأخطاء أعلاه تدريجيًا في 25 أغسطس 2025 إلى أن تصل في النهاية إلى معدّلات استجابة الأخطاء بنسبة% 100 بعد انقضاء تاريخ الإيقاف النهائي.
السلوك التالي استنادًا إلى إصدار منصة حزمة تطوير البرامج (SDK) وطلب واجهة برمجة التطبيقات الذي تم إجراؤه في تطبيقك:
iOS
حالة الاستخدام طلب بيانات من واجهة برمجة التطبيقات رمز الحالة السلوك هل سيتعطّل تطبيقك؟ إنشاء رابط قصير shorten (Swift)
shortenUrl (Swift)
shortenWithCompletion (Objective-C)
403 يتم عرض الخطأ مع سبب الفشل لا* تحديد مصدر الفتح للمرة الأولى يتم استدعاؤه تلقائيًا على FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)
400 لا يتم عرض أي أخطاء، ولكن يتم إرسال عنصر FDL مع بيانات فارغة لا* تحديد مصدر إعادة الفتح handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 يتم عرض الخطأ مع سبب الفشل لا* Android
حالة الاستخدام طلب بيانات من واجهة برمجة التطبيقات رمز الحالة السلوك هل سيتعطّل تطبيقك؟ إنشاء رابط قصير buildShortDynamicLink (Kotlin)
buildShortDynamicLink (Java)
403 يتم عرض الخطأ مع سبب الفشل لا* تحديد مصدر الفتح للمرة الأولى getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 تعرض المهمة استجابة ناجحة، ولكن ستكون بيانات FDL فارغة لا* تحديد مصدر إعادة الفتح getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 تعرض المهمة استجابة ناجحة، ولكن ستكون بيانات FDL فارغة لا* قبول الدعوة يتم استدعاء وحدة AppInvite في "خدمات Google Play" عند معالجة عملية إعادة توجيه الغرض (من *.page.link أو نطاق مخصّص) 400 يظهر مؤشر تحميل عند استدعاء "خدمات Google Play"، ويختفي عند عرض استجابة 400 لا*
كيف يمكنني نقل البيانات من الخدمة؟
لاحظنا أنّ احتياجات المطوّرين تختلف عند استخدام ميزة "روابط Firebase الديناميكية".
استنادًا إلى حالات الاستخدام الخاصة بك وتقييم استخدامك لميزة "روابط Firebase الديناميكية"، من المحتمل أن يتطابق أحد السيناريوهات أدناه مع احتياجاتك.
ماذا عليّ أن أفعل إذا كنت بحاجة إلى ميزات مماثلة تمامًا لميزة "روابط Firebase الديناميكية"؟
في هذا السيناريو، ننصحك باستخدام موفّري خدمات الربط بصفحات في التطبيق الآخرين، مثل Adjust وAirbridge وAppsFlyer وBitly وBranch وKochava وSingular وموفّرين آخرين مشابهين في السوق. (يُرجى العِلم أنّ Google لم تتحقّق من هؤلاء الموفّرين، ولكنهم يقدّمون وظائف مشابهة لميزة "روابط Firebase الديناميكية").
يمكنك أيضًا تصدير البيانات الوصفية للربط بصفحات في التطبيق، ما قد يسهّل نقل روابطك إلى أي موفّر تختاره.
للمساعدة في العثور على موفّر يقدّم ميزات مطابقة لميزات "روابط Firebase الديناميكية"، يُرجى الرجوع إلى قائمة الميزات التالية أدناه.
ميزات "روابط Firebase الديناميكية":
- توجيه المستخدمين إلى المتجر الصحيح لأجهزتهم بنقرة واحدة (والرجوع إلى صفحة ويب إذا لزم الأمر)
- تزويد المستخدمين بإمكانية مواصلة الرحلة بعد تنزيل تطبيقك وتثبيته وعرض رابط لصفحة في التطبيق تم تأجيله
- تزويد المستخدمين بتجربة سياقية من خلال المحتوى المرتبط بصفحة في التطبيق (عند تثبيته مسبقًا)
- توفير بيانات إحصائية متعلقة بأحداث النقر على الروابط الديناميكية
- توفير إمكانية إنشاء عناوين URL للروابط القصيرة
- توفير إمكانية إضافة بيانات وصفية إلى الروابط للمشاركة على وسائل التواصل الاجتماعي
ماذا لو كنت أهتم فقط بالربط بصفحة في تطبيقي بعد تثبيته؟
في هذا السيناريو، ننصحك باستخدام روابط التطبيقات والروابط العامة، وهما طريقتان مدعومتان على مستوى المنصة للمطوّرين لتوفير تجارب الربط بصفحات في التطبيق لمستخدميهم.
يُرجى الاطّلاع على هذا الدليل لمزيد من التفاصيل حول كيفية نقل البيانات لاستخدام "روابط التطبيقات" و"الروابط العامة".
يصف هذا الدليل أيضًا كيفية استخدام "استضافة Firebase" بشكل اختياري لاستضافة النطاق الضروري وملفات التحقّق من رابط التنقل إلى مواد العرض على النطاق الذي تخطط لاستخدامه لروابطك الجديدة (مثل ملف assetlinks.json لـ "روابط التطبيقات"، وملف apple-app-site-association لـ "الروابط العامة").
ماذا لو لم يعُد تطبيقي بحاجة إلى ميزات من "روابط Firebase الديناميكية" ولا يحتاج إلى بديل لها؟
في هذا السيناريو، قد لا تحتاج إلى اتّخاذ أي إجراء في تطبيقك للتعامل مع عملية الإيقاف النهائي القادمة، ولكن ننصحك بما يلي:
مراجعة روابط Firebase الديناميكية الحالية باتّباع دليل تصدير البيانات الوصفية لروابطك لضمان عدم تأثّر المستخدمين وتطبيقك بعد أن تتوقف الخدمة عن عرض الروابط.
حذف بادئات عناوين URL لروابط Firebase الديناميكية في وحدة تحكّم Firebase. ملاحظة: سيتم حذف نطاقات بادئة عنوان URL تلقائيًا بعد 25 أغسطس 2025.
إزالة حزمة تطوير البرامج (SDK) لروابط Firebase الديناميكية من تطبيقاتك
إذا كان هناك سيناريو نقل بيانات لا يغطي احتياجاتك، يُرجى التواصل معنا لإعلامنا بذلك.
ماذا عليّ أن أفعل بعد إكمال عملية نقل البيانات؟
بعد الانتهاء من نقل البيانات من "روابط Firebase الديناميكية"، احرص على حذف جميع بادئات نطاقات عناوين URL (نطاقات "روابط Firebase الديناميكية") المرتبطة بروابط Firebase الديناميكية السابقة في مشروعك.
يمكنك إجراء ذلك من خلال:
- الانتقال إلى قسم "روابط Firebase الديناميكية" في وحدة تحكّم Firebase
اختيار بادئة عنوان URL التي تريد حذفها من أداة الاختيار على الجانب الأيمن
النقر على قائمة الخيارات الإضافية بجانب الزر "رابط ديناميكي جديد"
اختيار "حذف بادئة عنوان URL"
إدخال بادئة عنوان URL لتأكيد رغبتك في حذفها، والنقر على "حذف بادئة عنوان URL"
بعد الانتهاء من حذف جميع بادئات نطاقات عناوين URL، سيتم وضع علامة على مشروعك في Firebase للإشارة إلى إكمال عملية نقل البيانات من "روابط Firebase الديناميكية". سيؤدي ذلك أيضًا إلى إزالة تذكير النافذة المنبثقة الذي ربما ظهر لك في وحدة تحكّم Firebase لمشروعك.
يُرجى العِلم أنّ هذا الإجراء سيؤدي إلى حذف جميع روابط Firebase الديناميكية بعد إكماله، لذا تأكّد من نقل البيانات بالكامل من الخدمة قبل حذف بادئات نطاقات عناوين URL.
هل سيظل بإمكاني استخدام واجهات برمجة التطبيقات لروابط Firebase الديناميكية؟
ستظل واجهات برمجة التطبيقات لروابط Firebase الديناميكية الخاصة بـ الروابط القصيرة و"إحصاءات Google" متاحة حتى تاريخ الإيقاف النهائي في 25 أغسطس 2025.
بعد هذا التاريخ، لن تعود واجهات برمجة التطبيقات هذه متاحة للاستخدام، و سيتم إيقاف الخدمة نهائيًا.
كيف يمكنني تصدير البيانات الوصفية لروابطي؟
يُرجى الرجوع إلى دليل تصدير البيانات الوصفية لروابطك للحصول على تعليمات حول كيفية تصدير البيانات الوصفية لروابطك.
كيف يمكنني الحصول على بيانات "إحصاءات Google" لروابط Firebase الديناميكية؟
يمكنك استخدام دليل التصدير لاسترداد البيانات الوصفية لروابط Firebase الديناميكية، والتي تتضمّن الرابط نفسه.
يمكنك استخدام واجهة برمجة التطبيقات لإحصاءات روابط Firebase الديناميكية لاسترداد بيانات إحصاءات الروابط لكل رابط من روابط Firebase الديناميكية. تقتصر واجهة برمجة التطبيقات هذه على حوالي 5 طلبات في الثانية. للحصول على مثال حول كيفية العمل ضمن حدّ الطلبات هذا عند استخدام واجهة برمجة التطبيقات، يُرجى الرجوع إلى نموذج Cloud Task هذا.
يمكنك أيضًا استخدام إحصاءات Google و تصدير بياناتك لمجموعة فرعية من بيانات إحصاءات الروابط، بما في ذلك أحداث "تحديثات التطبيق" التي لا تتوفّر إلا في "إحصاءات Google".
إذا كنت بحاجة إلى معدّل طلبات أعلى للمساعدة في عملية نقل البيانات، يُرجى التواصل معنا على "دعم Firebase".
ماذا سيحدث للبيانات الوصفية للروابط الحالية بعد تاريخ الإيقاف النهائي (25 أغسطس 2025)؟
سيتم وضع علامة على نطاقك والبيانات الوصفية لروابطك لحذفها في 25 أغسطس 2025 وستتم إزالتها نهائيًا وفقًا لـ سياسة الاحتفاظ بالبيانات.
تأثير "روابط Firebase الديناميكية" في مسارات "مصادقة Firebase"
أريد تفعيل ميزة "المصادقة باستخدام رابط البريد الإلكتروني" في "مصادقة Firebase" لمشروعي. هل سأحتاج إلى إعداد ميزة "روابط Firebase الديناميكية"؟
لا، ليس عليك إعداد ميزة "روابط Firebase الديناميكية" لأنّ عملية الإعداد لم تعُد ممكنة. بدلاً من ذلك، يمكنك اتّباع الأدلة المعدَّلة حول كيفية البدء في استخدام ميزة "المصادقة باستخدام رابط البريد الإلكتروني" لتفعيلها وتنفيذها لمشروعك:
يُرجى الاطّلاع على القائمة الكاملة بـ الإجراءات المتأثرة بهذا التغيير.
كيف تتأثر ميزات "المصادقة" التالية: "المصادقة باستخدام رابط البريد الإلكتروني" وإعادة ضبط كلمة المرور وتأكيد عنوان البريد الإلكتروني؟
سيستمر عمل ميزة "المصادقة باستخدام رابط البريد الإلكتروني" وإجراءات البريد الإلكتروني خارج النطاق مع Firebase، ولكن عليك الترقية إلى أحدث Firebase Authentication حِزم تطوير البرامج (SDK) ونقل البيانات إلى الحلّ الجديد لمواصلة استخدام هذه الإجراءات بعد إيقاف خدمة Firebase Dynamic Links نهائيًا في 25 أغسطس 2025.
يمكنك اتّباع الأدلة المرتبطة أدناه للحصول على تعليمات حول كيفية إكمال عملية نقل البيانات:
يُرجى الاطّلاع على القائمة الكاملة بـ الإجراءات المتأثرة بذلك.
كيف تتأثر عمليات تنفيذ مسار OAuth باستخدام إصدارات حزمة تطوير البرامج (SDK) لـ "مصادقة Firebase" على Android الأقل من الإصدار 20.0.0 أو إصدارات قائمة مواد الإصدار الأقل من الإصدار 26.0.0؟
عليك الترقية إلى أحدث حزمة تطوير برامج (SDK) لـ "مصادقة Firebase" على Android (الإصدار 20.0.0 على الأقل) لمواصلة استخدام عملية تنفيذ مسار OAuth في تطبيقاتك على Android.
هل تتأثر إجراءات البريد الإلكتروني في "مصادقة Firebase" على تطبيقات الويب؟
لا، لا يؤثر إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا إلا في معالجة عناوين URL الواردة على الأجهزة الجوّالة.
كيف تتأثر عمليات التنفيذ التي تستخدم مكتبات حزمة تطوير البرامج (SDK) لـ Firebase JS لمصادقة موفّري OAuth في تطبيق Cordova؟
تستخدم حزمة تطوير البرامج (SDK) لـ Firebase JS ميزة "روابط Firebase الديناميكية" لتنفيذ مسارات مصادقة OAuth في تطبيقات Cordova. عليك تعديل عملية تنفيذ المسار من خلال تنفيذ مسار OAuth يدويًا وتمرير بيانات اعتماد OAuth الناتجة إلى Firebase لإكمال مسار المصادقة.
يُرجى الاطّلاع على دليل Cordova لمزيد من التفاصيل.
ما هي بعض الخيارات البديلة لميزة "روابط Firebase الديناميكية"؟
يُرجى الاطّلاع على السؤال الشائع "كيف يمكنني نقل البيانات من الخدمة؟" الذي يوضّح سيناريوهات نقل البيانات المختلفة ويقدّم أدلة نقل البيانات لمختلف البدائل المتاحة.