Von dynamischen Links zu App-Links und universellen Links migrieren

In dieser Anleitung zur Migration wird die Verwendung von App-Links und universellen Links beschrieben. Optional können Sie Firebase Hosting verwenden, um Ihre Dateien zur Verknüpfung von App und Website zu hosten.

Bei dieser Migration werden die folgenden Firebase Dynamic Links-Funktionen ersetzt:

Funktion	Firebase Dynamic Links	App-Links / universelle Links
Nutzer mit einem einzigen Linkklick zum richtigen Store für ihr Gerät weiterleiten		^★
Nutzern mit einem verzögerten Deeplink die Möglichkeit geben, nach dem Herunterladen und Installieren Ihrer App mit dem Kaufprozess fortzufahren		^★
Nutzern kontextbezogene Inhalte über Deeplinks in Ihrer App bereitstellen (wenn sie bereits installiert ist)
Analysedaten zu dynamischen Link-Klickereignissen bereitstellen
Kurz-URLs erstellen

Hinweis: Smart App Banners unter iOS bieten eine alternative Möglichkeit, ein klickbares Banner zu präsentieren, über das Nutzer zum App Store weitergeleitet werden, wenn Ihre App nicht installiert ist, oder zu Ihrer App, wenn sie bereits installiert ist.

Mit Smart App Banners können Sie auch Parameter übergeben, nachdem ein Nutzer auf den Link in Ihrem Smart App Banner geklickt hat. So können Sie Nutzern möglicherweise eine Fortsetzung ihres Nutzerpfads ermöglichen, wenn sie über das Smart App Banner zu Ihrer App gelangen.

Wenn Sie für die Migration weiterhin andere Firebase Dynamic Links-Funktionen benötigen, die in dieser Anleitung nicht unterstützt werden, finden Sie weitere Migrationsszenarien in der Dokumentation Häufig gestellte Fragen zur Einstellung von Dynamic Links.

Angenommen, Sie haben einen Firebase Dynamic Link, der so aussieht:

Beispiel für einen dynamischen Link
Linkname	Willkommen bei Beispiel.de
Deeplink	https://example.web.app/welcome
Android-App	com.example.android
Apple-App	com.example.ios
Langer dynamischer Link	https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos
Kurzer dynamischer Link	https://example.page.link/m9Mm

Ziel dieses Migrationsleitfadens ist es, Firebase Dynamic Links so zu ersetzen:

https://example.page.link/m9Mm

Mit App-Link-/Universal Link-Deeplinks, die so aussehen:

https://your-project-domain.web.app/welcome

Der Deeplink für App-Links / universelle Links bietet Ihren Nutzern Folgendes:

• Ein Deeplink, auf den sie klicken können, um Ihre App zu öffnen, wenn sie bereits installiert ist
• Eine Fortsetzung der User Journey, bei der sie beim Öffnen der App zu einem bestimmten Bereich weitergeleitet werden

Der Deeplink für App-Links / universelle Links bietet jedoch nicht die folgenden Verhaltensweisen für Ihre Nutzer, die zuvor durch Firebase Dynamic Links ermöglicht wurden:

• Nutzer zum richtigen Store für ihr Gerät weiterleiten, damit sie Ihre App herunterladen und installieren können
• Die User Journey wird nach dem Herunterladen, Installieren und erstmaligen Öffnen der App fortgesetzt.

Beachten Sie die Unterschiede im Verhalten und in der Funktionalität dieser App-Links / universellen Links im Vergleich zu Firebase Dynamic Links, die in der Tabelle oben aufgeführt sind.

Hinweis

Firebase Dynamic Links verwendet App-Links (unter Android) und universelle Links (unter iOS) in der zugrunde liegenden Implementierung, um Deeplink-Funktionen bereitzustellen, nachdem Ihre App bereits installiert wurde.

In dieser Anleitung wird beschrieben, wie Sie Ihre eigenen App-Links und Universal Links mit Firebase Hosting erstellen, um diesen Teil der von Firebase Dynamic Links bereitgestellten Funktionen zu ersetzen, während Sie Ihre Firebase Dynamic Links zur neuen Migrationslösung für App-Links / Universal Links migrieren.

