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

شما می‌توانید با استفاده از API سازنده لینک‌های پویای Firebase، لینک‌های پویای کوتاه یا بلند ایجاد کنید. این API یا یک لینک پویای بلند یا یک شیء حاوی پارامترهای لینک پویا را می‌پذیرد و URLهایی مانند مثال‌های زیر را برمی‌گرداند:

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

فایربیس و SDK لینک‌های پویا را راه‌اندازی کنید

قبل از اینکه بتوانید لینک‌های پویا (Dynamic Links) را در برنامه اندروید خود ایجاد کنید، باید Firebase SDK را وارد کنید. اگر برنامه شما برای دریافت لینک‌های پویا (Dynamic Links) تنظیم شده است، این مراحل را قبلاً انجام داده‌اید و می‌توانید از این بخش صرف نظر کنید.

1. اگر قبلاً SDK های Firebase را برای Flutter نصب و مقداردهی اولیه نکرده‌اید، این کار را انجام دهید.

2. از دایرکتوری ریشه پروژه Flutter خود، دستور زیر را برای نصب افزونه Dynamic Links اجرا کنید:

   flutter pub add firebase_dynamic_links
   

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

4. در کنسول فایربیس، بخش Dynamic Links را باز کنید.

   1. اگر هنوز دامنه‌ای برای Dynamic Links خود تنظیم نکرده‌اید، روی دکمه‌ی Get Started کلیک کنید و دستورالعمل‌ها را دنبال کنید.

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

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

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

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

برای ایجاد یک پیوند پویا، یک شیء DynamicLinkParameters جدید ایجاد کنید و آن را به buildLink() یا buildShortLink() ارسال کنید.

مثال مینیمال زیر یک پیوند پویای طولانی به https://www.example.com/ ایجاد می‌کند که در اندروید با com.example.app.android و در iOS با برنامه com.example.app.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,
);

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

شما می‌توانید از API سازنده لینک پویا برای ایجاد لینک‌های پویا با هر یک از پارامترهای پشتیبانی شده استفاده کنید. به مرجع 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