Tworzenie linków dynamicznych w aplikacji Flutter

Korzystając z interfejsu API Firebase Dynamic Links Builder, możesz tworzyć krótkie i długie linki dynamiczne. To API akceptuje długi link dynamiczny lub obiekt zawierający parametry linku dynamicznego i zwraca adresy URL podobne do tych przykładów:

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

Konfiguracja Firebase i pakietu SDK Linków dynamicznych

Zanim utworzysz w aplikacji na Androida linki dynamiczne, musisz dodać pakiet SDK Firebase. Jeśli Twoja aplikacja jest skonfigurowana do odbierania linków dynamicznych, te czynności zostały już przez Ciebie wykonane, więc możesz pominąć tę sekcję.

1. Zainstaluj i inicjuj pakiety SDK Firebase dla Fluttera (jeśli nie zostało to jeszcze zrobione).

2. Aby zainstalować w katalogu głównym projektu Flutter wtyczkę Linki dynamiczne, uruchom to polecenie:

   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 masz określony klucz podpisywania SHA-1. Jeśli używasz linków aplikacji, podaj też klucz SHA-256.

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

   1. Jeśli nie masz jeszcze skonfigurowanej domeny dla dynamicznych linków, kliknij przycisk Rozpocznij i postępuj zgodnie z wyświetlanymi instrukcjami.

      Jeśli masz już domenę Dynamic Links, zanotuj ją. Podczas tworzenia linków dynamicznych automatycznie musisz podać domenę Linków dynamicznych.

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

      Zobacz artykuł Zezwalanie na określone wzorce adresów URL.

Tworzenie linku dynamicznego na podstawie parametrów

Aby utworzyć Dynamic Link, utwórz nowy obiekt DynamicLinkParameters i przekaż go do buildLink() lub buildShortLink().

Ten minimalny przykład tworzy długi Dynamic Link 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ótki Dynamic Link, prześlij obiekt DynamicLinkParameters do funkcji buildShortLink(). Utworzenie krótkiego linku wymaga wywołania sieci. 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 krótkie linki dynamiczne są generowane z przyrostami składającymi się z zaledwie kilku znaków. Dzięki temu linki są bardziej zwarte, ale istnieje też możliwość, że ktoś zgadnie prawidłowy link krótki. Często nie ma to znaczenia, ponieważ link prowadzi do informacji publicznych.

Jeśli jednak Twoje krótkie linki prowadzą do informacji dotyczących konkretnego użytkownika, utwórz dłuższe linki z 17-znakowymi przyrostkami, które znacznie zmniejszą prawdopodobieństwo odgadnięcia prawidłowego linku dynamicznego. Aby to zrobić, przekaż parametr ShortDynamicLinkType.unguessable metodzie buildShortLink():

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

Parametry linku dynamicznego

Za pomocą interfejsu Dynamic Link Builder API możesz tworzyć linki dynamiczne z użyciem dowolnych obsługiwanych parametrów. Zapoznaj się z dokumentacją interfejsu API.

W tym przykładzie tworzymy link dynamiczny z kilkoma typowymi parametrami:

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 Dynamic Link możesz ustawić za pomocą tych metod:

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