API de téléchargement de fichiers
Permettez aux utilisateurs de télécharger des images, des PDF et d'autres fichiers depuis votre application web directement sur leur iPhone ou iPad.
L'API de téléchargement de WebViewGold vous permet de proposer le téléchargement de documents, d'images et de fichiers audio au sein de votre application WebView. Les étapes suivantes décrivent comment activer et personnaliser la fonctionnalité de téléchargement :
1. Télécharger des images :
Enregistrez des images dans la pellicule de l'utilisateur en appelant des liens avec le préfixe savethisimage://?url= :
<a href="savethisimage://?url=IMAGE URL HERE">Download Image</a>
2. Télécharger des fichiers :
Enregistrez des fichiers en appelant des liens avec un suffixe approprié (par exemple .mp3) :
<a href="https://www.example.org/file.pdf">Link PDF</a> <a href="https://www.example.org/file.mp3">Link mp3 Music</a> <a href="https://www.example.org/file.mp4">Link mp4 Music</a> <a href="https://www.example.org/file.wav">Link wav Music</a> <a href="https://www.example.org/file.epub">Link epub eBook</a> <a href="https://www.example.org/file.pkpass">Link Passbook / Apple Wallet</a> <a href="https://www.example.org/file.docx">Link Word</a> <a href="https://www.example.org/file.pptx">Link PowerPoint</a> <a href="https://www.example.org/file.xlsx">Link Excel</a>
3. Personnaliser les types de fichiers pris en charge :
Vous pouvez ajouter d'autres types de fichiers qui doivent déclencher la fonctionnalité de téléchargement (par exemple .epub, .zip, ...) Cela peut se faire via la variable de liste extentionARY qui se trouve dans le fichier Config.swift.
4. Activer les téléchargements automatiques de fichiers :
Vous pouvez définir l'option autodownloader dans Config.swift pour activer le téléchargement automatique des fichiers signalés par des en-têtes HTTP Content-Disposition, indépendamment de la liste extentionARY. Cela garantit que les fichiers sont téléchargés automatiquement en fonction des configurations du serveur.
Notes d’implémentation façon SDK
Considérez cette fonctionnalité comme une capacité native exposée à votre couche web : conservez votre site web de production ou votre PWA comme source de vérité, puis utilisez les indicateurs de configuration WebViewGold documentés, les commandes URL et les appels du pont JavaScript pour activer le comportement natif iOS uniquement là où il apporte de la valeur. Cette approche garde votre base de code maintenable, car la même application web peut servir les navigateurs, WebViewGold pour iOS et les autres plateformes WebViewGold avec un minimum de logique conditionnelle.
Pour des résultats fiables, privilégiez les points de terminaison HTTPS, des noms de routes stables, des états de succès/erreur explicites dans votre interface et de petites fonctions JavaScript qui encapsulent les appels natifs. Par exemple, une application web créée avec jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, une pile React/Vue/Angular personnalisée ou du HTML statique peut exposer un seul bouton ou gestionnaire d’événement qui déclenche l’API native WebViewGold tout en affichant une solution de repli élégante dans le navigateur.
- Modèle d’intégration recommandé : détectez le contexte de l’application, appelez l’API WebViewGold, puis mettez à jour votre interface web après le rappel natif ou le changement de route.
- Liste de vérification des tests : validez la fonctionnalité sur un appareil réel ou une build empaquetée, vérifiez les autorisations et le texte de revue du store, et confirmez que les utilisateurs navigateur uniquement reçoivent toujours une solution de repli utile.
- Avantage SEO : gardez les pages de fonctionnalités, les titres de routes et le contenu structuré indexables sur votre site web pendant que WebViewGold fournit l’enveloppe d’application native pour les utilisateurs iOS.