Für die Migration benötigen Sie die folgenden Informationen:

• Die Firebase Dynamic Links, die Sie migrieren möchten
• Die in Ihren dynamischen Links enthaltenen Deeplink-URL-Parameter
• Die Domain, die Sie verwenden möchten, um Ihre bisherige Firebase Dynamic Links-Domain zu ersetzen (falls zutreffend)

Mit der Anleitung zum Exportieren von Dynamic Links-Metadaten können Sie Ihre vorhandenen Link-Metadaten exportieren und die oben aufgeführten Informationen abrufen.

Übersicht über die Migrationsschritte

1. Stellen Sie eine neue Domain bereit (falls Sie noch keine haben, die Sie verwenden möchten), um Ihre App Link-/Universal Link-Konfigurationsdateien mit Firebase Hosting zu hosten.

2. Erstellen und hosten Sie Ihre App Link-/Universal Link-Konfigurationsdateien in Ihrer Hosting-Domain.

3. Erstellen Sie neue App-Links / universelle Links, die dem Deep-Link-Schema entsprechen, das in Ihren Firebase Dynamic Links verwendet wird.

4. Aktualisieren Sie Ihre Android- und iOS-Apps und den Anwendungscode, damit Deeplinks empfangen werden können.

5. Integrationen von App-Links / Universellen Links testen

6. Ersetzen Sie Ihre veröffentlichten oder freigegebenen Firebase Dynamic Links durch App-Links und universelle Links.

Der erste Schritt ist für beide Migrationsabläufe (App-Links oder universelle Links) gleich. Die weiteren Schritte variieren je nach Plattform. Rufen Sie daher den Abschnitt des Leitfadens unten auf, der der Plattform entspricht, die Sie zuerst migrieren möchten.

• Migrationsschritte für Android-App-Links
• Migrationsschritte für universelle Links unter iOS

Eine neue Domain für das Hosting Ihrer App Link-/Universal Link-Konfigurationsdateien mit Firebase Hosting bereitstellen

Domain auswählen

Als Erstes müssen Sie eine Domain auswählen, die Sie für Ihre App-Links/Universal Links verwenden möchten. Dies ist die Domain, die für die neuen Links verwendet wird, die Sie für Ihre Nutzer freigeben.

Wenn Sie Firebase Hosting verwenden, werden Projekt-Subdomains im Format your-project-domain.web.app oder your-project-domain.firebaseapp.com automatisch und kostenlos bereitgestellt. Sie können optional eine benutzerdefinierte Domain mit oder ohne Firebase Hosting verwenden, um auch Ihre App Link-/Universal Link-Konfigurationsdateien zu hosten.

Firebase Hosting einrichten

Als Nächstes müssen Sie Ihre Firebase Hosting-Instanz einrichten und konfigurieren.

Wenn Sie die Einrichtung Ihrer Firebase Hosting-Instanz abgeschlossen haben, haben Sie eine Domain wie your-project-domain.web.app oder eine benutzerdefinierte Domain.

Migrationsschritte für Android-App-Links

App-Link-Konfigurationsdateien erstellen und auf Ihrer neuen Hostingdomain hosten

Wenn Sie App-Links verwenden möchten, müssen Sie eine Konfigurationsdatei hosten, mit der eine sichere Verknüpfung zwischen der in Ihren Links verwendeten Domain und Ihrer App hergestellt wird. Bei App-Links ist das die Datei assetlinks.json.

assetlinks.json-Datei erstellen und hosten

Mit der Datei assetlinks.json können wir eine Liste autorisierter Apps bereitstellen, die die Inhalte der Webdomain verarbeiten können, die wir für unsere App-Links verwenden. Die Datei „assetlinks.json“ muss im Stammverzeichnis der Webdomain unter dem Pfad /.well-known gehostet werden.

Führen Sie die folgenden Schritte aus, um diese Konfiguration abzuschließen:

