Android系统下载管理DownloadManager功能介绍及使用示例

Trinea 发布于 2013/05/29 13:17
阅读 6K+
收藏 11
本文主要结合源码介绍 Android系统下载管理DownloadManager的强大功能及使用

建议直接查看原文Android系统下载管理DownloadManager功能介绍及使用示例

另推荐下载管理如何进行功能增强和bug修改

PS:系统提供的功能很强大,完全没必要自己写


本文可运行代码地址可见 DownloadManager Demo @Google Code ,可运行APK地址 TrineaAndroidDemo.apk 。效果图如下:



一、DownloadManager简单介绍
DownloadManager是系统开放给第三方应用使用的类,包含两个静态内部类DownloadManager.Query和DownloadManager.Request。DownloadManager.Request用来请求一个下载,DownloadManager.Query用来查询下载信息,这两个类的具体功能会在后面穿插介绍。DownloadManager的源码可见DownloadManager@Grepcode。


DownloadManager主要提供了下面几个接口:
public long enqueue(Request request)执行下载,返回downloadId,downloadId可用于后面查询下载信息。若网络不满足条件、Sdcard挂载中、超过最大并发数等异常会等待下载,正常则直接下载。
public int remove(long… ids)删除下载,若下载中取消下载。会同时删除下载文件和记录。
public Cursor query(Query query)查询下载信息。


二、下载管理示例
下面具体介绍利用DownloadManager进行下载。
1、AndroidManifest中添加权限
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
网络访问权限是必须的,下载地址为sdcard的话需要添加sdcard写权限。


2、调用DownloadManager.Request开始下载
DownloadManager downloadManager = (DownloadManager)getSystemService(DOWNLOAD_SERVICE);
String apkUrl = "http://img.meilishuo.net/css/images/AndroidShare/Meilishuo_3.6.1_10006.apk";
DownloadManager.Request request = new DownloadManager.Request(Uri.parse(apkUrl));
request.setDestinationInExternalPublicDir("Trinea", "MeiLiShuo.apk");
// request.setTitle("MeiLiShuo");
// request.setDescription("MeiLiShuo desc");
// request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
// request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_WIFI);
// request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_HIDDEN);
// request.setMimeType("application/com.trinea.download.file");
long downloadId = downloadManager.enqueue(request);
上面调用downloadManager的enqueue接口进行下载,返回唯一的downloadId。


3 下载进度状态监听及查询
class DownloadChangeObserver extends ContentObserver {


    public DownloadChangeObserver(){
        super(handler);
    }


    @Override
    public void onChange(boolean selfChange) {
        updateView();
    }


}


public void updateView() {
    int[] bytesAndStatus = downloadManagerPro.getBytesAndStatus(downloadId);
    handler.sendMessage(handler.obtainMessage(0, bytesAndStatus[0], bytesAndStatus[1],
                                              bytesAndStatus[2]));
}


private DownloadChangeObserver downloadObserver;


@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.download_manager_demo);
    ……
    downloadObserver = new DownloadChangeObserver();
}


@Override
protected void onResume() {
    super.onResume();
    /** observer download change **/
    getContentResolver().registerContentObserver(DownloadManagerPro.CONTENT_URI, true,
                                                 downloadObserver);
}


@Override
protected void onPause() {
    super.onPause();
    getContentResolver().unregisterContentObserver(downloadObserver);
}
其中我们会监听Uri.parse(“content://downloads/my_downloads”)。然后查询下载状态和进度,发送handler进行更新,handler中处理就是设置进度条和状态等。
其中DownloadManagerPro.getBytesAndStatus的主要代码如下:
public int[] getBytesAndStatus(long downloadId) {
    int[] bytesAndStatus = new int[] { -1, -1, 0 };
    DownloadManager.Query query = new DownloadManager.Query().setFilterById(downloadId);
    Cursor c = null;
    try {
        c = downloadManager.query(query);
        if (c != null && c.moveToFirst()) {
            bytesAndStatus[0] = c.getInt(c.getColumnIndexOrThrow(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR));
            bytesAndStatus[1] = c.getInt(c.getColumnIndexOrThrow(DownloadManager.COLUMN_TOTAL_SIZE_BYTES));
            bytesAndStatus[2] = c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS));
        }
    } finally {
        if (c != null) {
            c.close();
        }
    }
    return bytesAndStatus;
}
从上面代码可以看出我们主要调用DownloadManager.Query()进行查询。DownloadManager.Query为下载管理对外开放的信息查询类


关于DownloadManager.Request详细介绍、DownloadManager.Query详细介绍、下载成功监听、响应通知栏点击可见原文
Android系统下载管理DownloadManager功能介绍及使用示例

以下是话题补充:

@Trinea:Demo下载地址变更:https://play.google.com/store/apps/details?id=cn.trinea.android.demo (2014/01/05 12:22)
加载中
0
kwf2030
kwf2030
没有多少国产机保留了这个吧。。
0
Trinea
Trinea

引用来自“wf2030”的答案

没有多少国产机保留了这个吧。。
基本都保留着,这是google play和chrome必须的底层支持
Trinea
Trinea
回复 @wf2030 : 争这个有意思吗,你要是rom开发者你会sb到把DownloadProvider和DownloadManager这两个不到几百k的代码删除掉吗
kwf2030
kwf2030
google服务没几个保留的
kwf2030
kwf2030
国产机子有play商店?
返回顶部
顶部