Dynamische Links in einer Flutter-App erstellen

Mit der Firebase Dynamic Links Builder API können Sie kurze oder lange dynamische Links erstellen. Diese API akzeptiert entweder einen langen dynamischen Link oder ein Objekt mit Parametern für dynamische Links und gibt URLs wie die folgenden Beispiele zurück:

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

Firebase und das Dynamic Links SDK einrichten

Bevor Sie Dynamic Links in Ihrer Android-App erstellen können, müssen Sie das Firebase SDK einbinden. Wenn Ihre App für den Empfang von Dynamic Links eingerichtet ist, haben Sie diese Schritte bereits ausgeführt und können diesen Abschnitt überspringen.

1. Installieren und initialisieren Sie die Firebase SDKs für Flutter, falls noch nicht geschehen.

2. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Dynamic Links-Plug-in zu installieren:

   flutter pub add firebase_dynamic_links
   

3. Wenn Sie eine Android-App erstellen, öffnen Sie in der Firebase Console die Seite Projekteinstellungen und prüfen Sie, ob Sie Ihren SHA-1-Signaturschlüssel angegeben haben. Wenn Sie App-Links verwenden, geben Sie auch Ihren SHA-256-Schlüssel an.

4. Öffnen Sie in der Firebase Console den Bereich Dynamic Links.

   1. Wenn Sie noch keine Domain für Ihre Dynamic Links eingerichtet haben, klicken Sie auf Jetzt starten und folgen Sie der Anleitung.

      Wenn Sie bereits eine Dynamic Links-Domain haben, notieren Sie sich diese. Wenn Sie Dynamic Links programmatisch erstellen, müssen Sie eine Dynamic Links-Domain angeben.

   2. Empfohlen: Geben Sie im Dreipunkt-Menü (⋮) die URL-Muster an, die in Ihren Deeplinks und Fallback-Links zulässig sind. So verhindern Sie, dass Unbefugte Dynamic Links erstellen, die von Ihrer Domain zu Websites weiterleiten, die Sie nicht verwalten.

      Weitere Informationen finden Sie unter Bestimmte URL-Muster zulassen.

Dynamic Link aus Parametern erstellen

Wenn Sie einen Dynamic Link erstellen möchten, erstellen Sie ein neues DynamicLinkParameters-Objekt und übergeben Sie es an buildLink() oder buildShortLink().

Im folgenden Minimalbeispiel wird ein langer dynamischer Link zu https://www.example.com/ erstellt, der unter Android mit com.example.app.android und unter iOS mit der App com.example.app.ios geöffnet wird:

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

Wenn Sie einen kurzen dynamischen Link erstellen möchten, übergeben Sie das DynamicLinkParameters-Objekt an buildShortLink(). Zum Erstellen des Kurzlinks ist ein Netzwerkaufruf erforderlich. Beispiel:

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

Standardmäßig werden kurze dynamische Links mit Suffixen generiert, die nur wenige Zeichen lang sind. Dadurch werden Links zwar kompakter, es besteht jedoch auch die Möglichkeit, dass jemand einen gültigen Kurzlink errät. Oft ist es kein Problem, wenn jemand das tut, da der Link zu öffentlichen Informationen führt.

Wenn Ihre Kurzlinks jedoch zu nutzerspezifischen Informationen führen, sollten Sie längere Links mit 17-stelligen Suffixen erstellen, damit es sehr unwahrscheinlich ist, dass jemand einen gültigen Dynamic Link erraten kann. Übergeben Sie dazu ShortDynamicLinkType.unguessable an die Methode buildShortLink():

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

Parameter für dynamische Links

Mit der Dynamic Link Builder API können Sie Dynamic Links mit allen unterstützten Parametern erstellen. Siehe API-Referenz.

Im folgenden Beispiel wird ein dynamischer Link mit mehreren gängigen Parametern erstellt:

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

Sie können Parameter für dynamische Links mit den folgenden Methoden festlegen:

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