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

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

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

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

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

1. ثبِّت حِزم Firebase SDK لـ 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,
);

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

يمكنك استخدام واجهة برمجة التطبيقات 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);

يمكنك ضبط مَعلمات الروابط الديناميكية باستخدام الطرق التالية:

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