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

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

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

قم بإعداد Firebase وDynamic Links SDK

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

1. قم بتثبيت وتهيئة Firebase SDKs for Flutter إذا لم تكن قد قمت بذلك بالفعل.

2. من الدليل الجذر لمشروع Flutter الخاص بك، قم بتشغيل الأمر التالي لتثبيت المكون الإضافي Dynamic Links:

   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 لإنشاء روابط ديناميكية باستخدام أي من المعلمات المدعومة. راجع مرجع 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