Datei-Downloader-API
Lassen Sie Nutzer Bilder, PDFs und andere Dateien aus Ihrer Web-App auf ihr Android-Gerät herunterladen.
Die Download API von WebViewGold ermöglicht es Ihnen, Downloads von Dokument-, Bild- und Audiodateien in Ihrer WebView-App bereitzustellen. Die folgenden Schritte beschreiben, wie Sie die Downloader-Funktionalität aktivieren und anpassen:
1. Bilder herunterladen:
Speichern Sie Bilder in der Fotogalerie des Nutzers, indem Sie Links mit dem Präfix savethisimage://?url= aufrufen:
<a href="savethisimage://?url=IMAGE URL HERE">Download Image</a>
2. PDF-Dateien herunterladen:
Speichern Sie PDF-Dateien, indem Sie Links mit der Endung .pdf aufrufen:
<a href="https://www.example.org/file.pdf">Download PDF</a>
3. Musikdateien herunterladen:
Speichern Sie Musikdateien, indem Sie einfach Links mit der Endung .mp3, .mp4 oder .wav aufrufen:
<a href="https://www.example.org/file.mp3">Download MP3</a> <a href="https://www.example.org/file.mp4">Download MP4</a> <a href="https://www.example.org/file.wav">Download WAV</a>
4. Unterstützte Dateitypen anpassen:
Um dem Downloader weitere Dateiformate hinzuzufügen, tragen Sie diese in die Liste downloadableExtension in Config.java ein.
5. Automatische Datei-Downloads aktivieren:
Erwägen Sie, die Option AUTO_DOWNLOAD_FILES in Config.java zu setzen, um automatische Downloads für Dateien zu aktivieren, die mit Content-Disposition-HTTP-Headern gekennzeichnet sind, unabhängig von der Liste downloadableExtension. Dadurch wird sichergestellt, dass Dateien basierend auf den Serverkonfigurationen automatisch heruntergeladen werden.
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.