إنشاء روابط ديناميكية في تطبيق 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