1. Erstellen Sie den Ordner .well-known im öffentlichen Ordner in Ihrem Firebase Hosting-Stammverzeichnis.

2. Erstellen Sie im Ordner .well-known eine Datei mit dem Namen assetlinks.json.

3. Kopieren Sie den folgenden Inhalt in Ihre assetlinks.json-Datei und beachten Sie die Bedeutung der einzelnen Felder unten:

   [{
     "relation": ["delegate_permission/common.handle_all_urls"],
     "target": {
       "namespace": "android_app",
       "package_name": "com.example.android",
       "sha256_cert_fingerprints":
         ["01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF"]
     }
   }]
   

   • namespace – bezieht sich auf den Namen der Anwendung, die Sie bereitstellen möchten.
   • package_name – bezieht sich auf die in der build.gradle-Datei der App deklarierte applicationId
   • sha256_cert_fingerprints: SHA256-Fingerabdruck der Keystore-Datei, die Sie zum Signieren der Anwendung verwenden.

   Sie können die von Android Studio verwendete Datei „debug.keystore“ verwenden, um einen sha256_cert_fingerprints-Eintrag für Debugging-Zwecke zu generieren. Sie finden die Datei unter /Users/<username>/.android/debug.keystore auf Mac und Linux und unter C:\Users\<username>\.android\debug.keystore auf Windows.

   Aus diesem Keystore können Sie den SHA256-Wert mit dem Keytool abrufen.

   In diesem Abschnitt der App-Links-Dokumentation finden Sie weitere Informationen zu diesem Schritt.

   Alternativ können Sie auch den App Links Assistant in Android Studio verwenden, um den Inhalt der Datei „assetlinks.json“ zu generieren und Ihre Anwendung für die Verarbeitung von App-Links zu konfigurieren.

4. Aktualisieren Sie die Datei „firebase.json“, um die Datei für das Hosting zu indexieren.

   "headers": [
     {
       "source": "/.well-known/assetlinks.json",
       "headers": [
         {
           "key": "Content-Type",
           "value": "application/json"
         }
       ]
     }
   ]
   

5. Nachdem wir die assetlinks.json-Datei erstellt haben, führen Sie firebase deploy aus, um die Änderungen zu hosten.

   Sie müssen die Firebase CLI installiert haben, um den oben genannten Bereitstellungsbefehl ausführen zu können.

   firebase deploy --only hosting
   

6. Prüfen Sie die Datei „assetlinks.json“ unter https://your-project-domain.web.app/.well-known/assetlinks.json.

Neue App-Links erstellen, die dem Deep-Link-Schema entsprechen, das in Ihren Firebase Dynamic Links verwendet wird

In diesem Schritt erstellen Sie die Deeplinks aus Ihren Firebase Dynamic Links neu. Verwenden Sie dazu reguläre Deeplink-URLs, die der neuen Domain entsprechen, die Sie für Ihre App-Links erstellt haben.

Angenommen, Sie haben den folgenden Firebase Dynamic Link:

Beispiel für einen dynamischen Link
Linkname	Willkommen bei Beispiel.de
Deeplink	https://example.web.app/welcome
Android-App	com.example.android
Apple-App	com.example.ios
Langer dynamischer Link	https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos
Kurzer dynamischer Link	https://example.page.link/m9Mm

In diesem Fall extrahieren Sie den Deeplink-Parameter, also „https://example.web.app/welcome“, und verwenden ihn als App-Link-Parameter für Ihre App.

Hinweis: Als Sie Ihren ersten Firebase Dynamic Link erstellt haben, haben Sie möglicherweise einen Deeplink-Parameter mit einer Domain verwendet, die Ihnen nicht gehört (z.B. beispiel.de/willkommen). Firebase Dynamic Links haben dies unterstützt. Bei dieser Migration müssen jedoch alle Deeplinks, die Sie verwenden möchten, so geändert werden, dass die Domain verwendet wird, die Ihnen gehört und die zuvor mit Firebase Hosting konfiguriert wurde. Wenn Sie bereits eine Domain verwendet haben, die Ihnen gehört, für die Deeplink-URL-Parameter, die in Ihren dynamischen Firebase-Links verwendet werden, kann dies viel Zeit sparen. Ihre App ist möglicherweise bereits für die Verarbeitung der eingehenden App-Links konfiguriert, die Sie erstellen müssen.

