ניפוי באגים בקישורים דינמיים

הוצא משימוש: הקישורים הדינמיים ב-Firebase הוצאו משימוש, ולא מומלץ להשתמש בהם בפרויקטים שעדיין לא נעשה בהם שימוש. השירות יושבת ב-25 באוגוסט 2025. מידע נוסף זמין במאמר שאלות נפוצות בנושא הוצאה משימוש של קישורים דינמיים.

תרשים זרימה של דף בתצוגה מקדימה

כדי לעזור לכם לנפות באגים ב-Dynamic Links, אתם יכולים להציג בתצוגה מקדימה את ההתנהגות של Dynamic Links בפלטפורמות ובתצורות שונות באמצעות תרשים זרימה שנוצר באופן אוטומטי. כדי ליצור את תרשים הזרימה, מוסיפים את הפרמטר d=1 לכל Dynamic Link קצר או ארוך. לדוגמה, example.page.link/suffix?d=1 לסרט קצר Dynamic Link.

דף התצוגה המקדימה נראה כך:

כלי לאבחון עצמי ב-iOS

אם נתקלתם בבעיות בשילוב של Dynamic Link ב-iOS, אתם יכולים להשתמש בכלי לאבחון עצמי שמוטמע ב-Dynamic Links SDK בגרסה 2.1.0 ואילך.

אפשר להפעיל את הכלי מכל מקום בקוד באופן הבא.

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 המותאמת אישית לא מוגדרת בצורה נכונה.

הערה: כדאי להעתיק את הפלט של כלי האבחון העצמי כשפונים לתמיכה של Firebase כדי שנוכל לעזור לכם בצורה טובה יותר.

שגיאות ואזהרות נפוצות

באפליקציית 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, בכרטיסייה Membership.

מזהה החנות ל-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.