{"id":12699,"date":"2017-09-05T10:34:06","date_gmt":"2017-09-05T08:34:06","guid":{"rendered":"http:\/\/www.devapp.it\/wordpress\/?p=12699"},"modified":"2017-09-05T10:34:06","modified_gmt":"2017-09-05T08:34:06","slug":"android-scaricare-grandi-file-con-il-downloadmanager","status":"publish","type":"post","link":"https:\/\/www.devapp.it\/wordpress\/android-scaricare-grandi-file-con-il-downloadmanager\/","title":{"rendered":"Android: scaricare grandi file con il DownloadManager"},"content":{"rendered":"

Tantissime funzionalit\u00e0 delle app mobile richiedono l’interazione con la Rete ed \u00e8 proprio per tale motivo\u00a0che\u00a0il mondo Android dispone di\u00a0molte librerie dedicate a questo tipo di attivit\u00e0 (Volley, OkHttp, Retrofit<\/a> ed\u00a0altre ancora) ma per lo scaricamento di file di grandi dimensioni<\/strong> con protocollo HTTP si pu\u00f2 ricorrere ad un servizio di sistema gi\u00e0 pronto: il DownloadManager<\/strong>. Stiamo parlando del servizio chiamato in causa ogniqualvolta l’utente vuole scaricare\u00a0sul dispositivo file di dimensioni considerevoli: l’andamento di tutta l’attivit\u00e0 viene illustrato mediante notifiche status bar. Il vantaggio principale di questo meccanismo risiede nel completamento del download che viene portanto a termine superando tutte le situazioni possibili: fallimenti, disconnessioni e riavii del sistema.<\/p>\n

Come funziona il DownloadManager<\/h2>\n

Per lavorare con il DownloadManager dobbiamo, per prima cosa, recuperare un’istanza del servizio:<\/p>\n

DownloadManager manager= (DownloadManager) getSystemService(DOWNLOAD_SERVICE);<\/pre>\n
Prepariamo poi una richiesta – classe Request<\/em> – che specifica l’indirizzo del file da scaricare (fornito con un oggetto di classe Uri<\/em>) ed altri dettagli come la cartella locale di salvataggio, la durata della notifica ed altro ancora<\/p>\n
Uri uri=Uri.parse(\"http:\/\/www.miosito.it\/file-grande-da-scaricare.pdf\");\r\n\r\nDownloadManager.Request request=new DownloadManager.Request(uri);\r\nrequest.setTitle(\"File grande da scaricare\");\r\n\/\/ ulteriori configurazioni della richiesta<\/pre>\n
Infine, accodiamo\u00a0la richiesta composta al DownloadManager<\/p>\n
long download_id=manager.enqueue(request);<\/pre>\n
e da quel momento in poi lo scaricamento del file cessa di riguardare la nostra applicazione ma diventa\u00a0compentenza del sistema. Il valore long ottenuto, download_id<\/em>, \u00e8 un riferimento univoco allo scaricamento<\/strong> con cui potremo indirizzare comandi al DownloadManager.<\/p>\n
Uso di base<\/h2>\n
Vediamo subito un esempio base (il cui codice \u00e8 disponibile qui<\/a>) in cui sviluppiamo una semplice Activity\u00a0che, al click<\/em> del Floating Action Button, avvia\u00a0lo scaricamento di un file PDF di alcuni megabyte di dimensione (abbiamo scelto il manuale di OrientDB). Non applicheremo alcuna personalizzazione al comportamento di default proprio perch\u00e8 ci interessa\u00a0vedere cosa, di suo, il DownloadManager fa.<\/p>\n
Posizioniamo la permission INTERNET<\/strong> nel file AndroidManifest.xml affinch\u00e8 l’app possa accedere alla rete:<\/p>\n
<manifest xmlns:android=\"http:\/\/schemas.android.com\/apk\/res\/android\"\r\n    package=\"it.devapp.downloadmanagerexample\">\r\n\r\n    <uses-permission android:name=\"android.permission.INTERNET\" \/>\r\n\r\n    <application\r\n         ...\r\n         ...\r\n    <\/application>\r\n<\/manifest><\/pre>\n
Nel metodo onCreate<\/em>, predisponiamo la richiesta in base all’URI e specifichiamo nome e descrizione che dovranno apparire nella notifica di scaricamento. Inoltre, richiediamo che quest’ultima non scompaia al termine del download. Tutta l’azione del DownloadManager inizia all’interno del listener<\/em> legato al click del FloatingActionButton<\/em>:<\/p>\n