一、使用的时候需要添加权限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

二、简介

在android开发中，经常会使用到文件下载的功能，比如app版本更新等。在api level 9之后，android系统为我们提供了DownLoadManager类，这是android提供的系统服务，我们通过这个服务完成文件下载。整个下载过程全部交给系统负责，不需要我们过多的处理。

通过API文档，可以看出DownLoadManager包含两个内部类：

参考：https://developer.android.google.cn/reference/android/app/DownloadManager

三、使用

创建

        String fileName = "test.mp4";
        Uri uri = Uri.parse(downloadUrl);
        DownloadManager  downloadManager = (DownloadManager) context.getSystemService(DOWNLOAD_SERVICE);
        DownloadManager.Request request = new DownloadManager.Request(uri);
        // 设置允许使用的网络类型，这里是移动网络和wifi都可以
        request.setAllowedNetworkTypes(request.NETWORK_MOBILE | request.NETWORK_WIFI);
        //设置是否允许漫游
        request.setAllowedOverRoaming(true);
        //设置文件类型
        request.setMimeType("video/*");//表示视频类型
        //在通知栏中显示
        request.setNotificationVisibility(request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
        request.setTitle(fileName);
        request.setDescription("视频正在下载");
        request.setVisibleInDownloadsUi(true);
        // 设置为可被媒体扫描器找到
        request.allowScanningByMediaScanner();
        request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);
        // 将下载请求放入队列
         long   downloadId = downloadManager.enqueue(request);
     

注册广播

下载完成后，下载管理会发出DownloadManager.ACTION_DOWNLOAD_COMPLETE这个广播，并传递downloadId作为参数。通过接受广播我们可以打开对下载完成的内容进行操作

        // 监听下载成功状态
        registerReceiver(receiver, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));

创建广播，监听下载状态

下载完成时，发送的广播。
对应的Action为：ACTION_DOWNLOAD_COMPLETE
Notification被点击时发送的广播。
对应的Action为：ACTION_NOTIFICATION_CLICKED
查看所有下载情况的广播。
对应的Action为：ACTION_VIEW_DOWNLOADS

//广播接受者，接收下载状态 
private BroadcastReceiver receiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
             String action = intent.getAction();
            if (DownloadManager.ACTION_DOWNLOAD_COMPLETE.equals(action)) {
               long downloadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, 0);
              //检查下载状态
              checkDownloadStatus(downloadId );     
            }
        }

        //检查下载状态
        private void checkDownloadStatus(long downloadId ) {
            DownloadManager.Query query = new DownloadManager.Query();
            query.setFilterById(downloadId );//筛选下载任务，传入任务ID，可变参数 
            Cursor c = downloadManager.query(query);
            if (c.moveToFirst()) {
                int status = c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS));
                switch (status) {
                    case DownloadManager.STATUS_PAUSED:
                        MLog.i(">>>下载暂停");
                    case DownloadManager.STATUS_PENDING:
                        MLog.i(">>>下载延迟");
                    case DownloadManager.STATUS_RUNNING:
                        MLog.i(">>>正在下载");// 此处无法监听到
                        break;
                    case DownloadManager.STATUS_SUCCESSFUL:
                        MLog.i(">>>下载完成");
                        break;
                   case DownloadManager.STATUS_FAILED:
                        MLog.i(">>>下载失败");
                        break;
                }
            }
        }
    };

下载进度

• DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR:到目前为止下载的字节数。
• DownloadManager.COLUMN_DESCRIPTION:这个下载的客户端提供的描述
• DownloadManager.COLUMN_ID:特定下载的标识符，在整个系统中是唯一的。
• DownloadManager.COLUMN_LAST_MODIFIED_TIMESTAMP:上一次修改下载的时间戳，在system.currenttimemillis（）（UTC时间）。
• DownloadManager.COLUMN_LOCAL_URI:将存储下载文件的Uri。
• DownloadManager.COLUMN_MEDIAPROVIDER_URI:这个下载条目的MediaProvider对应条目的URI。
• DownloadManager.COLUMN_MEDIA_TYPE:下载文件的网络媒体类型。
• DownloadManager.COLUMN_REASON:提供有关下载状态的更多详细信息。
• DownloadManager.COLUMN_STATUS:下载的当前状态，作为STATUS_ *常量之一。
• DownloadManager.COLUMN_TITLE:这个下载的客户端提供的标题
• DownloadManager.COLUMN_TOTAL_SIZE_BYTES:下载的总大小
• DownloadManager.COLUMN_URI:URI下载

采用时间来实时刷新进度

// 刷新下载进度
        Timer timer = new Timer();
        TimerTask task = new TimerTask() {
            @Override
            public void run() {
                DownloadManager.Query query = new DownloadManager.Query();
                Cursor cursor = downloadManager.query(query.setFilterById(downloadId ));
                if (cursor != null && cursor.moveToFirst()) {
                    if (cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS)) == DownloadManager.STATUS_SUCCESSFUL) {
                        // 成功后取消监听
                        task.cancel();
                    }

                    int bytesDownloaded = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR));
                    int bytesTotal = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_TOTAL_SIZE_BYTES));
                    int pro = (bytesDownloaded * 100) / bytesTotal;
                    MLog.d("下载进度 bytesDownloaded" + bytesDownloaded + "总文件大小：bytesTotal" + bytesTotal);
                    MLog.d(">>>下载进度 pro" + pro);
                }
                cursor.close();
            }
        };
        timer.schedule(task, 0, 1000);