Создайте динамические ссылки в приложении Flutter

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Вы можете создавать короткие или длинные динамические ссылки с помощью API Firebase Dynamic Links Builder. Этот API принимает либо длинную динамическую ссылку, либо объект, содержащий параметры динамической ссылки, и возвращает URL-адреса, как в следующих примерах:

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

Настройка Firebase и Dynamic Links SDK

Прежде чем вы сможете создать динамические ссылки в вашем приложении Android, вы должны включить Firebase SDK. Если ваше приложение настроено на получение динамических ссылок, вы уже выполнили эти шаги и можете пропустить этот раздел.

1. Установите и инициализируйте Firebase SDK для Flutter, если вы еще этого не сделали.

2. Из корневого каталога вашего проекта Flutter выполните следующую команду, чтобы установить плагин Dynamic Links:

   flutter pub add firebase_dynamic_links
   

3. Если вы создаете приложение для Android, откройте страницу настроек проекта в консоли Firebase и убедитесь, что вы указали свой ключ подписи SHA-1. Если вы используете App Links, укажите также свой ключ SHA-256.

4. В консоли Firebase откройте раздел «Динамические ссылки» .

   1. Если вы еще не настроили домен для своих динамических ссылок, нажмите кнопку «Начать» и следуйте инструкциям.

      Если у вас уже есть домен Dynamic Links, примите это к сведению. Вам необходимо предоставить домен Dynamic Links, когда вы программно создаете Dynamic Links.

   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,
);

Параметры динамической ссылки

Вы можете использовать API 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);

Параметры Dynamic Link можно задать следующими способами:

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