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:
iOS-Selbstdiagnosetool
Wenn Sie Probleme mit der Dynamic Link-Integration auf iOS-Geräten haben, verwenden Sie das Selbstdiagnosetool, das in den Dynamic Links SDK-Versionen 2.1.0 und höher integriert ist.
Das Tool kann wie unten beschrieben an einer beliebigen Stelle in Ihrem Code aufgerufen werden.
Swift
DynamicLinks.performDiagnostics(completion: nil)
Objective-C
[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 Tool für die Selbstdiagnose gibt Informationen wie die folgenden 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, weil das benutzerdefinierte URL-Schema 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
Wenn Sie Dynamic Links verwenden möchten, müssen Sie sie in der Firebase Console für Ihr Projekt aktivieren.
Sonstiges:
Bei anderen Problemen rufen Sie die Firebase-Supportseite auf.