ایجاد پیوندهای پویا در برنامه Flutter

می‌توانید با Firebase Dynamic Links Builder API، «پیوندهای پویای» کوتاه یا بلند ایجاد کنید. این API یا یک Dynamic Link طولانی را می‌پذیرد یا شیئی حاوی پارامترهای Dynamic Link، و نشانی‌های وبی مانند نمونه‌های زیر را برمی‌گرداند:

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

راه‌اندازی Firebase و کیت توسعه نرم‌افزار پیوندهای پویا

قبل‌از اینکه بتوانید «پیوندهای پویا» را در برنامه Android خود ایجاد کنید، باید کیت توسعه نرم‌افزار Firebase را اضافه کنید. اگر برنامه‌تان برای دریافت «پیوندهای پویا» راه‌اندازی شده است، قبلاً این مراحل را تکمیل کرده‌اید و می‌توانید از این بخش رد شوید.

1. اگر قبلاً این کار را نکرده‌اید، کیت‌های توسعه نرم‌افزار Firebase برای Flutter را نصب و مقداردهی اولیه کنید.

2. از دایرکتوری ریشه پروژه Flutter، فرمان زیر را اجرا کنید تا افزونه «پیوندهای پویا» نصب شود:

   flutter pub add firebase_dynamic_links
   

3. اگر درحال ساختن برنامه Android هستید، صفحه تنظیمات پروژه کنسول Firebase را باز کنید و مطمئن شوید کلید امضای SHA-1 خود را مشخص کرده‌اید. اگر از «پیوندهای برنامه» استفاده می‌کنید، کلید SHA-256 خود را نیز مشخص کنید.

4. در کنسول Firebase، بخش پیوندهای پویا را باز کنید.

   1. اگر هنوز دامنه‌ای برای «پیوندهای پویا» خود راه‌اندازی نکرده‌اید، روی دکمه شروع به کار کلیک کنید و پیام‌واره‌ها را دنبال کنید.

      اگر ازقبل دامنه Dynamic Links دارید، آن را یادداشت کنید. وقتی «پیوندهای پویا» را به‌صورت برنامه‌نویسی‌شده ایجاد می‌کنید، باید دامنه «پیوندهای پویا» را ارائه دهید.

   2. توصیه‌شده: از منو «بیشتر» (⋮)، الگوهای نشانی وب مجاز در پیوندهای عمیق و پیوندهای بازگشتی را مشخص کنید. با انجام این کار، از ایجاد «پیوندهای پویا» توسط طرف‌های غیرمجاز که از دامنه شما به سایت‌هایی که تحت کنترل شما نیستند تغییرمسیر می‌دهند جلوگیری می‌کنید.

      مجاز کردن الگوهای نشانی وب خاص را ببینید.

ایجاد پیوند پویا از پارامترها

برای ایجاد Dynamic Link، شیء 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);

به‌طور پیش‌فرض، «پیوندهای پویای» کوتاه با پسوندهایی تولید می‌شوند که فقط چند نویسه طول دارند. اگرچه این کار باعث می‌شود پیوندها فشرده‌تر شوند، اما این احتمال را نیز به‌وجود می‌آورد که شخصی بتواند پیوند کوتاه معتبری را حدس بزند. اغلب، اگر کسی این کار را انجام دهد، ضرری ندارد، زیرا پیوند به اطلاعات عمومی منتهی می‌شود.

بااین‌حال، اگر پیوندهای کوتاه شما به اطلاعات مختص کاربر منتهی می‌شود، باید پیوندهای طولانی‌تری با پسوندهای ۱۷ نویسه‌ای ایجاد کنید تا احتمال اینکه کسی بتواند «پیوند پویای» معتبری را حدس بزند بسیار کم شود. برای انجام این کار، ShortDynamicLinkType.unguessable را به روش buildShortLink() ارسال کنید:

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

پارامترهای پیوند پویا

می‌توانید از 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);

می‌توانید پارامترهای Dynamic Link را با روش‌های زیر تنظیم کنید:

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