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

本文主要结合源码介绍 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功能介绍及使用示例