DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions Téléchargement
  • Présentation
  • Comment le faire ?
  • Ajouter un téléchargement
  • Suivre un téléchargement
  • Supprimer un téléchargement
  • Fonctions WLangage
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
A partir de la version 27, le téléchargement de fichiers peut se faire en arrière-plan, en utilisant le gestionnaire de téléchargement du système. Il n'est donc plus nécessaire de conserver l'application ouverte pour proposer le téléchargement d'un fichier. Le gestionnaire de téléchargement permet de télécharger des fichiers volumineux et permet également de notifier l'application lors de la fin des téléchargements.
Comment le faire ?

Ajouter un téléchargement

Pour proposer un téléchargement dans votre application Android :
  1. Définissez une requête de téléchargement grâce à une variable de type TéléchargementParamètre. Cette variable contient plusieurs propriétés mais une seule est véritablement nécessaire : la propriété Source qui correspond à l'URI du fichier à télécharger.
  2. Ajoutez le téléchargement dans le gestionnaire de téléchargement grâce à la fonction TéléchargementAjoute. Une fois ajouté, le gestionnaire de téléchargement lance le téléchargement dès que possible.
Remarque : Procédure de fin de téléchargement
Afin d'être notifié de la fin d'un téléchargement, il est possible de préciser une procédure qui sera appelée à la fin du téléchargement. Il faut pour cela préciser la procédure à appeler dans la propriété ProcédureFin de la variable TéléchargementParamètre.
  • Si l'application a été fermée avant la fin du téléchargement, elle sera relancée afin d'exécuter la procédure lorsque le téléchargement sera terminé.
  • Si la procédure renvoie Vrai, le téléchargement sera supprimé ainsi que le fichier téléchargé, sinon, le téléchargement sera conservé dans le gestionnaire de téléchargement et le fichier ne sera pas supprimé.

Suivre un téléchargement

Pour suivre le téléchargement proposé par votre application Android, récupérez les informations concernant le téléchargement via la fonction TéléchargementRécupèreInfo, en lui spécifiant l'identifiant du téléchargement fourni par la fonction TéléchargementAjoute. Ces informations sont disponibles dans une variable du type TéléchargementInfo.
En cas d'erreur lors du téléchargement, la procédure de fin de téléchargement est lancée. La propriété Etat de la variable de type TéléchargementInfo vaut téléchargementEtatEchec. Dans ce cas, la propriété EtatDétail permet de savoir l'origine de l'erreur.
Pour récupérer tous les téléchargements lancés par l'application dans le gestionnaire de téléchargement, il faut utiliser la fonction TéléchargementListe.

Supprimer un téléchargement

Pour supprimer un téléchargement du gestionnaire de téléchargement, utilisez la fonction TéléchargementSupprime en spécifiant l'identifiant du téléchargement à supprimer. Cette fonction va annuler et supprimer le téléchargement du gestionnaire de téléchargement ainsi que le fichier téléchargé s'il existe.
Fonctions WLangage
Les fonctions WLangage permettant de gérer le téléchargement sont les suivantes :
TéléchargementAjouteAjoute un nouveau téléchargement dans le gestionnaire de téléchargement du téléphone.
TéléchargementListeListe les téléchargements du gestionnaire de téléchargement provenant de l'application en cours.
TéléchargementRécupèreInfoRécupère les informations d'un téléchargement présent dans le gestionnaire de téléchargement.
TéléchargementSupprimeAnnule un téléchargement en le supprimant du gestionnaire de téléchargement du téléphone et supprime les fichiers existants.
Remarques :
  • L'utilisation des fonctions de téléchargement entraîne l'ajout automatique de la permission INTERNET à la liste des permissions requises par l'application. La permission DOWNLOAD_WITHOUT_NOTIFICATION est également ajoutée si la constante téléchargementNotifAucune est utilisée avec la propriété ModeNotification de la variable TéléchargementParamètre.
  • En exécution dans le simulateur, les fonctions de téléchargement n'auront aucun effet.
Liste des exemples associés :
Android Téléchargements Android (WINDEV Mobile) : Android Téléchargements
[ + ] Cet exemple illustre l'usage du téléchargement en arrière-plan disponible dans WINDEV Mobile et Android.
Il n'est donc plus nécessaire de conserver l'application ouverte pour proposer le téléchargement d'un fichier. Le gestionnaire de téléchargement permet de télécharger des fichiers volumineux et permet également de notifier l'application lors de la fin des téléchargements.
Version minimum requise
  • Version 27
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale