|
|
|
|
- Presentación
- ¿Cómo proceder?
- Añadir una descarga
- Seguimiento de una descarga
- Eliminar una descarga
- Funciones de WLanguage
A partir de la versión 27, los archivos pueden descargarse en Background, utilizando el gestor de descargas del sistema. Por lo tanto, ya no es necesario mantener la aplicación abierta para pedir al usuario que descargue un archivo. El gestor de descargas permite descargar archivos de gran tamaño y generar una Notification cuando las descargas se han completado. Añadir una descarga Para proponer una descarga en su aplicación Android: - Definir una solicitud de descarga con una Variable de tipo DownloadParameter. Esta Variable contiene múltiples propiedades, pero sólo una es realmente necesaria: el Fuente Property que corresponde al URI del archivo a descargar.
- Añade la descarga en el gestor de descargas con DownloadAdd. Una vez añadido, el gestor de descargas iniciará la descarga lo antes posible.
Observación: Descargar final ProcedurePara que se le notifique cuando se complete una descarga, puede especificar una Procedure que se llamará al final de la descarga. Para ello, es necesario especificar el procedimiento a llamar en el ProcedureEnd Property del DownloadParameter Variable. - Si la aplicación se cerró antes de finalizar la descarga, se reiniciará para ejecutar la Procedure cuando se complete la descarga.
- Si el Procedure devuelve True, la descarga será eliminada así como el archivo descargado. En caso contrario, la descarga se mantendrá en el gestor de descargas y el archivo no se borrará.
Seguimiento de una descarga Para supervisar la descarga en la aplicación Android, recupere los detalles de la descarga con DownloadAdd, especificando el identificador de descarga proporcionado por DownloadGetInfo. Esta información se almacena en una Variable de tipo DownloadInfo. Si hay un error durante la descarga, se inicia el final de la descarga Procedure. La propiedad Status de la variable DownloadInfo se establece en downloadStatusFailed. En este caso, se puede utilizar el StatusDetails Property para determinar la causa del error. Para recuperar todas las descargas iniciadas por la aplicación en el gestor de descargas, utilice DownloadList. Eliminar una descarga Para eliminar una descarga del gestor de descargas, utilice DownloadRemove y especifique el identificador de la descarga que desea eliminar. Esta función Cancel la descarga y la elimina del gestor de descargas, así como el archivo descargado, si existe. Las siguientes funciones de WLanguage se utilizan para gestionar las descargas:
| | DownloadAdd | Añade una nueva descarga en el gestor de descargas del dispositivo. | DownloadGetInfo | Recupera los detalles de una descarga presente en el gestor de descargas. | DownloadList | Enumera las descargas de la aplicación actual en el gestor de descargas. | DownloadRemove | Cancela una descarga eliminándola del gestor de descargas, y borra los archivos existentes. |
Observaciones: - La utilización de las funciones de descarga añade automáticamente la Permission INTERNET a la lista de Permission s requeridas por la aplicación. El permiso DOWNLOAD_WITHOUT_NOTIFICATION también se agrega si se utiliza la constante downloadNotifNone con la propiedad NotificationMode de la variable DownloadParameter.
- Cuando se ejecuta la aplicación en el simulador, las funciones de descarga no tendrán efecto.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|