Validator für Universal Links und App Links

Fügen Sie Ihre apple-app-site-association oder assetlinks.json ein und sehen Sie Fehler, bevor Apple oder Google sie finden.

Vor dem Release

Liefern Sie die Datei per HTTPS unter /.well-known/ auf jeder Domain der Links aus, ohne Weiterleitung.
Senden Sie sie als application/json (apple-app-site-association ohne .json-Endung).
Nutzen Sie das Signaturzertifikat des installierten Builds: Die Google Play App-Signatur hat ein eigenes.
Installieren Sie die App nach einer Änderung neu – Geräte cachen die Datei.

Noch keine Datei? Erstellen Sie eine →

So funktioniert es

Die Datei wird in Ihrem Browser geprüft: Struktur, App-IDs, Pfade und Zertifikats-Fingerabdrücke.
Browser können keine Dateien anderer Websites laden, fügen Sie also den Inhalt statt einer URL ein.
Eine gültige Datei ist die halbe Arbeit – die Checkliste unten deckt die andere Hälfte ab.

Warum Universal Links Safari statt der App öffnen

iOS lädt die apple-app-site-association über Apples CDN, wenn die App installiert wird, nicht wenn ein Link angetippt wird. Fehlte die Datei in diesem Moment, war sie umgeleitet oder fehlerhaft, öffnen Links in Safari, bis die App neu installiert wird oder der Cache sich aktualisiert.

Die üblichen Ursachen: Der appIDs-Eintrag nutzt die Bundle-ID ohne die 10-stellige Team ID davor; die paths oder components passen nicht zum Link; die Datei wird mit einer Weiterleitung oder vom falschen Host ausgeliefert (www statt der reinen Domain); oder im Associated-Domains-Entitlement der App fehlt „applinks:“ plus der exakte Host.

Noch eine: Ein Link, der auf derselben Domain angetippt wird wie die aktuelle Seite, bleibt absichtlich in Safari. Testen Sie aus Notizen, Nachrichten oder von einer anderen Website.

Warum Android App Links den Browser öffnen

Android prüft die assetlinks.json für jeden Host in einem Intent-Filter mit android:autoVerify="true". Schlägt die Prüfung für einen davon fehl, öffnet keiner der Links die App automatisch.

Meist liegt es an den Fingerabdrücken: Die Datei listet den Debug- oder Upload-Schlüssel, während Nutzer den von der Google Play App-Signatur signierten Build installieren. Kopieren Sie den SHA-256 aus der Play Console unter App-Integrität und listen Sie jeden Schlüssel auf, der einen installierten Build signiert.

Ab Android 12 können Sie den Status mit adb shell pm get-app-links gefolgt von Ihrem Paketnamen prüfen und die Verifizierung nach dem Korrigieren der Datei erneut auslösen.

Häufige Fragen

Wo muss die apple-app-site-association liegen?

Unter https://your-domain/.well-known/apple-app-site-association, per HTTPS, ohne Weiterleitung, als application/json ausgeliefert und ohne .json-Endung.

Wo muss die assetlinks.json liegen?

Unter https://your-domain/.well-known/assetlinks.json, per HTTPS, ohne Weiterleitung, als application/json ausgeliefert.

Warum kann ich nicht per URL prüfen?

Browser lassen eine Seite keine Dateien einer anderen Website lesen, sofern diese es nicht erlaubt, und bei diesen Dateien ist das meist nicht der Fall. Öffnen Sie die URL, kopieren Sie den Inhalt und fügen Sie ihn hier ein.

Welchen SHA-256-Fingerabdruck brauche ich?

Den des Zertifikats, das den installierten Build signiert. Mit der Google Play App-Signatur ist das der App-Signaturschlüssel aus der Play Console, nicht Ihr Upload-Schlüssel. Tragen Sie beide ein, wenn Sie auch Builds verteilen, die mit Ihrem eigenen Schlüssel signiert sind.

Ich habe die Datei korrigiert, aber Links öffnen immer noch den Browser. Warum?

Geräte cachen das Ergebnis. Unter iOS installieren Sie die App neu; unter Android lösen Sie die Verifizierung erneut aus oder installieren neu. Prüfen Sie auch, ob die Associated Domains oder Intent-Filter der App den exakten Host nennen.

Weitere kostenlose Tools

Ein Link und QR-Code für alle Stores

SetLinks schickt jeden Besucher in seinen Store und zählt jeden Klick. Kostenlos starten.

Smart Link erstellen