Wiederholen Sie diesen Vorgang für jeden Firebase Dynamic Link, den Sie zu App-Links / universellen Links migrieren möchten, und replizieren Sie das verwendete Deeplink-Schema.

Hier sehen Sie ein Beispiel für eine Reihe von Firebase Dynamic Links-Kurzlinks, Deeplink-Parametern und migrierten Deeplink-Werten:

Kurzer Link	Deeplink-Parameter	Migrierter Deeplink
yourapp.page.link/welcome	https://example.com/welcome	yourapp.web.app/welcome
yourapp.page.link/c7sn	https://example.com/main/?p=23&t=1	yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social	https://example.com/friendinvite/?add=1	yourapp.web.app/friendinvite/?add=1

Als Nächstes müssen Sie alle Instanzen von Firebase Dynamic Links, die veröffentlicht oder geteilt wurden, durch die neuen migrierten Deeplinks ersetzen, damit Nutzer auf diese App-Links und nicht auf die vorherigen Firebase Dynamic Links klicken.

Hinweis :Diese neuen Links funktionieren erst, nachdem Sie die restlichen Anweisungen in diesem Leitfaden ausgeführt haben und Ihr Nutzer Ihre App bereits auf seinem Android-Gerät heruntergeladen und installiert hat.

Android-App und Anwendungscode aktualisieren, um Deeplinks zu empfangen

Nachdem Sie eine Domain ausgewählt, ein Deeplink-Schema festgelegt und Ihre Firebase Dynamic Links zu App-Links migriert haben, müssen Sie Ihre Android-App und Ihren Anwendungscode aktualisieren, damit die neuen Deeplinks empfangen werden können.

Wir empfehlen, die vollständige Dokumentation zu App-Links oder alternativ die Android Studio-Anleitung zum Konfigurieren Ihrer App für die Verarbeitung von Deeplinks zu lesen. Die wichtigsten Schritte sind:

1. Festlegen, welche Aktivitäten die jeweiligen Deeplinks verarbeiten sollen
2. Fügen Sie in der Datei „AndroidManifest.xml“ einen Intent-Filter für diese Aktivitäten hinzu.
3. Deeplink im Anwendungscode Ihrer Aktivitäten empfangen

Angenommen, Sie möchten einige Ihrer Deeplinks mit Ihrer MainActivity verarbeiten. Dazu müssen Sie der MainActivity in Ihrer AndroidManifest.xml-Datei den folgenden Intent-Filter hinzufügen:

<activity android:name=".MainActivity"
   android:exported="true">
   <intent-filter>
       <action android:name="android.intent.action.MAIN" />
       <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>
   <intent-filter android:autoVerify="true">
       <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.web.app" android:scheme="http"
           android:pathPrefix="/welcome" />
       <data android:host="example.web.app" android:scheme="https"
           android:pathPrefix="/welcome" />
   </intent-filter>
</activity>

In diesem Schritt geben Sie an, dass MainActivity das Ziel für die Verarbeitung von Deeplinks aus der Domain wxample.web.app ist, einschließlich des Pfadpräfixes „/welcome“. Sie müssen auch das Attribut „android:autoVerify='true'“ angeben, damit Ihre App als Standard-Handler für diesen Linktyp festgelegt werden kann.

Schließlich müssen Sie den Code in Ihre MainActivity einfügen, um die Deeplink-Daten abzurufen und damit die Deeplink-Funktion in Ihrer App zu steuern. Das ist ähnlich wie bei der Logik, die Sie möglicherweise bereits in Ihrer App codiert haben, als Sie Firebase Dynamic Links integriert haben.

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)

  val  data: Uri? = intent?.data

  val toast = Toast.makeText(this, data, duration)
  toast.show()
}

