Erstellen Sie dynamische Links in einer Flutter-App

Veraltet: Firebase Dynamic Links ist veraltet und sollte nicht in Projekten übernommen werden, die es noch nicht verwenden. Der Dienst wird am 25. August 2025 eingestellt. Weitere Informationen finden Sie in den FAQ zur Einstellung dynamischer Links .

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 dynamischen Link-Parametern und gibt URLs wie die folgenden Beispiele zurück:

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

Richten Sie Firebase und das Dynamic Links SDK ein

Bevor Sie dynamische Links in Ihrer Android-App erstellen können, müssen Sie das Firebase SDK einbinden. Wenn Ihre App für den Empfang dynamischer 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 Sie dies noch nicht getan haben.

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

   flutter pub add firebase_dynamic_links
   

3. Wenn Sie eine Android-App erstellen, öffnen Sie die Seite „Projekteinstellungen“ der Firebase-Konsole und stellen Sie sicher, dass 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-Konsole den Abschnitt „Dynamische Links“ .

   1. Wenn Sie noch keine Domäne für Ihre dynamischen Links eingerichtet haben, klicken Sie auf die Schaltfläche „Erste Schritte“ und befolgen Sie die Anweisungen.

      Wenn Sie bereits über eine Dynamic Links-Domain verfügen, notieren Sie sich diese. Sie müssen eine Dynamic Links-Domäne angeben, wenn Sie Dynamic Links programmgesteuert erstellen.

   2. Empfohlen : Geben Sie im Menü „Mehr“ (⋮) die URL-Muster an, die in Ihren Deep-Links und Fallback-Links zulässig sind. Auf diese Weise verhindern Sie, dass Unbefugte dynamische Links erstellen, die von Ihrer Domain auf Websites weiterleiten, die nicht von Ihnen kontrolliert werden.

      Siehe Spezifische URL-Muster zulassen .

Erstellen Sie einen dynamischen Link aus Parametern

Um einen dynamischen Link zu erstellen, erstellen Sie ein neues DynamicLinkParameters Objekt und übergeben Sie es an buildLink() oder buildShortLink() .

Das folgende Minimalbeispiel erstellt einen langen dynamischen Link zu https://www.example.com/ , der mit com.example.app.android auf Android und der App com.example.app.ios auf 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);

Um einen kurzen dynamischen Link zu erstellen, übergeben Sie das DynamicLinkParameters Objekt an buildShortLink() . Für den Aufbau der Kurzverbindung ist ein Netzwerkaufruf erforderlich. Zum 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 die Links zwar kompakter, es besteht aber auch die Möglichkeit, dass jemand einen gültigen Kurzlink errät. Oft schadet es nicht, wenn jemand dies tut, da der Link zu öffentlichen Informationen führt.

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

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

Dynamic Link-Parameter

Sie können die Dynamic Link Builder-API verwenden, um dynamische Links mit jedem der unterstützten Parameter zu erstellen. Siehe die API-Referenz .

Das folgende Beispiel erstellt einen dynamischen Link mit mehreren allgemeinen Parametersätzen:

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 Dynamic Link-Parameter mit den folgenden Methoden festlegen:

DynamicLink-Parameter
setLink	Der Link, über den Ihre App geöffnet wird. Geben Sie eine URL an, die Ihre App verarbeiten kann, normalerweise der Inhalt oder die Nutzlast der App, die app-spezifische Logik initiiert (z. B. die Gutschrift eines Gutscheins an den Benutzer oder die Anzeige eines Begrüßungsbildschirms). Dieser Link muss eine gut formatierte URL sein, ordnungsgemäß URL-codiert sein, entweder HTTP oder HTTPS verwenden und darf kein anderer dynamischer Link sein. Wenn Benutzer einen dynamischen Link in einem Desktop-Webbrowser öffnen, laden sie diese URL (es sei denn, der Parameter ofl ist angegeben). Wenn Sie kein Webäquivalent zum verlinkten Inhalt haben, muss die URL nicht auf eine gültige Webressource verweisen. In diesem Fall sollten Sie eine Weiterleitung von dieser URL beispielsweise zu Ihrer Homepage einrichten.
setDomainUriPrefix	Ihr Dynamic Link-URL-Präfix, das Sie in der Firebase-Konsole finden. Eine Dynamic Link-Domäne sieht wie in den folgenden Beispielen aus: https://example.com/link https://example.page.link

