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

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

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

Firebase و Dynamic Links SDK را راه اندازی کنید

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

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

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

   flutter pub add firebase_dynamic_links
   

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

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

   1. اگر قبلاً دامنه ای برای پیوندهای پویا خود تنظیم نکرده اید، روی دکمه شروع کار کلیک کرده و دستورات را دنبال کنید.

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

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

      به اجازه الگوهای 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 را به متد buildShortLink() منتقل کنید:

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

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

می توانید از Dynamic Link Builder 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