一、DownloadManager簡單介紹
DownloadManager是系統(tǒng)開放給第三方應(yīng)用使用的類，包含兩個靜態(tài)內(nèi)部類DownloadManager.Query和DownloadManager.Request。DownloadManager.Request用來請求一個下載，DownloadManager.Query用來查詢下載信息，這兩個類的具體功能會在后面穿插介紹。DownloadManager的源碼可見DownloadManager@Grepcode。

DownloadManager主要提供了下面幾個接口：
public long enqueue(Request request)執(zhí)行下載，返回downloadId，downloadId可用于后面查詢下載信息。若網(wǎng)絡(luò)不滿足條件、Sdcard掛載中、超過最大并發(fā)數(shù)等異常會等待下載，正常則直接下載。
public int remove(long… ids)刪除下載，若下載中取消下載。會同時刪除下載文件和記錄。
public Cursor query(Query query)查詢下載信息。

public static Long getRecommendedMaxBytesOverMobile(Context context通過移動網(wǎng)絡(luò)下載的最大字節(jié)數(shù)
public String getMimeTypeForDownloadedFile(long id)得到下載的mimeType，如何設(shè)置后面會進行介紹

其它：通過查看代碼我們可以發(fā)現(xiàn)還有個CursorTranslator私有靜態(tài)內(nèi)部類。這個類主要對Query做了一層代理。將 DownloadProvider和DownloadManager之間做個映射。將DownloadProvider中的十幾種狀態(tài)對應(yīng)到了 DownloadManager中的五種狀態(tài)，DownloadProvider中的失敗、暫停原因轉(zhuǎn)換為了DownloadManager的原因。

二、下載管理示例
下面具體介紹利用DownloadManager進行下載。
1、AndroidManifest中添加權(quán)限

Java

網(wǎng)絡(luò)訪問權(quán)限是必須的，下載地址為sdcard的話需要添加sdcard寫權(quán)限。

2、調(diào)用DownloadManager.Request開始下載

Java

上面調(diào)用downloadManager的enqueue接口進行下載，返回唯一的downloadId。

DownloadManager.Request除了構(gòu)造函數(shù)的Uri必須外，其他設(shè)置都為可選設(shè)置。下面逐個介紹下：
request.setDestinationInExternalPublicDir(“Trinea”, “MeiLiShuo.apk”);表示設(shè)置下載地址為sd卡的Trinea文件夾，文件名為MeiLiShuo.apk。

setDestinationInExternalPublicDir源碼

從源碼中我們可以看出下載完整目錄為Environment.getExternalStoragePublicDirectory(dirType)。 不過file是通過file.mkdir()創(chuàng)建的，這樣如果上級目錄不存在就會新建文件夾異常。所以下載前我們最好自己調(diào)用File的mkdirs方法 遞歸創(chuàng)建子目錄，如下：

Java

否則，會報異常

其他設(shè)置下載路徑接口為 setDestinationUri，setDestinationInExternalFilesDir，setDestinationToSystemCache。 其中setDestinationToSystemCache僅限系統(tǒng)app使用。

request.allowScanningByMediaScanner();表示允許MediaScanner掃描到這個文件，默認(rèn)不允許。

request.setTitle(“MeiLiShuo”);設(shè)置下載中通知欄提示的標(biāo)題
request.setDescription(“MeiLiShuo desc”);設(shè)置下載中通知欄提示的介紹
request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
表示下載進行中和下載完成的通知欄是否顯示。默認(rèn)只顯示下載中通知。VISIBILITY_VISIBLE_NOTIFY_COMPLETED表示下載完 成后顯示通知欄提示。VISIBILITY_HIDDEN表示不顯示任何通知欄提示，這個需要在AndroidMainfest中添加權(quán)限 android.permission.DOWNLOAD_WITHOUT_NOTIFICATION.

request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_WIFI);
表示下載允許的網(wǎng)絡(luò)類型，默認(rèn)在任何網(wǎng)絡(luò)下都允許下載。有NETWORK_MOBILE、NETWORK_WIFI、NETWORK_BLUETOOTH三種及其組合可供選擇。如果只允許wifi下載，而當(dāng)前網(wǎng)絡(luò)為3g，則下載會等待。
request.setAllowedOverRoaming(boolean allow)移動網(wǎng)絡(luò)情況下是否允許漫游。

