تصحيح أخطاء الروابط الديناميكية

مخطّط بياني لصفحة المعاينة

لمساعدتك في تصحيح أخطاء Dynamic Links، يمكنك معاينة سلوك Dynamic Links على الأنظمة الأساسية والإعدادات المختلفة باستخدام مخطط تدفق يتم إنشاؤه تلقائيًا. أنشئ المخطط الانسيابي عن طريق إضافة المَعلمة d=1 إلى أي Dynamic Link قصير أو طويل. على سبيل المثال، example.page.link/suffix?d=1 لDynamic Link قصير.

تظهر صفحة المعاينة على النحو التالي:

لقطة شاشة لصفحة المعاينة

أداة التشخيص الذاتي لنظام التشغيل iOS

إذا كنت تواجه مشاكل في دمج Dynamic Link على نظام التشغيل iOS، استخدِم أداة التشخيص الذاتي المضمّنة في الإصدار 2.1.0 من حزمة Dynamic Links SDK والإصدارات الأحدث.

يمكن استدعاء الأداة من أي مكان في الرمز البرمجي على النحو التالي.

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS أو Mac Catalyst أو tvOS أو watchOS.
DynamicLinks.performDiagnostics(completion: nil)

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS أو Mac Catalyst أو tvOS أو watchOS.
[FIRDynamicLinks performDiagnosticsWithCompletion:nil];

تطبع الأداة تلقائيًا معلومات تصحيح الأخطاء، بما في ذلك أي أخطاء تم رصدها، في المخرج العادي. على سبيل المثال، لنفترض أنّ تطبيقك المتوافق مع نظام التشغيل iOS لا يتلقّى Dynamic Links كما هو متوقّع. ستعرض أداة التشخيص الذاتي معلومات مثل:

---- Firebase Dynamic Links diagnostic output start ----
Firebase Dynamic Links framework version 2.1.0
System information: OS iOS, OS version 11.0, model iPhone
Current date 2017-08-14 22:52:56 +0000
AutomaticRetrievalEnabled: YES
ERROR: Specified custom URL scheme is com.google.AppInvitesSample.dev but Info.plist do not contain such scheme in CFBundleURLTypes key.
AppID Prefix: EQHXZ8M8AV, Team ID: EQHXZ8M8AV, AppId Prefix equal to Team ID: YES
performDiagnostic detected 1 ERRORS.
---- Firebase Dynamic Links diagnostic output end ----

في هذا المثال، لا يعمل الإجراء Dynamic Links لأنّه لم يتم ضبط مخطّط عنوان URL المخصّص بشكل صحيح.

الأخطاء والتحذيرات الشائعة

لا يتضمّن تطبيق Android خوارزمية SHA256. لم يتم تفعيل رابط AppLinks للتطبيق.

لاستخدام روابط تطبيقات Android مع تطبيقك، عليك إنشاء شهادة SHA256.

بعد إنشاء شهادة SHA256، أضِفها إلى تطبيقك في وحدة تحكّم Firebase. راجِع مقالة إضافة بصمة إصبع SHA.

تعذّر العثور على اسم حزمة Android‏ "com.example" و/أو رقم تعريف حزمة iOS‏ "com.example".

لاستخدام Dynamic Links مع تطبيق Android أو iOS، عليك إضافة تطبيقك إلى مشروعك على Firebase. اطّلِع على إضافة تطبيق.

لا يتضمّن تطبيق iOS رقم تعريف الفريق. لم يتم تفعيل UniversalLinks للتطبيق.

لاستخدام الروابط الشاملة مع تطبيقك، يجب إضافة رقم تعريف فريق في وحدة تحكّم Firebase. راجِع مقالة إضافة رقم تعريف متجر تطبيقات أو رقم تعريف فريق.

يمكنك العثور على رقم تعريف الفريق في Apple Member Center ضمن علامة التبويب "الاشتراك".

لا يتوفّر رقم تعريف متجر iOS في معرّف حزمة iOS المحدّد. سأتخطّى هذه الخطوة.

هذا يعني أنّ التطبيق المدرَج في https://itunes.apple.com/us/app/yourapp/idSTOREID لا يتضمّن معرّف الحزمة المحدّد.

مخطّط مخصّص غير صالح لنظام التشغيل iOS

يجب أن يبدأ المخطّط المخصّص بحرف أبجدي (A-Z أو a-z) ويمكن أن يليه أي عدد من الأحرف الأبجدية الرقمية أو + أو - أو .. ولا يمكن أن يكون أيًا مما يلي: "javascript" أو "vbscript" أو "data" أو "blob" أو "http" أو "https" أو "mailto" أو "livescript" أو "facetime" أو "facetime-audio".

لم يتم إعداد "الروابط الديناميكية" في مشروعك

لبدء استخدام الروابط الديناميكية، عليك تفعيلها لمشروعك في وحدة تحكّم Firebase.

هل تريد شيء آخر؟

إذا واجهت مشكلة مختلفة، يُرجى الاطّلاع على صفحة دعم Firebase.