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

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

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

הגדר את Firebase ואת ה-SDK של Dynamic Links

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

1. התקן ואתחל את ערכות ה-SDK של Firebase עבור Flutter אם עדיין לא עשית זאת.

2. מתוך ספריית השורש של פרויקט Flutter שלך, הפעל את הפקודה הבאה כדי להתקין את הפלאגין Dynamic Links:

   flutter pub add firebase_dynamic_links
   

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

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

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

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

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

      ראה אפשר דפוסי כתובות אתרים ספציפיים .

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

כדי ליצור קישור דינמי, צור אובייקט 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 לשיטת buildShortLink() :

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

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

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

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

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