App-Links testen

Sie können die gerade erstellten App-Links testen, indem Sie Ihre App auf einem physischen Gerät oder im Android-Emulator ausführen.

Sie müssen einen klickbaren Link mit der für Ihre App-Links konfigurierten Domain erstellen und dann auf diesen Link klicken, um sicherzustellen, dass er Ihre App öffnet und Sie zur gewünschten Aktivität weiterleitet.

Alternativ können Sie die App-Links-Integration auch mit dem App-Links-Assistenten in Android Studio testen oder den folgenden Befehl für eine von Ihnen konfigurierte App-Link-URL verwenden, um sicherzustellen, dass die passende Aktivität richtig gestartet wird:

adb shell am start -a android.intent.action.VIEW -d <your_deep_link_url>

Veröffentlichte oder freigegebene Firebase Dynamic Links durch App-Links ersetzen

Im letzten Schritt der Migration müssen Sie Ihre veröffentlichten oder freigegebenen Firebase Dynamic Links nach Möglichkeit durch App-Links ersetzen und App-Links auch weiterhin verwenden.

Wie Sie diesen Schritt ausführen, hängt davon ab, wo und wie Sie Ihre Firebase Dynamic Links veröffentlicht haben. Um nachvollziehen zu können, welche Links vorhanden sind, können Sie Ihre vorhandenen Firebase Dynamic Link-Metadaten exportieren. Weitere Informationen finden Sie im Leitfaden zum Exportieren von Dynamic Links-Metadaten.

Migrationsschritte für universelle Links unter iOS

Hinweis :Wenn Sie die Migration zu App-Links bereits mit der Anleitung im vorherigen Abschnitt „Migrationsschritte für App-Links unter Android“ abgeschlossen haben, sind die Anweisungen hier sehr ähnlich, nur dass es jetzt um universelle Links unter iOS geht.

Konfigurationsdateien für Universal Links erstellen und auf Ihrer neuen Hostingdomain hosten

Damit Sie universelle Links verwenden können, müssen Sie eine Konfigurationsdatei hosten, mit der eine sichere Verknüpfung zwischen der in Ihren Links verwendeten Domain und Ihrer App hergestellt wird. Bei universellen Links ist das die Datei apple-app-site-association (auch als AASA-Datei bezeichnet).

Schritte zum Erstellen und Hosten der Datei „apple-app-site-association“

Mithilfe der AASA-Datei können wir eine Liste autorisierter Apps bereitstellen, die den Inhalt der Webdomain verarbeiten können, die wir für unsere universellen Links verwenden. Die AASA-Datei selbst muss im Stammverzeichnis der Webdomain unter dem Pfad /.well-known gehostet werden.

Führen Sie die folgenden Schritte aus, um diese Konfiguration abzuschließen:

1. Erstellen Sie den Ordner .well-known im öffentlichen Ordner in Ihrem Firebase Hosting-Stammverzeichnis.

2. Erstellen Sie im Ordner „.well-known“ eine Datei mit dem Namen apple-app-site-association.

3. Kopieren Sie den folgenden Inhalt in Ihre Datei „apple-app-site-association“ und beachten Sie dabei die Bedeutung der einzelnen Felder unten:

   {
     "applinks": {
       "apps": [],
       "details": [
         {
           "appID": "$TEAM_ID.com.firebase.UniversalLinks",
           "paths": [
             "NOT /_/*",
             "/*"
           ]
         }
       ]
     }
   }
   

   • $TEAM_ID.BundleId: Der vollständig qualifizierte Anwendungsname, der zum Verarbeiten der Links autorisiert ist.

4. Aktualisieren Sie die Datei „firebase.json“, um die Datei für das Hosting zu indexieren.

   "headers": [
     {
       "source": "/.well-known/apple-app-site-association",
       "headers": [
         {
           "key": "Content-Type",
           "value": "application/json"
         }
       ]
     }
   ]
   

