Download File

Scopo

Chiede alla shell nativa di scaricare un file da un URL e salvarlo su disco dentro al dispositivo. Tale operazione può essere:

• asincrona: la procedura ritorna subito mentre la shell nativa scarica il file in background
• sincrona: la procedura ritorna solo quando la shell nativa ha terminato lo scaricamento del file

Questa procedura può servire, per esempio, per scaricare file dentro al dispositivo mobile. Se eseguita in background, al termine dello scaricamento, la shell nativa avvisa l'applicazione offline notificando l'evento OnFileUploaded. In questo caso particolare il parametro Command dell'evento viene valorizzato al valore "DOWNLOAD". Se lo scaricamento non ha avuto successo il valore del parametro Size dell'evento è -1 altrimenti il valore del parametro Size rappresenta la dimensione in byte del file ricevuto dalla shell.

Sintassi

Argomenti

Url	è un parametro stringa che indica l'URL del file da scaricare
Filename	è un parametro stringa che rappresenta il path assoluto del file entro cui salvare i dati ricevuti dall'URL indicato
Async	è un parametro booleano opzionale che indica al sistema se l'operazione di scaricamento del file deve essere asincrona (ovvero la procedura ritorna subito mentre la shell nativa scarica il file in background) o sincrona (ovvero la procedura ritorna solo quando il file è stato completamente scaricato). Se il parametro non viene specificato il valore predefinito è True (operazione asincrona).
Timeout	è un parametro intero opzionale che indica il numero di secondi che il sistema deve attendere per effettuare la connessione (disponibile a partire dalla versione 15.5 di Instant Developer).

Esempio di codice