- Die korrekte Konfiguration der Dateien assetlinks.json und apple-app-site-association ist unerlässlich, damit die Links die App automatisch öffnen.
- Externe Faktoren wie Apples CDN oder Googles Play App-Signatur können die Linkverifizierung beeinflussen.
- Das Löschen von Systemdienstcaches und das Aktualisieren von Komponenten wie WebView beheben häufig unerwartete Weiterleitungsfehler.
Das ist Ihnen sicher auch schon passiert: Sie klicken auf einen Link, der Sie direkt zu Ihrer Lieblings-App führen soll, und zu Ihrer Überraschung öffnet sich stattdessen Ihr Browser oder, noch schlimmer, Sie landen im App Store. Dieses Phänomen, das sowohl für App-Entwickler als auch für Endnutzer sehr ärgerlich sein kann, liegt meist daran, dass die Verknüpfung zwischen URL und Anwendung nicht korrekt konfiguriert ist oder aus technischen Gründen nicht mehr funktioniert.
In diesem Artikel erklären wir die Funktionsweise von App-Links unter Android und Universal Links unter iOS und zeigen, was zu tun ist, wenn Probleme auftreten. Egal, ob Sie als Entwickler mit der Konfigurationsdatei zu kämpfen haben oder als Nutzer einfach nur funktionierende Links nutzen möchten – hier finden Sie alle Tipps und Tricks für einen reibungslosen Ablauf.
So funktionieren App-Links auf Android
Um sicherzustellen, dass Android erkennt, dass ein Link zu einer App gehört, ohne den Nutzer mit einem lästigen Auswahldialog zu belästigen, verwendet es ein sicheres Verifizierungssystem. Im Wesentlichen teilt die App dem System mit: „Ich bin der Inhaber dieser Domain“, und Android überprüft dies anhand einer Datei namens assetlinks.json , die auf dem Webserver der Domain gehostet sein muss.
Seit Android 12 ist das System strenger geworden. Nicht verifizierte Links werden im Standardbrowser geöffnet. Mit Android 15 wurden außerdem dynamische App-Links eingeführt. Das ist fantastisch, denn so lassen sich die Linkregeln direkt auf dem Server ändern, ohne eine neue Version der App im Play Store hochladen zu müssen. Routenausschlüsse und Abfrageparameter können so flexibel verwaltet werden.
Häufige Fehler und technische Lösungen in Android
Einer der häufigsten Fehler tritt auf, wenn der Entwickler die Funktion auf seinem Computer überprüft, der Link die App in der finalen Version im Play Store aber nicht öffnet. Dies liegt in der Regel an der Play-App-Signatur . Google signiert die App mit einem anderen Schlüssel als dem Upload-Schlüssel. Daher muss der SHA-256-Fingerabdruck derjenige sein, der in der Google Play Console angezeigt wird , nicht der lokale.
Wenn Sie als Nutzer feststellen, dass Links nicht korrekt weiterleiten, sollten Sie eine drastischere Lösung in Betracht ziehen. Manchmal kann das Löschen des Speichers und des Caches von drei wichtigen Komponenten – Android System WebView, Google Play-Dienste und Google Services Framework – gefolgt von einem Neustart, Probleme beheben, die bereits seit Monaten bestehen.
iOS Universal Links meistern
Im Apple-Ökosystem ist das etwas anders. iPhones laden die Konfigurationsdatei nicht direkt von Ihrem Server herunter, sondern nutzen Apples CDN . Das bedeutet: Selbst wenn Ihre apple-app-site-association-Datei auf Ihrer Website einwandfrei aussieht, hat Apple sie möglicherweise noch nicht auf seinen Servern aktualisiert.
Es ist wichtig zu verstehen, dass manche Verhaltensweisen von Apple so vorgesehen sind und keine Fehler darstellen. Wenn der Nutzer beispielsweise die URL manuell in Safari eingibt oder auf einen Link derselben Domain klickt, auf der sie sich bereits befindet, priorisiert das System das Surfen im Web. Um dies zu testen, fügen Sie den Link idealerweise in die Notizen-App ein und halten Sie ihn gedrückt. Wenn die Option zum Öffnen in der App erscheint, funktioniert die Verknüpfung korrekt.
Schritte zur Behebung allgemeiner Anwendungsfehler
Wenn eine App unerwartet abstürzt oder beim Öffnen externer Inhalte Fehler auftreten, helfen einige grundlegende Schritte immer. Zunächst sollte man sicherstellen, dass die App auf dem neuesten Stand ist, da Entwickler regelmäßig Updates veröffentlichen, um Fehler bei der Weiterleitung zu beheben . Besteht das Problem weiterhin, kann das erzwungene Beenden der App über die Systemeinstellungen blockierte Hintergrundprozesse beenden.
Wenn das alles nicht hilft, könnte die Android System WebView die Ursache sein . Diese Komponente ermöglicht es Apps, Webinhalte anzuzeigen, ohne die Anwendung zu verlassen. Falls sie nicht mehr richtig funktioniert, können Sie versuchen, sie über den Play Store zu aktualisieren oder, im Extremfall, die Updates zu deinstallieren , um zur Originalversion zurückzukehren, die mit dem Betriebssystem ausgeliefert wurde.
Kurzanleitung zur Diagnose für Entwickler
- Routenprüfung: Verwenden Sie Tools wie swcutil auf dem Mac, um eine reale URL mit Ihrer lokalen Zuordnungsdatei zu vergleichen.
- Entwicklermodus: Auf iOS können Sie in den Entwicklereinstellungen die Diagnosefunktion aktivieren, um zu prüfen, ob das Telefon die Website freigegeben hat oder ob der Benutzer den Browser manuell ausgewählt hat.
- Vorsicht vor Weiterleitungen: Sowohl unter Android als auch unter iOS kann eine Weiterleitung von HTTP zu HTTPS oder von einer Domain ohne www zu einer mit www erfolgen. Bruchprüfung des Links.
Um während der Behebung dieser Probleme ein reibungsloses Benutzererlebnis zu gewährleisten, gibt es intelligente Verknüpfungsdienste, die den Benutzer zum richtigen Store weiterleiten oder die App öffnen, falls diese bereits installiert ist. Dadurch wird verhindert, dass der Kunde auf einen 400-Fehler oder eine leere Seite stößt, während das technische Team die Zuordnungsdateien auf dem Server anpasst.
Der Schlüssel zum Funktionieren von Deep Links liegt in der perfekten Synchronisierung zwischen dem Anwendungsmanifest, dem Signaturzertifikat und der auf dem Webserver gehosteten JSON-Datei. Dabei muss stets berücksichtigt werden, dass Faktoren wie Systemcaching, WebView-Aktualisierungen oder Apple CDNs zu Verzögerungen oder Fehlern bei der Überprüfung führen können.