5. Nachdem wir die AASA-Datei erstellt haben, führen Sie „firebase deploy“ aus, um die Änderungen zu hosten.

6. Rufen Sie https://your-project-domain.web.app/.well-known/apple-app-site-association auf, um die AASA-Datei zu überprüfen.

Neue universelle Links erstellen, die dem Deep-Link-Schema in Ihren Firebase Dynamic Links entsprechen

In diesem Schritt erstellen Sie die Deeplinks aus Ihren Firebase Dynamic Links neu. Dazu verwenden Sie reguläre Deeplink-URLs, die der neuen Domain entsprechen, die Sie für Ihre Universal Links erstellt haben.

Angenommen, Sie haben den folgenden Firebase Dynamic Link:

Beispiel für einen dynamischen Link
Linkname	Willkommen bei Beispiel.de
Deeplink	https://example.web.app/welcome
Android-App	com.example.android
Apple-App	com.example.ios
Langer dynamischer Link	https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos
Kurzer dynamischer Link	https://example.page.link/m9Mm

In diesem Fall extrahieren Sie den Deeplink-Parameter, also https://example.web.app/welcome, und verwenden ihn als Parameter für universelle Links für Ihre App.

Hinweis: Als Sie Ihren ersten Firebase Dynamic Link erstellt haben, haben Sie möglicherweise einen Deeplink-Parameter mit einer Domain verwendet, die Ihnen nicht gehört (z.B. beispiel.de/willkommen). Firebase Dynamic Links haben dies unterstützt. Bei dieser Migration müssen jedoch alle Deeplinks, die Sie verwenden möchten, so geändert werden, dass die Domain verwendet wird, die Ihnen gehört und die zuvor mit Firebase Hosting konfiguriert wurde. Wenn Sie bereits eine eigene Domain für die Deeplink-URL-Parameter verwendet haben, die in Ihren Firebase Dynamic Links verwendet werden, kann dies viel Zeit sparen. Ihre App ist dann möglicherweise bereits für die Verarbeitung der eingehenden universellen Links konfiguriert, die Sie erstellen müssen.

Wiederholen Sie diesen Vorgang für jeden Firebase Dynamic Link, den Sie zu App-Links / universellen Links migrieren möchten, und replizieren Sie das verwendete Deeplink-Schema.

Hier sehen Sie ein Beispiel für eine Reihe von Firebase Dynamic Links-Kurzlinks, Deeplink-Parametern und migrierten Deeplink-Werten:

Kurzer Link	Deeplink-Parameter	Migrierter Deeplink
yourapp.page.link/welcome	https://example.com/welcome	yourapp.web.app/welcome
yourapp.page.link/c7sn	https://example.com/main/?p=23&t=1	yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social	https://example.com/friendinvite/?add=1	yourapp.web.app/friendinvite/?add=1

Als Nächstes müssen Sie alle Instanzen von Firebase Dynamic Links, die veröffentlicht oder geteilt wurden, durch die neuen migrierten Deeplinks ersetzen, damit Nutzer auf diese Universal Links anstelle der vorherigen Firebase Dynamic Links klicken.

Hinweis :Diese neuen Links funktionieren erst, nachdem Sie die restlichen Anweisungen in diesem Leitfaden ausgeführt haben und Ihr Nutzer Ihre App bereits auf seinem iOS-Gerät heruntergeladen und installiert hat.

iOS-App und Anwendungscode aktualisieren, um Deeplinks zu empfangen

Nachdem Sie eine Domain ausgewählt, ein Deeplink-Schema festgelegt und Ihre Firebase Dynamic Links zu universellen Links migriert haben, müssen Sie Ihre iOS-App und Ihren Anwendungscode aktualisieren, damit die neuen Deeplinks empfangen werden können.

Wir empfehlen, die vollständige Dokumentation zu universellen Links zu lesen, um Ihre App für die Verarbeitung von Deeplinks zu konfigurieren. Die wichtigsten Schritte sind:

1. Projektkonfiguration aktualisieren, damit Ihre App Deeplinks von der neu erstellten Domain verarbeiten kann

