Fehlerbehebung bei dynamischen Links

Flussdiagramm für die Vorschauseite

Zur Fehlerbehebung bei Dynamic Links können Sie sich mit einem automatisch generierten Flussdiagramm eine Vorschau des Verhaltens von Dynamic Links auf verschiedenen Plattformen und Konfigurationen ansehen. Generieren Sie das Flussdiagramm, indem Sie den Parameter d=1 in eine beliebige kurze oder lange Dynamic Link einfügen. Beispiel: example.page.link/suffix?d=1 für eine kurze Dynamic Link.

Die Vorschauseite sieht so aus:

Screenshot der Vorschauseite

iOS-Selbstdiagnosetool

Wenn du Probleme mit der Integration von Dynamic Link unter iOS hast, verwende das Selbstdiagnosetool, das im Dynamic Links SDK ab Version 2.1.0 enthalten ist.

Das Tool kann von überall in Ihrem Code wie folgt aufgerufen werden.

Swift

Hinweis: Dieses Firebase-Produkt ist nicht für macOS-, Mac Catalyst-, tvOS- oder watchOS-Ziele verfügbar.
DynamicLinks.performDiagnostics(completion: nil)

Objective-C

Hinweis: Dieses Firebase-Produkt ist nicht für macOS-, Mac Catalyst-, tvOS- oder watchOS-Ziele verfügbar.
[FIRDynamicLinks performDiagnosticsWithCompletion:nil];

Standardmäßig druckt das Tool Debug-Informationen, einschließlich erkannter Fehler, in die Standardausgabe. Angenommen, Ihre iOS-App empfängt Dynamic Links nicht wie erwartet. Das Selbstdiagnosetool gibt beispielsweise folgende Informationen aus:

---- Firebase Dynamic Links diagnostic output start ----
Firebase Dynamic Links framework version 2.1.0
System information: OS iOS, OS version 11.0, model iPhone
Current date 2017-08-14 22:52:56 +0000
AutomaticRetrievalEnabled: YES
ERROR: Specified custom URL scheme is com.google.AppInvitesSample.dev but Info.plist do not contain such scheme in CFBundleURLTypes key.
AppID Prefix: EQHXZ8M8AV, Team ID: EQHXZ8M8AV, AppId Prefix equal to Team ID: YES
performDiagnostic detected 1 ERRORS.
---- Firebase Dynamic Links diagnostic output end ----

In diesem Beispiel funktioniert Dynamic Links nicht, da das Schema für benutzerdefinierte URLs nicht richtig konfiguriert ist.

Häufige Fehler und Warnungen

Die Android-App enthält keinen SHA256-Hash. AppLinks ist für die App nicht aktiviert.

Wenn Sie Android App-Links mit Ihrer App verwenden möchten, müssen Sie ein SHA256-Zertifikat erstellen.

Nachdem Sie das SHA256-Zertifikat erstellt haben, fügen Sie es Ihrer App in der Firebase Console hinzu. Weitere Informationen finden Sie unter SHA-Fingerabdruck hinzufügen.

Der Android-Paketname „com.beispiel“ und/oder die iOS-Bundle-ID „com.beispiel“ wurden nicht gefunden.

Damit Sie Dynamic Links mit Ihrer Android- oder iOS-App verwenden können, müssen Sie die App Ihrem Firebase-Projekt hinzufügen. Weitere Informationen finden Sie unter Apps hinzufügen.

In der iOS-App fehlt die Team-ID. UniversalLinks ist für die App nicht aktiviert.

Wenn Sie Universal Links mit Ihrer App verwenden möchten, müssen Sie in der Firebase-Konsole eine Team-ID hinzufügen. Weitere Informationen finden Sie unter App Store-ID oder Team-ID hinzufügen.

Sie finden Ihre Team-ID im Apple Member Center auf dem Tab Membership (Mitgliedschaft).

Die iOS-Store-ID ist in der angegebenen iOS-Bundle-ID nicht vorhanden. Wird übersprungen.

Das bedeutet, dass die unter https://itunes.apple.com/us/app/yourapp/idSTOREID aufgeführte App nicht die angegebene Bundle-ID hat.

Ungültiges benutzerdefiniertes iOS-Schema

Ein benutzerdefiniertes Schema muss mit einem Buchstaben (A–Z, a–z) beginnen und kann von einer beliebigen Anzahl alphanumerischer Zeichen, +, - oder . gefolgt werden. Es darf außerdem keines der folgenden Schemas sein: „javascript“, „vbscript“, „data“, „blob“, „http“, „https“, „mailto“, „livescript“, „facetime“ oder „facetime-audio“.

Für Ihr Projekt wurden keine Dynamic Links konfiguriert

Damit Sie Dynamic Links verwenden können, müssen Sie es in der Firebase-Konsole für Ihr Projekt aktivieren.

Sonstiges:

Bei anderen Problemen rufen Sie die Firebase-Supportseite auf.