Kontakte-API
Greifen Sie aus Ihrer Web-App auf das Adressbuch des Geräts zu: Lesen Sie Kontakte mit Nutzerberechtigung in WebViewGold für Android.
WebViewGold ermöglicht den Export von Kontakten in eine JavaScript-Variable, im unten stehenden Format über die readcontacts:// API. Das JSON-Objekt wird in der Variablen contacts gespeichert. Um darauf zuzugreifen, muss Ihre App zunächst über die requestcontactpermission:// API eine Berechtigung einholen, die Ihren Nutzer auffordert, die Kontaktberechtigungen zu aktivieren. Ohne diesen Schritt füllt readcontacts:// die Variable contacts mit einem Null-Wert.
Beispielausgabe, gespeichert in der JS-Variablen contacts:
{
"John Appleseed":[
"888-555-5512",
"888-555-1212"
],
"Daniel Higgins":[
"555-478-7672",
"(408) 555-5270",
"(408) 555-3514"
],
"David Taylor":[
"555-610-6679"
],
"Hank Zakroff":[
"(555) 766-4823",
"(707) 555-1854"
]
}
Um diese Kontaktfunktionalität hinzuzufügen, muss die Berechtigung
android.permission.READ_CONTACTS zur Datei AndroidManifest.xml hinzugefügt werden, damit die Berechtigung von den Nutzern erteilt werden kann.
Implementierungshinweise im SDK-Stil
Betrachten Sie diese Funktion als native Fähigkeit, die Ihrer Web-Ebene bereitgestellt wird: Behalten Sie Ihre Produktivwebsite oder PWA als zentrale Quelle bei und nutzen Sie anschließend die dokumentierten WebViewGold-Konfigurationsflags, URL-Befehle und JavaScript-Bridge-Aufrufe, um natives Android-Verhalten nur dort zu aktivieren, wo es einen Mehrwert bietet. So bleibt Ihre Codebasis wartbar, da dieselbe Webanwendung mit minimaler Fallunterscheidung Browser, WebViewGold für Android und die übrigen WebViewGold-Plattformen bedienen kann.
Für zuverlässige Ergebnisse empfehlen sich HTTPS-Endpunkte, stabile Routennamen, explizite Erfolgs-/Fehlerzustände in Ihrer 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: Erkennen Sie den App-Kontext, rufen Sie die WebViewGold-API auf und aktualisieren Sie anschließend Ihre Web-UI nach dem nativen Callback oder Routenwechsel.
- Test-Checkliste: Prüfen Sie die Funktion auf einem echten Gerät oder in einem paketierten Build, überprüfen Sie Berechtigungen und Store-Prüftexte und stellen Sie sicher, dass reine Browser-Nutzer weiterhin einen sinnvollen Fallback erhalten.
- SEO-Vorteil: Halten Sie Feature-Seiten, Routentitel und strukturierte Inhalte auf Ihrer Website indexierbar, während WebViewGold die native App-Hülle für Android-Nutzer bereitstellt.