إنشاء روابط ديناميكية في تطبيق Flutter

يمكنك إنشاء روابط ديناميكية قصيرة أو طويلة باستخدام واجهة برمجة التطبيقات الخاصة بأداة إنشاء "روابط Firebase الديناميكية". تقبل واجهة برمجة التطبيقات هذه إما رابطًا طويلاً لـ Dynamic Link أو عنصرًا يحتوي على مَعلمات Dynamic Link، وتعرض عناوين URL مثل الأمثلة التالية:

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

إعداد Firebase وحزمة تطوير البرامج (SDK) لـ "الروابط الديناميكية"

قبل أن تتمكّن من إنشاء روابط ديناميكية في تطبيق Android، عليك تضمين حزمة تطوير البرامج (SDK) من Firebase. إذا كان تطبيقك معدًا لتلقّي روابط ديناميكية، تكون قد أكملت هذه الخطوات ويمكنك تخطّي هذا القسم.

1. ثبِّت حِزم تطوير البرامج (SDK) من Firebase لنظام Flutter وأعِد ضبطها إذا لم يسبق لك إجراء ذلك.

2. من دليل الجذر لمشروع Flutter، نفِّذ الأمر التالي لتثبيت المكوّن الإضافي "روابط ديناميكية":

   flutter pub add firebase_dynamic_links
   

3. إذا كنت بصدد إنشاء تطبيق Android، افتح صفحة إعدادات المشروع في "وحدة تحكّم Firebase" وتأكَّد من أنّك حدّدت مفتاح التوقيع SHA-1. إذا كنت تستخدم روابط التطبيقات، عليك أيضًا تحديد مفتاح SHA-256.

4. في وحدة تحكّم Firebase، افتح قسم روابط ديناميكية.

   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);

لإنشاء رابط مختصر من نوع Dynamic Link، مرِّر العنصر 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 لإنشاء روابط ديناميكية تتضمّن أيًا من المَعلمات المتوافقة. يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.

ينشئ المثال التالي رابطًا ديناميكيًا مع ضبط عدّة مَعلمات شائعة:

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