Universal Links-API
Öffne Links zu deiner Domain direkt in deiner iOS-App mit Apple Universal Links – Einrichtung, AASA-Datei und Fehlerbehebung.
Die Universal-Links-API vereinfacht das Verlinken auf Inhalte innerhalb deiner App und sorgt für ein nahtloseres, natives Nutzererlebnis. Mit WebViewGold kannst du deine Domain so konfigurieren, dass Links aus Apps wie Mail, Safari und anderen automatisch in deiner WebViewGold-basierten App geöffnet werden – ganz ohne zusätzliche Aufforderungen.
Hinweis: Damit diese Funktion funktioniert, muss die App zuerst auf dem Gerät des Nutzers installiert sein.
Alternativ kannst du unsere Deep-Linking-API verwenden. Sie funktioniert ähnlich, nutzt jedoch eine andere Syntax. Es ist zu beachten, dass die Syntax der Universal-Links-API verbreiteter ist als die der Deep-Linking-API. Für die meisten Apps ist es sinnvoll, sich für eine der beiden Varianten zu entscheiden, nicht für beide.
Um Universal Links in deiner iOS-App einzurichten, folge bitte den nachstehenden Schritten:
- Einrichtung im Apple Developer Center:
- Melde dich mit deinem Konto im Apple Developer Center an.
- Klicke auf „Certificates, Identifiers & Profiles“.
- Wähle unter „Identifiers“ die Option „App IDs“ und anschließend die ID deiner App aus der Liste aus.
- Aktiviere im Bereich „App Services“ die Option „Associated Domains“ und speichere deine Änderungen.
- Einrichtung in Xcode:
- Öffne dein App-Projekt in Xcode.
- Wähle das Target aus (in den meisten Fällen „WebViewGold“). Navigiere im Tab „Signing & Capabilities“ zum Abschnitt „Associated Domains“. Klicke auf „+“, um eine Domain hinzuzufügen. Deiner Domain sollte „applinks:“ vorangestellt sein, zum Beispiel:
applinks:example.org&applinks:www.example.org:
- Setze in Config.swift ShowExternalLink auf true.
- Achte auf Subdomains. Es gibt einen Unterschied zwischen „www.*“ und Nicht-„www“-Domains (ziehe in Betracht, beide hinzuzufügen). Stelle sicher, dass du das richtige Provisioning Profile mit der Capability „Associated Domains“ besitzt. Andernfalls sollte Xcode dich zur Korrektur auffordern.
- Server-Einrichtung:
- Auf deinem Website-Server musst du eine Apple App Site Association (AASA)-Datei entweder auf der Root-Ebene deines Servers oder unter dem Präfix
/.well-known/hosten. Zum Beispiel:https://example.org/.well-known/apple-app-site-association - Die AASA-Datei sollte Details zur App und zu den zugeordneten Domains enthalten. Beziehe dich für die genaue Struktur auf die offizielle Dokumentation. Stelle sicher, dass die apple-app-site-association-Datei auf einem Server gehostet wird, der HTTPS unterstützt, nicht nur HTTP.
Fertig! :-) Das Testen im Simulator ist nicht so effektiv wie auf einem echten Gerät. Für die besten Ergebnisse verwende ein echtes iPhone oder iPad.