WebViewGold Dokumentation · iOS
🇩🇪 Deutsch
WebViewGold holen

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.

Zu wenig Zeit? Wir richten deine App für dich ein.

Unser Team konfiguriert, erstellt & reicht deine WebViewGold-App ein – schlüsselfertig, mit schneller Bearbeitung, Made in Germany.

App einrichten lassen →

Im Browser erstellen

Kein Mac, keine IDE: Der WebViewGold Cloud Builder konfiguriert, erstellt & lädt deine App online hoch.

Cloud Builder entdecken →