AndroidParameter
setFallbackUrl	Der Link, der geöffnet wird, wenn die App nicht installiert ist. Geben Sie dies an, um etwas anderes zu tun, als Ihre App aus dem Play Store zu installieren, wenn die App nicht installiert ist, z. B. die mobile Webversion des Inhalts zu öffnen oder eine Werbeseite für Ihre App anzuzeigen.
setMinimumVersion	Der versionCode der Mindestversion Ihrer App, die den Link öffnen kann. Wenn es sich bei der installierten App um eine ältere Version handelt, wird der Benutzer zum Play Store weitergeleitet, um die App zu aktualisieren.

IosParameters
setAppStoreId	Die App Store-ID Ihrer App, mit der Benutzer zum App Store weitergeleitet werden, wenn die App nicht installiert ist
setFallbackUrl	Der Link, der geöffnet wird, wenn die App nicht installiert ist. Geben Sie dies an, um etwas anderes zu tun, als Ihre App aus dem App Store zu installieren, wenn die App nicht installiert ist, z. B. die mobile Webversion des Inhalts zu öffnen oder eine Werbeseite für Ihre App anzuzeigen.
setCustomScheme	Das benutzerdefinierte URL-Schema Ihrer App, sofern es als etwas anderes als die Bundle-ID Ihrer App definiert ist
setIpadFallbackUrl	Der Link wird auf iPads geöffnet, wenn die App nicht installiert ist. Geben Sie dies an, um etwas anderes zu tun, als Ihre App aus dem App Store zu installieren, wenn die App nicht installiert ist, z. B. die Webversion des Inhalts zu öffnen oder eine Werbeseite für Ihre App anzuzeigen.
setIpadBundleId	Die Bundle-ID der iOS-App, die auf iPads zum Öffnen des Links verwendet werden soll. Die App muss über die Übersichtsseite der Firebase-Konsole mit Ihrem Projekt verbunden sein.
setMinimumVersion	Die Versionsnummer der Mindestversion Ihrer App, die den Link öffnen kann. Dieses Flag wird beim Öffnen an Ihre App übergeben und Ihre App muss entscheiden, was damit geschehen soll.

NavigationInfoParameters

setForcedRedirectEnabled

Bei Einstellung auf „1“ wird die App-Vorschauseite übersprungen, wenn der Dynamic Link geöffnet wird, und stattdessen zur App oder zum Store weitergeleitet. Die App-Vorschauseite (standardmäßig aktiviert) kann Benutzer zuverlässiger zum am besten geeigneten Ziel weiterleiten, wenn sie dynamische Links in Apps öffnen. Wenn Sie jedoch erwarten, dass ein dynamischer Link nur in Apps geöffnet wird, die dynamische Links ohne diese Seite zuverlässig öffnen können, können Sie ihn mit diesem Parameter deaktivieren. Dieser Parameter wirkt sich nur auf iOS auf das Verhalten von Dynamic Link aus.

SocialMetaTagParameters
setTitle	Der Titel, der verwendet werden soll, wenn der dynamische Link in einem sozialen Beitrag geteilt wird.
setDescription	Die Beschreibung, die verwendet werden soll, wenn der dynamische Link in einem Social-Media-Beitrag geteilt wird.
setImageUrl	Die URL zu einem Bild, das sich auf diesen Link bezieht. Das Bild sollte mindestens 300 x 200 Pixel und weniger als 300 KB groß sein.

GoogleAnalyticsParameters
setSource setMedium setCampaign setTerm setContent	Analyseparameter von Google Play. Diese Parameter („utm_source“, „utm_medium“, „utm_campaign“, „utm_term“, „utm_content“) werden an den Play Store weitergegeben und an die Link-Payload angehängt.

ItunesConnectAnalyticsParameters
setProviderToken setAffiliateToken setCampaignToken	Analyseparameter von iTunes Connect. Diese Parameter („pt“, „at“, „ct“) werden an den App Store übergeben.