2. Deeplink im Anwendungscode empfangen

Wenn Sie die Projektkonfiguration aktualisieren möchten, damit Ihre App Deeplinks verarbeiten kann, müssen Sie Ihrem Projekt in Xcode eine zusätzliche zugeordnete Domain für die Domain hinzufügen, die Sie jetzt zum Hosten der Datei „apple-app-site-associate“ verwenden möchten.

Dazu haben Sie folgende Möglichkeiten:

1. Xcode öffnen
2. Projekt im Dateinavigator auswählen
3. Zum Tab „Signieren & Funktionen“ in den Projekteinstellungen wechseln
4. Scrollen Sie nach unten zum Abschnitt „Zugeordnete Domains“.
5. Klicken Sie auf das Pluszeichen, um die zusätzliche Domain in Ihrem Projekt im Format „applinks:“ hinzuzufügen.

Schließlich müssen Sie Ihren Anwendungscode aktualisieren, damit Sie die eingehenden Deeplinks empfangen können.

Aktualisieren Sie dazu zuerst die Datei „AppDelegate.swift“, um auf einen universellen Link zu reagieren. Fügen Sie dazu den folgenden Code hinzu:

func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  AppDelegate.showReceivedUrl(userActivity: userActivity);
  return true
}

static func showReceivedUrl(userActivity: NSUserActivity) {
  if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
    let url = userActivity.webpageURL!
    print(url.absoluteString)
}

Im obigen Code wird die Callback-Methode für universelle Links überschrieben und die Deeplink-URL protokolliert, sofern vorhanden.

Jetzt rufen wir dieselbe showReceivedUrl-Methode auch aus der SceneDelegate-Klasse auf, da der universelle Link-Callback in SceneDelegate aufgerufen wird, wenn die App bereits geöffnet ist, wenn der Nutzer auf den universellen Link klickt.

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  AppDelegate.showReceivedUrl(userActivity: userActivity)
}

Universelle Links testen

Sie können die gerade erstellten Universal Links testen, indem Sie Ihre App auf einem physischen Gerät oder Simulator ausführen.

Sie müssen einen klickbaren Link mit der für Ihre Universal Links konfigurierten Domain erstellen und dann auf diesen Link klicken, um sicherzustellen, dass er Ihre App öffnet und Sie zum gewünschten Bildschirm in Ihrer App weiterleitet.

Smart App-Banner unterstützen

Wir empfehlen dringend, Smart App Banners zu verwenden, um Nutzern eine ähnliche Erfahrung wie mit dynamischen Firebase-Links zu bieten.

Über Smart App Banners werden Nutzer zum App Store-Eintrag Ihrer App weitergeleitet, wenn Ihre App noch nicht auf ihrem Gerät installiert ist. Optional können Sie auch einen Parameter konfigurieren, der nach dem Herunterladen und Installieren an Ihre App übergeben wird, damit Nutzer dort weitermachen können, wo sie aufgehört haben. Wenn Ihre App bereits installiert ist, wird sie geöffnet und der Parameter wird an Ihre App übergeben, damit der Nutzer basierend auf dem Smart App Banner, auf das er geklickt hat, zu den entsprechenden Inhalten weitergeleitet wird.

Veröffentlichte oder freigegebene Firebase Dynamic Links durch App-Links ersetzen

Im letzten Schritt der Migration müssen Sie Ihre veröffentlichten oder freigegebenen Firebase Dynamic Links nach Möglichkeit durch universelle Links ersetzen und diese auch weiterhin verwenden.

Wie Sie diesen Schritt ausführen, hängt davon ab, wo und wie Sie Ihre Firebase Dynamic Links veröffentlicht haben.

Damit Sie vorhandene Firebase Dynamic Links, die migriert werden müssen, leichter nachverfolgen können, veröffentlichen wir eine Anleitung zum Exportieren Ihrer Kurzlink-Metadaten aus Firebase Dynamic Links. Weitere Informationen finden Sie in den FAQs zur Einstellung von Dynamic Links.