|
|
|
|
|
- Présentation
- Comment le faire ?
- Ajouter un téléchargement
- Suivre un téléchargement
- Supprimer un téléchargement
- Fonctions WLangage
Téléchargement en arrière-plan
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. Ajouter un téléchargement Pour proposer un téléchargement dans votre application Android : - 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.
- 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échargementAfin 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. Les fonctions WLangage permettant de gérer le téléchargement sont les suivantes :
| | TéléchargementAjoute | Ajoute un nouveau téléchargement dans le gestionnaire de téléchargement du téléphone. | TéléchargementListe | Liste les téléchargements du gestionnaire de téléchargement provenant de l'application en cours. | TéléchargementRécupèreInfo | Récupère les informations d'un téléchargement présent dans le gestionnaire de téléchargement. | TéléchargementSupprime | Annule 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 (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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|