GitHub-Pages-Tools

Kostenlose Assetlinks & AASA Generator

Erstelle Android assetlinks.json und Apple App Site Association für Deep Links.

Tool wird geladen...

Was ist Assetlinks & AASA Generator?

assetlinks.json und apple-app-site-association (AASA) sind JSON-Dateien, die im /.well-known/-Pfad einer Domain abgelegt werden, um Deep Linking zu ermöglichen. Android verwendet assetlinks.json, um zu überprüfen, ob eine App Links für eine Domain öffnen darf. iOS verwendet die AASA-Datei, um Universal Links zu aktivieren, die Inhalte in Ihrer App statt im Browser öffnen. Beide Dateien müssen über HTTPS ohne Weiterleitungen bereitgestellt werden.

Kurze Antwort

assetlinks.json (Android) und apple-app-site-association (iOS) ermöglichen Deep Linking von Ihrer Website zu Ihrer mobilen App. Generieren Sie beide Dateien, platzieren Sie sie unter /.well-known/ auf Ihrer Domain und stellen Sie sie über HTTPS ohne Weiterleitungen bereit.

Last updated: 2026-05-28

Einschränkungen

  • Änderungen an der iOS-AASA-Datei erfordern eine Neuinstallation der App, damit die neuen Regeln wirksam werden. Dies macht iOS-Deep-Link-Konfigurationsänderungen langsam in der Verbreitung.
  • Beide Dateien benötigen direkten HTTPS-Zugriff auf /.well-known/ ohne Weiterleitungen. Einige CDN-Konfigurationen und statische Hosts leiten unbekannte Pfade weiter, was Deep Linking stillschweigend unterbricht.
  • Die Android App Links-Verifizierung erfordert eine übereinstimmende Digital Asset Links API-Antwort. Die assetlinks.json-Datei allein ist ausreichend für die Verifizierung, aber Google kann auch den App-Eintrag im Play Store überprüfen.

Sources:MDN Web Docs · W3C Specifications · jquery.app on GitHub

So nutzt du dieses Tool

  1. Geben Sie für Android den Paketnamen Ihrer App und den SHA-256-Fingerabdruck Ihres Signaturzertifikats ein.
  2. Geben Sie für iOS Ihre Apple Developer Team ID, die Bundle-ID der App und Pfadregeln ein, welche URLs in der App geöffnet werden sollen.
  3. Wählen Sie das Ausgabeziel —Android, iOS oder beide.
  4. Stellen Sie die generierte(n) JSON-Datei(en) im /.well-known/-Verzeichnis Ihrer Domain bereit.

Wofür du es nutzen kannst

  • Richten Sie Deep Linking ein, damit Links zu Ihrer Website direkt in Ihrer mobilen App statt im Browser geöffnet werden.
  • Generieren Sie beide Android- und iOS-Deep-Link-Verifizierungsdateien für eine plattformübergreifende Flutter- oder React-Native-App.
  • Konfigurieren Sie pfadspezifische Regeln, sodass nur bestimmte URL-Muster (wie /posts/*) in der App geöffnet werden.

Anwendungsfalle

Praxisbeispiele

Beispiel

Plattformübergreifendes App-Deep-Linking

Eine Flutter-App möchte, dass Links zu example.com/posts/ sowohl auf Android als auch auf iOS in der App geöffnet werden. Generieren Sie die Android assetlinks.json mit dem SHA-256 des App-Signaturschlüssels und die iOS AASA mit Pfadregeln für /posts/*. Stellen Sie beide unter /.well-known/ bereit.

Beispiel

Nur Android Deep-Link-Verifizierung

Eine Android-App muss alle URLs von ihrer Domain verarbeiten. Generieren Sie assetlinks.json mit dem Paketnamen und SHA-256, setzen Sie den Pfad auf /* und stellen Sie es unter /.well-known/assetlinks.json bereit.

Haufige Fehler

  • Vergessen, die Dateien über HTTPS ohne Weiterleitungen bereitzustellen —sowohl Android als auch iOS benötigen direkten HTTPS-Zugriff auf den /.well-known/-Pfad.
  • Einen anderen Signaturschlüssel für die App verwenden als den in assetlinks.json —der SHA-256 muss mit dem exakten Zertifikat übereinstimmen, das zum Signieren der veröfentlichten APK oder AAB verwendet wurde.
  • Die iOS-AASA-Datei erfordert eine Neuinstallation der App, um Änderungen zu übernehmen —die Datei wird nur einmal während der App-Installation abgerufen.

Überprüfung

  1. Überprüfen Sie Android: https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://ihreseite.com&relation=delegate_permission/common.handle_all_urls
  2. Überprüfen Sie iOS: Verwenden Sie das App Search API Validation Tool in Ihrem Apple Developer Account oder testen Sie auf einem physischen Gerät nach der Neuinstallation der App.

FAQ

Fragen zu Assetlinks & AASA Generator

Wie lange dauert es, bis Änderungen an assetlinks.json wirksam werden?

Android überprüft assetlinks.json periodisch, typischerweise innerhalb von 24 Stunden. Die Google Play App Links-Verifizierung kann eine erneute Überprüfung früher auslösen. Verwenden Sie zum Testen die Android App Links Verification API oder den App Links Assistant in Android Studio, um eine sofortige Neuverifizierung zu erzwingen.

Benotigt die iOS AASA-Datei eine .json-Erweiterung?

Apple empfiehlt, die Datei unter /.well-known/apple-app-site-association ohne Dateiendung bereitzustellen. Einige CDNs und statische Hosts fügen jedoch automatisch Erweiterungen hinzu. Stellen Sie die Datei auch unter /.well-known/apple-app-site-association.json als Fallback bereit. iOS überprüft beide Speicherorte.

Kann ich unterschiedliche Pfadregeln für Android und iOS haben?

Ja. Die Android assetlinks.json und die iOS AASA-Datei sind vollständig unabhängig. Sie können Android alle Pfade verarbeiten lassen, während iOS nur bestimmte Pfade behandelt. Führen Sie das Tool zweimal aus —einmal für jedes Ziel —um separate Dateien mit unterschiedlichen Regeln zu generieren.

Verwandte Tools

Weitere github-pages-tools

Auch ausprobieren

Auch ausprobieren