Twórz linki dynamiczne w aplikacji Flutter

Możesz tworzyć krótkie lub długie linki dynamiczne za pomocą interfejsu API Firebase Dynamic Links Builder. Ten interfejs API akceptuje albo długi link dynamiczny, albo obiekt zawierający parametry łącza dynamicznego i zwraca adresy URL, takie jak poniższe przykłady:

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

Skonfiguruj Firebase i pakiet SDK Linków dynamicznych

Zanim będziesz mógł utworzyć linki dynamiczne w aplikacji na Androida, musisz dołączyć pakiet SDK Firebase. Jeśli Twoja aplikacja jest skonfigurowana do otrzymywania linków dynamicznych, wykonałeś już te kroki i możesz pominąć tę sekcję.

1. Zainstaluj i zainicjuj zestawy SDK Firebase dla Flutter, jeśli jeszcze tego nie zrobiłeś.

2. Z katalogu głównego projektu Flutter uruchom następujące polecenie, aby zainstalować wtyczkę Dynamic Links:

   flutter pub add firebase_dynamic_links
   

3. Jeśli tworzysz aplikację na Androida, otwórz stronę Ustawienia projektu w konsoli Firebase i upewnij się, że podałeś klucz podpisywania SHA-1. Jeśli korzystasz z łączy aplikacji, podaj także klucz SHA-256.

4. W konsoli Firebase otwórz sekcję Linki dynamiczne .

   1. Jeśli nie skonfigurowałeś jeszcze domeny dla swoich łączy dynamicznych, kliknij przycisk Rozpocznij i postępuj zgodnie z instrukcjami.

      Jeśli masz już domenę Dynamic Links, zwróć na to uwagę. Podczas programowego tworzenia łączy dynamicznych musisz podać domenę łączy dynamicznych.

   2. Zalecane : w menu „Więcej” (⋮) określ wzorce adresów URL dozwolone w precyzyjnych linkach i linkach zastępczych. W ten sposób uniemożliwiasz nieupoważnionym osobom tworzenie linków dynamicznych przekierowujących z Twojej domeny do witryn, nad którymi nie masz kontroli.

      Zobacz Zezwalaj na określone wzorce adresów URL .

Utwórz łącze dynamiczne na podstawie parametrów

Aby utworzyć łącze dynamiczne, utwórz nowy obiekt DynamicLinkParameters i przekaż go do buildLink() lub buildShortLink() .

Poniższy minimalny przykład tworzy długi link dynamiczny do https://www.example.com/ , który otwiera się za pomocą com.example.app.android na Androidzie i aplikacji com.example.app.ios na 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);

Aby utworzyć krótkie łącze dynamiczne, przekaż obiekt DynamicLinkParameters do buildShortLink() . Budowa krótkiego łącza wymaga połączenia sieciowego. Na przykład:

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

Domyślnie generowane są krótkie linki dynamiczne z przyrostkami składającymi się tylko z kilku znaków. Chociaż sprawia to, że linki są bardziej zwarte, stwarza to również możliwość odgadnięcia prawidłowego krótkiego linku. Często nie dzieje się nic złego, jeśli ktoś to zrobi, ponieważ link prowadzi do informacji publicznej.

Jeśli jednak krótkie linki prowadzą do informacji specyficznych dla użytkownika, należy utworzyć dłuższe linki z 17-znakowymi sufiksami, które sprawią, że odgadnięcie prawidłowego łącza dynamicznego będzie bardzo mało prawdopodobne. W tym celu przekaż ShortDynamicLinkType.unguessable do metody buildShortLink() :

final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
    dynamicLinkParams,
    shortLinkType: ShortDynamicLinkType.unguessable,
);

Parametry łącza dynamicznego

Możesz użyć interfejsu API narzędzia Dynamic Link Builder do tworzenia łączy dynamicznych z dowolnymi obsługiwanymi parametrami. Zobacz dokumentację API .

Poniższy przykład tworzy łącze dynamiczne z kilkoma wspólnymi zestawami parametrów:

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

Parametry łącza dynamicznego można ustawić następującymi metodami:

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