Tworzenie linków dynamicznych w aplikacji Flutter

Za pomocą interfejsu Firebase Dynamic Links Builder API możesz tworzyć krótkie lub długie Linki dynamiczne Firebase. Ten interfejs API akceptuje długi link dynamiczny lub obiekt zawierający parametry linku dynamicznego i zwraca adresy URL, takie jak w tych przykładach:

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

Konfiguracja Firebase i pakietu Dynamic Links SDK

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

1. Zainstaluj i zainicjuj pakiety SDK Firebase dla Flutter, jeśli jeszcze nie zostało to zrobione.

2. Aby zainstalować wtyczkę Linki dynamiczne, w katalogu głównym projektu Flutter 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 podany klucz podpisywania SHA-1. Jeśli używasz linków do aplikacji, podaj też klucz SHA-256.

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

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

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

   2. Zalecane: 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.

Tworzenie linku dynamicznego na podstawie parametrów

Aby utworzyć link dynamiczny, 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ę w com.example.app.android na Androidzie i w 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 link dynamiczny, przekaż obiekt DynamicLinkParameters do buildShortLink(). Utworzenie krótkiego linku wymaga wywołania sieciowego. 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 sufiksami, które mają tylko kilka znaków. Dzięki temu linki są bardziej kompaktowe, ale istnieje też możliwość, że ktoś odgadnie prawidłowy krótki link. Często nie ma w tym nic złego, ponieważ link prowadzi do informacji publicznych.

Jeśli jednak krótkie linki prowadzą do informacji o konkretnym użytkowniku, utwórz dłuższe linki z 17-znakowymi sufiksami, aby uniemożliwić odgadnięcie prawidłowego linku dynamicznego. Aby to zrobić, przekaż ShortDynamicLinkType.unguessable do metody 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 dowolnymi obsługiwanymi parametrami. Zapoznaj się z dokumentacją API.

W tym przykładzie tworzony jest 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 linku dynamicznego możesz ustawić za pomocą tych metod:

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