יצירת קישורים דינמיים באפליקציית Flutter

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

https://example.com/link/WXYZ
https://example.page.link/WXYZ

הגדרת Firebase ואת ה-SDK של קישורים דינמיים

לפני שתוכלו ליצור קישורים דינמיים באפליקציה ל-Android, עליכם לכלול את Firebase SDK. אם האפליקציה מוגדרת לקבלת קישורים דינמיים, כבר השלמת את השלבים האלה, ואפשר לדלג על הקטע הזה.

1. מתקינים ומפעילים את ערכות Firebase SDK של Flutter, אם עדיין לא עשו זאת.

2. מתיקיית הבסיס של פרויקט Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגין של קישורים דינמיים:

   flutter pub add firebase_dynamic_links
   

3. אם בונים אפליקציה ל-Android, פותחים את הגדרות הפרויקט במסוף Firebase ולוודא שציינתם את ה-SHA-1 מפתח החתימה. אם משתמשים בקישורים לאפליקציות, צריך לציין גם את מפתח SHA-256.

4. במסוף Firebase, פותחים את הקטע קישורים דינמיים.

   1. אם עדיין לא הגדרתם דומיין לקישורים הדינמיים, לוחצים על שנתחיל? ופועלים לפי ההנחיות.

      אם כבר יש לכם דומיין של קישורים דינמיים, כדאי לשים לב אליו. צריך לציין דומיין של קישורים דינמיים כשיוצרים קישורים דינמיים באופן פרוגרמטי.

   2. מומלצים: מתוך 'עוד' (⋮), ציון כתובת האתר דפוסים שמותרים בקישורי העומק ובקישורי הגיבוי. כך, אתה מונע מגורמים לא מורשים ליצור קישורים דינמיים שמפנים מחדש מהדומיין שלך לאתרים שאין לך שליטה עליהם.

      מידע נוסף זמין בקטע התרת תבניות URL ספציפיות.

יצירת קישור דינמי מפרמטרים

כדי ליצור קישור דינמי, יוצרים אובייקט DynamicLinkParameters חדש ומעבירים אותו אל buildLink() או buildShortLink().

הדוגמה המינימלית הבאה יוצרת קישור דינמי ארוך כדי https://www.example.com/ שנפתח באמצעות com.example.app.android ב-Android ואת האפליקציה com.example.app.ios ב-iOS:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildLink(dynamicLinkParams);

כדי ליצור קישור דינמי קצר, מעבירים את האובייקט DynamicLinkParameters אל buildShortLink(). כדי ליצור את הקישור המקוצר נדרשת שיחת רשת. לדוגמה:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

כברירת מחדל, קישורים דינמיים קצרים נוצרים עם סיומות שהן רק כמה סיומות באורך של תווים. למרות שזה הופך את הקישורים לקומפקטיים יותר, הוא גם מספק האפשרות שמישהו יוכל לנחש קישור קצר תקין. לעיתים קרובות אין נזק אם מישהו עושה זאת, מפני שהקישור מוביל למידע ציבורי.

עם זאת, אם הקישורים הקצרים מובילים למידע ספציפי למשתמש, כדאי ליצור קישורים ארוכים יותר עם סיומת של 17 תווים, כך שסביר מאוד שאי אפשר יהיה לנחש קישור דינמי תקין. כדי לעשות זאת, צריך להעביר את ShortDynamicLinkType.unguessable ל-method buildShortLink():

final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
    dynamicLinkParams,
    shortLinkType: ShortDynamicLinkType.unguessable,
);

פרמטרים של קישור דינמי

אפשר להשתמש ב-Dynamic Link Builder API כדי ליצור קישורים דינמיים עם כל אחד פרמטרים נתמכים. הפניית API

הדוגמה הבאה יוצרת קישור דינמי עם כמה פרמטרים נפוצים set:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(
    packageName: "com.example.app.android",
    minimumVersion: 30,
  ),
  iosParameters: const IOSParameters(
    bundleId: "com.example.app.ios",
    appStoreId: "123456789",
    minimumVersion: "1.0.1",
  ),
  googleAnalyticsParameters: const GoogleAnalyticsParameters(
    source: "twitter",
    medium: "social",
    campaign: "example-promo",
  ),
  socialMetaTagParameters: SocialMetaTagParameters(
    title: "Example of a Dynamic Link",
    imageUrl: Uri.parse("https://example.com/image.png"),
  ),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

אפשר להגדיר פרמטרים של קישור דינמי באמצעות השיטות הבאות:

https://example.com/link
https://example.page.link