Erhalten Sie dynamische Firebase-Links in einer Flutter-App

Um die von Ihnen erstellten dynamischen Firebase-Links zu erhalten, müssen Sie das Dynamic Links SDK in Ihre App einbinden und beim Laden Ihrer App die Methode FirebaseDynamicLinks.getDynamicLink() aufrufen, um die im dynamischen Link übergebenen Daten abzurufen.

  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.

Plattformintegration

Führen Sie die folgenden Schritte zur Plattformintegration für die Plattformen aus, für die Sie Ihre App erstellen.

Android

Unter Android müssen Sie einen neuen Absichtsfilter hinzufügen, der Deep-Links Ihrer Domain abfängt, da der dynamische Link zu Ihrer Domain weiterleitet, wenn Ihre App installiert ist. Dies ist erforderlich, damit Ihre App die Dynamic Link-Daten empfängt, nachdem sie im Play Store installiert/aktualisiert wurde und auf die Schaltfläche „Weiter“ getippt wurde. In AndroidManifest.xml :

<intent-filter>
    <action android:name="android.intent.action.VIEW"/>
    <category android:name="android.intent.category.DEFAULT"/>
    <category android:name="android.intent.category.BROWSABLE"/>
    <data
        android:host="example.com"
        android:scheme="https"/>
</intent-filter>

Wenn Benutzer einen dynamischen Link mit einem Deep-Link zu dem von Ihnen angegebenen Schema und Host öffnen, startet Ihre App die Aktivität mit diesem Intent-Filter, um den Link zu verarbeiten.

Der nächste Schritt besteht darin, sicherzustellen, dass der SHA-256-Fingerabdruck des Signaturzertifikats in der Firebase-Konsole für die App registriert ist. Weitere Einzelheiten zum Abrufen Ihres SHA-256-Fingerabdrucks finden Sie auf der Seite „Authentifizierung Ihres Kunden“ .

Apple-Plattformen

  1. Erstellen Sie ein Apple-Entwicklerkonto, falls Sie noch keines haben.

  2. Stellen Sie auf der Seite „Projekteinstellungen“ der Firebase-Konsole sicher, dass Ihre iOS-App korrekt mit Ihrer App Store-ID und Team-ID konfiguriert ist.

  3. Erstellen Sie auf der Apple Developer-Website ein Bereitstellungsprofil für Ihre App mit aktivierter Funktion „Assoziierte Domäne“.

  4. Gehen Sie in Xcode wie folgt vor:

    1. Öffnen Sie Ihre App unter der Überschrift TARGETS .

    2. Stellen Sie auf der Seite „Signierung und Funktionen“ sicher, dass Ihr Team registriert und Ihr Bereitstellungsprofil festgelegt ist.

    3. Aktivieren Sie auf der Seite „Signierung und Funktionen“ die Option „Zugeordnete Domänen“ und fügen Sie Folgendes zur Liste „Zugeordnete Domänen“ hinzu (ersetzen Sie „Beispiel“ durch Ihre Domäne):

      applinks:example.page.link

    4. Fügen Sie auf der Infoseite einen URL-Typ zu Ihrem Projekt hinzu. Legen Sie das Feld „URL-Schemata“ auf die Bundle-ID Ihrer App fest. (Die Kennung kann Bundle ID oder eine beliebige andere sein.)

    5. Wenn Sie eine benutzerdefinierte Domäne für Ihr Firebase-Projekt eingerichtet haben, fügen Sie das Dynamic Link-URL-Präfix mithilfe des FirebaseDynamicLinksCustomDomains Schlüssels in die Info.plist Datei Ihres iOS-Projekts ein.

      <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>FirebaseDynamicLinksCustomDomains</key>
<array>
    <string>https://custom.domain.io/path1</string>
    <string>https://custom.domain.io/path2</string>
</array>

...other settings