request.setMimeType(“application/com.trinea.download.file”);
設(shè)置下載文件的mineType。因為下載管理Ui中點擊某個已下載完成文件及下載完成點擊通知欄提示都會根據(jù)mimeType去打開文件，所以我們可以 利用這個屬性。比如上面設(shè)置了mimeType為application/com.trinea.download.file，我們可以同時設(shè)置某個 Activity的intent-filter為application/com.trinea.download.file，用于響應(yīng)點擊的打開文件。

Java

request.addRequestHeader(String header, String value)
添加請求下載的網(wǎng)絡(luò)鏈接的http頭，比如User-Agent，gzip壓縮等

3 下載進度狀態(tài)監(jiān)聽及查詢

下載進度狀態(tài)監(jiān)聽代碼

其中我們會監(jiān)聽Uri.parse(“content://downloads/my_downloads”)。然后查詢下載狀態(tài)和進度，發(fā)送handler進行更新，handler中處理就是設(shè)置進度條和狀態(tài)等。

其中DownloadManagerPro.getBytesAndStatus的主要代碼如下，可直接引入TrineaAndroidCommon@Github(歡迎star和fork^_^)或TrineaAndroidCommon@GoogleCode作為你項目的library(如何拉取代碼及添加公共庫)：

下載進度狀態(tài)查詢代碼

從上面代碼可以看出我們主要調(diào)用DownloadManager.Query()進行查詢。DownloadManager.Query為下載管理對外開放的信息查詢類，主要包括以下接口：

setFilterById(long… ids)根據(jù)下載id進行過濾
setFilterByStatus(int flags)根據(jù)下載狀態(tài)進行過濾
setOnlyIncludeVisibleInDownloadsUi(boolean value)根據(jù)是否在download ui中可見進行過濾。

orderBy(String column, int direction)根據(jù)列進行排序，不過目前僅支持DownloadManager.COLUMN_LAST_MODIFIED_TIMESTAMP和 DownloadManager.COLUMN_TOTAL_SIZE_BYTES排序。

4 下載成功監(jiān)聽
下載完成后，下載管理會發(fā)出DownloadManager.ACTION_DOWNLOAD_COMPLETE這個廣播，并傳遞downloadId作為參數(shù)。通過接受廣播我們可以打開對下載完成的內(nèi)容進行操作。代碼如下：

下載成功監(jiān)聽

5、響應(yīng)通知欄點擊
(1) 響應(yīng)下載中通知欄點擊
點擊下載中通知欄提示，系統(tǒng)會對下載的應(yīng)用單獨發(fā)送Action為 DownloadManager.ACTION_NOTIFICATION_CLICKED廣播。intent.getData為 content://downloads/all_downloads/29669，最后一位為downloadId。
如果同時下載多個應(yīng)用，intent會包含DownloadManager.EXTRA_NOTIFICATION_CLICK_DOWNLOAD_IDS這個key，表示下載的的downloadId數(shù)組。這里設(shè)計到下載管理通知欄的顯示機制，會在下一篇具體介紹。

(2) 響應(yīng)下載完成通知欄點擊
下載完后會調(diào)用下面代碼進行處理，從中我們可以發(fā)現(xiàn)系統(tǒng)會調(diào)用View action根據(jù)mimeType去查詢。所以可以利用我們在介紹的DownloadManager.Request的setMimeType函數(shù)。

openDownload源碼

如果界面上過多元素需要更新，且網(wǎng)速較快不斷的執(zhí)行onChange會對頁面性能有一定影響。推薦ScheduledExecutorService定期查詢，如下:

Java

表示3秒定時刷新