Social-Media-Login-Helper (Google, Facebook & Apple)
Bringe Google-, Facebook- und Apple-OAuth-Logins mit den integrierten Social-Login-Helfern zuverlässig in deiner iOS-WebView-App zum Laufen.
Google, Facebook und andere OAuth-Anbieter blockieren Logins aus eingebetteten WebViews (z. B. Googles Fehler „disallowed_useragent“). Der in WebViewGold integrierte Social Login Helper sorgt dafür, dass diese Logins zuverlässig in deiner iOS-App funktionieren – ohne dass du den Login-Ablauf deiner Website ändern musst.
So funktioniert es:
Du definierst URL-Präfixe, die während des Login-Ablaufs deiner Web-App aufgerufen werden. Sobald eine dieser Trigger-URLs lädt, öffnet WebViewGold den Login in einem eigenen Popup-Login-Fenster mit einem angepassten User Agent, den der OAuth-Anbieter akzeptiert. Nach erfolgreichem Login kehrt der Ablauf automatisch zu deiner Web-App zurück. „Sign in with Apple“ (appleid.apple.com) wird automatisch erkannt und behandelt – ganz ohne Konfiguration.
Konfiguration:
Öffne Config.swift und definiere die Trigger-URL-Präfixe für deinen Login-Ablauf:
var google_login_helper_triggers: [String] = ["https://accounts.google.com", "https://accounts.youtube.com"] var facebook_login_helper_triggers: [String] = ["https://m.facebook.com", "https://www.facebook.com"]
google_login_helper_triggers– URL-Präfixe, die während eines Google-Logins auf deiner Website geladen werden.facebook_login_helper_triggers– URL-Präfixe, die während eines Facebook-Logins auf deiner Website geladen werden.
Um die richtigen Trigger-URLs zu finden, starte den Login-Ablauf deiner Website in einem Desktop-Browser und notiere, über welche URLs die OAuth-Weiterleitung läuft.
Auth-URL im externen Browser öffnen:
Alternativ kannst du eine Login-URL explizit an den System-Browser übergeben (die Session lebt dann im Browser, nicht in der App):
window.location.href = "googlelogin://" + encodeURIComponent("https://accounts.google.com/o/oauth2/v2/auth?...");
WebViewGold dekodiert die URL nach dem Präfix googlelogin:// und öffnet sie extern.
Wann du den Helper nutzen solltest:
Probiere zuerst die einfacheren Optionen – oft lösen sie Login-Probleme bereits:
- Öffne die Login-Domain über die URL-Handling-API in einem In-App-Browser-Tab oder im externen Browser (z. B.
specialLinkHandlingOptions,safariblacklist). - Setze einen Custom User Agent (
useragent_iphone/useragent_ipad).
Wenn der Login in der App weiterhin fehlschlägt, sind die Social-Login-Helper-Trigger die empfohlene Lösung.
Implementierungshinweise im SDK-Stil
Betrachte diese Funktion als native Fähigkeit, die deiner Web-Ebene bereitgestellt wird: Behalte deine Produktivwebsite oder PWA als zentrale Quelle bei und nutze anschließend die dokumentierten WebViewGold-Konfigurationsflags, URL-Befehle und JavaScript-Bridge-Aufrufe, um natives iOS-Verhalten nur dort zu aktivieren, wo es einen Mehrwert bietet. So bleibt deine Codebasis wartbar, da dieselbe Webanwendung mit minimaler Fallunterscheidung Browser, WebViewGold für iOS und die übrigen WebViewGold-Plattformen bedienen kann.
Für zuverlässige Ergebnisse empfehlen sich HTTPS-Endpunkte, stabile Routennamen, explizite Erfolgs-/Fehlerzustände in deiner UI sowie kleine JavaScript-Hilfsfunktionen, die native Aufrufe kapseln. Beispielsweise kann eine mit jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, einem eigenen React-/Vue-/Angular-Stack oder statischem HTML erstellte Web-App eine einzelne Schaltfläche oder einen Event-Handler bereitstellen, der die native WebViewGold-API auslöst und dennoch einen sauberen Browser-Fallback zeigt.
- Empfohlenes Integrationsmuster: Erkenne den App-Kontext, rufe die WebViewGold-API auf und aktualisiere anschließend deine Web-UI nach dem nativen Callback oder Routenwechsel.
- Test-Checkliste: Prüfe die Funktion auf einem echten Gerät oder in einem paketierten Build, überprüfe Berechtigungen und Store-Prüftexte und stelle sicher, dass reine Browser-Nutzer weiterhin einen sinnvollen Fallback erhalten.
- SEO-Vorteil: Halte Feature-Seiten, Routentitel und strukturierte Inhalte auf deiner Website indexierbar, während WebViewGold die native App-Hülle für iOS-Nutzer bereitstellt.