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

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 Zezwalanie na określone wzorce adresów URL.

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 przyrostkami 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 zmniejszają prawdopodobieństwo odgadnięcia prawidłowego linku dynamicznego. Aby to zrobić, prześlij parametr ShortDynamicLinkType.unguessable do metody buildShortLink():

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

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ć na 2 sposoby:

Parametry DynamicLink
setLink Link, który otwiera aplikacja. Podaj adres URL, który może obsłużyć Twoja aplikacja. Zwykle jest to treść lub ładunek aplikacji, który inicjuje logikę związaną z aplikacją (np. przyznawanie użytkownikowi kuponu lub wyświetlanie ekranu powitalnego). Link musi być poprawnie sformatowanym adresem URL, prawidłowo zakodowanym adresem URL, zawierać protokół HTTP lub HTTPS i nie może być innym linkiem dynamicznym.
setDomainUriPrefix prefiks adresu URL Linku dynamicznego, który znajdziesz w konsoli Firebase; Domena dynamicznego linku wygląda tak: 
https://example.com/link
https://example.page.link
AndroidParameters
setFallbackUrl Link do otwarcia, gdy aplikacja nie jest zainstalowana. Wpisz tę wartość, aby wykonać inną czynność niż instalacja aplikacji ze Sklepu Play, gdy aplikacja nie jest zainstalowana, np. otworzyć wersję mobilną treści w przeglądarce lub wyświetlić stronę promocyjną aplikacji.
setMinimumVersion Kod wersji minimalnej wersji aplikacji, która może otworzyć link. Jeśli zainstalowana aplikacja jest starszej wersji, użytkownik zostanie przekierowany do Sklepu Play, aby zaktualizować aplikację.
IosParameters
setAppStoreId Identyfikator aplikacji w App Store, który służy do wysyłania użytkowników do App Store, gdy aplikacja nie jest zainstalowana
setFallbackUrl Link do otwarcia, gdy aplikacja nie jest zainstalowana. Określ tę wartość, aby wykonać inną czynność niż instalacja aplikacji ze sklepu App Store, gdy aplikacja nie jest zainstalowana, np. otworzyć wersję mobilną treści w przeglądarce lub wyświetlić stronę promocyjną aplikacji.
setCustomScheme niestandardowy schemat adresów URL aplikacji, jeśli jest zdefiniowany jako inny niż identyfikator pakietu aplikacji;
setIpadFallbackUrl Link do otwarcia na iPadach, gdy aplikacja nie jest zainstalowana. Określ to, aby wykonać inną czynność niż zainstalowanie aplikacji z App Store, gdy aplikacja nie jest zainstalowana, np. otworzyć wersję internetową treści lub wyświetlić stronę promocyjną aplikacji.
setIpadBundleId Identyfikator pakietu aplikacji na iOS, której należy używać na iPadach do otwierania linku. Aplikacja musi być połączona z Twoim projektem na stronie Przegląd w konsoli Firebase.
setMinimumVersion Numer wersji aplikacji, która może otworzyć link. Ten parametr jest przekazywany do aplikacji po jej otwarciu, a ona musi zdecydować, co z nim zrobić.
NavigationInfoParameters
setForcedRedirectEnabled Jeśli wartość to 1, po otwarciu linku dynamicznego pomiń stronę podglądu aplikacji i przekieruj użytkownika do aplikacji lub sklepu. Strona podglądu aplikacji (domyślnie włączona) może niezawodnie kierować użytkowników na najbardziej odpowiednią stronę po otwarciu linku dynamicznego w aplikacji. Jeśli jednak chcesz, aby link dynamiczny otwierał się tylko w aplikacji, która może niezawodnie otwierać linki dynamiczne bez tej strony, możesz wyłączyć tę stronę za pomocą tego parametru. Ten parametr będzie miał wpływ na działanie Dynamic Link tylko na iOS.
SocialMetaTagParameters
setTitle Tytuł, który ma być używany, gdy Dynamic Link jest udostępniany w postach w mediach społecznościowych.
setDescription Opis, który ma być używany, gdy Dynamic Link jest udostępniany w postach w mediach społecznościowych.
setImageUrl Adres URL obrazu powiązanego z tym linkiem. Obraz powinien mieć co najmniej 300 x 200 pikseli i nie więcej niż 300 KB.
GoogleAnalyticsParameters
setSource
setMedium
setCampaign
setTerm
setContent		 Parametry Google Play. Te parametry (utm_source, utm_medium, utm_campaign, utm_term, utm_content) są przekazywane do Sklepu Play, a także dołączane do ładunku linku.
ItunesConnectAnalyticsParameters
setProviderToken
setAffiliateToken
setCampaignToken		 Parametry analityczne iTunes Connect. Te parametry (pt, at, ct) są przekazywane do App Store.