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

يمكنك إنشاء روابط ديناميكية قصيرة أو طويلة باستخدام واجهة برمجة تطبيقات أداة إنشاء الروابط الديناميكية على Firebase. تقبل واجهة برمجة التطبيقات هذه رابطًا ديناميكيًا طويل أو عنصرًا يحتوي على رابط ديناميكي. وتعرض عناوين 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);

لإنشاء رابط ديناميكي قصير، مرِّر كائن 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,
);

مَعلمات الروابط الديناميكية

يمكنك استخدام واجهة برمجة تطبيقات أداة إنشاء الروابط الديناميكية لإنشاء روابط ديناميكية باستخدام أي من والمعلمات المدعومة. يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات.

ينشئ المثال التالي رابطًا ديناميكيًا به عدة معلمات شائعة. مجموعة:

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