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

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

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

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

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

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

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

   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