2018年11月27日 星期二

[Android]使用DownloadManager

DownloadManager是個可以直接把檔案存進「下載區」、而不是在專案路徑下的工具。

它算是SystemService的一種,取得實體的方式跟其他Manager大同小異。(使用Activity下的getSystemService,並傳入Context.DOWNLOAD_SERVICE這個參數。)

但實際執行下載動作的不是DownloadManager,而是DownloadManager.Request。只要使用一般物件宣告實體的方式並指定一組網址參數給它,然後將它轉交給DownloadManager的「enqueue」就會開始執行下載動作。

下載完畢的時候,它會發出一個帶有「DownloadManager.ACTION_DOWNLOAD_COMPLETE」的Intent,所以這個工具要使用BroadcastReciever去接收這個Intent已完成「下載完成」的偵測。(這跟常見的Http管理工具風格有點相違背,因為這年頭習慣製作一個「事件」的Listener後,再把這個事件傳給Http的行為Thread。所以不習慣什麼事情都用BroadcastReciever的人在使用這個物件時可能會猶豫。

開始下載前(執行「enqueue」指令時), DownloadManager會回傳一組長整數(Long):fileID。在BroadcastReciever中,要使用這個fileID去取得「下載完的檔案實體路徑」。(顯然Google注意到了並不是每家廠牌手機都使用相同的路徑設定,下載區有可能會有很獨特的路徑,這會導致APP崩潰。)

以下功能寫在BroadcastReciever中。(範例是個圖檔,所以使用ImageView顯示。)

DownloadManager.Query query = new DownloadManager.Query(); query.setFilterById(downloadId); Cursor c = manager.query(query); if (c.moveToFirst()) { int columnIndex = c.getColumnIndex(DownloadManager.COLUMN_STATUS); if (DownloadManager.STATUS_SUCCESSFUL == c.getInt(columnIndex)) {
String uriString = c.getString(
c.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI)); imageView.setImageURI(Uri.parse(uriString)); Toast.makeText(MainActivity.this,
"download success",
Toast.LENGTH_SHORT).show(); } }

它提供了一個快速打開「檔案區」的方法。
Intent i = new Intent(); i.setAction(DownloadManager.ACTION_VIEW_DOWNLOADS); startActivity(i);

但一般來說都會希望自動導引使用專門開啟檔案的APP來瀏覽檔案。

要讓「其他APP」瀏覽「檔案」從API:24以後都強制使用FileProvide。

FileProvider不用複寫任何功能,只需擴充就可以發揮功用。(這樣做的意義何在?研究中。)