</dict>
</plist>

    6. Optional: Deaktivieren Sie die Verwendung des iOS-Pasteboards durch das Dynamic Links SDK.

      Standardmäßig verwendet das Dynamic Links SDK das Pasteboard, um die Zuverlässigkeit von Deep Links nach der Installation zu verbessern. Durch die Verwendung des Pasteboards kann Dynamic Links sicherstellen, dass, wenn ein Benutzer einen Dynamic Link öffnet, aber zuerst Ihre App installieren muss, der Benutzer beim ersten Öffnen der App nach der Installation sofort zum ursprünglichen verknüpften Inhalt wechseln kann.

      Der Nachteil dabei ist, dass die Verwendung des Pasteboards unter iOS 14 und höher eine Benachrichtigung auslöst. Wenn Benutzer Ihre App zum ersten Mal öffnen und das Pasteboard eine dynamische Link-URL enthält, wird ihnen eine Benachrichtigung angezeigt, dass Ihre App auf das Pasteboard zugegriffen hat, was zu Verwirrung führen kann.

      Um dieses Verhalten zu deaktivieren, bearbeiten Sie Info.plist Datei Ihres Xcode-Projekts und legen Sie den FirebaseDeepLinkPasteboardRetrievalEnabled Schlüssel auf NO fest.

Um einen dynamischen Link in Ihrer Anwendung zu verarbeiten, müssen zwei Szenarien implementiert werden.

Beendeter Zustand

Richten Sie die folgenden Methoden ein:

  1. FirebaseDynamicLinks.getInitialLink – gibt ein Future<PendingDynamicLinkData?> zurück
  2. FirebaseDynamicLinks.onLink – Ereignishandler, der einen Stream zurückgibt, der ein PendingDynamicLinkData? enthält.

Android erhält den Link immer über FirebaseDynamicLinks.getInitialLink aus einem beendeten Zustand, aber unter iOS ist dies nicht garantiert. Daher lohnt es sich, beide in der folgenden Reihenfolge einzurichten, um sicherzustellen, dass Ihre Bewerbung den Link erhält:

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseConfig.platformOptions);

  // Check if you received the link via `getInitialLink` first
  final PendingDynamicLinkData? initialLink = await FirebaseDynamicLinks.instance.getInitialLink();

  if (initialLink != null) {
    final Uri deepLink = initialLink.link;
    // Example of using the dynamic link to push the user to a different screen
    Navigator.pushNamed(context, deepLink.path);
  }

  FirebaseDynamicLinks.instance.onLink.listen(
        (pendingDynamicLinkData) {
          // Set up the `onLink` event listener next as it may be received here
          if (pendingDynamicLinkData != null) {
            final Uri deepLink = pendingDynamicLinkData.link;
            // Example of using the dynamic link to push the user to a different screen
            Navigator.pushNamed(context, deepLink.path);
          }
        },
      );

  runApp(MyApp(initialLink));
}

Innerhalb Ihrer Anwendungslogik können Sie dann prüfen, ob ein Link behandelt wurde und eine Aktion ausführen, zum Beispiel:

if (initialLink != null) {
  final Uri deepLink = initialLink.link;
  // Example of using the dynamic link to push the user to a different screen
  Navigator.pushNamed(context, deepLink.path);
}

Hintergrund-/Vordergrundstatus

Während die Anwendung geöffnet ist oder im Hintergrund läuft, verwenden Sie den FirebaseDynamicLinks.onLink Getter:

FirebaseDynamicLinks.instance.onLink.listen((dynamicLinkData) {
  Navigator.pushNamed(context, dynamicLinkData.link.path);
}).onError((error) {
  // Handle errors
});

Wenn Sie alternativ feststellen möchten, ob zum Öffnen der Anwendung ein exakter dynamischer Link verwendet wurde, übergeben Sie ihn stattdessen an die getDynamicLink Methode:

String link = 'https://dynamic-link-domain/ke2Qa';

final PendingDynamicLinkData? initialLink = await FirebaseDynamicLinks.instance.getDynamicLink(Uri.parse(link));

Um einen dynamischen Link unter iOS zu testen, ist es erforderlich, dass Sie ein tatsächliches Gerät verwenden. Sie müssen die App auch im Release-Modus ausführen (z. B. flutter run --release .), wenn Sie einen dynamischen Link aus einem beendeten App-Status (z. B. die App wurde geschlossen) testen.