一、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)查询下载信息。

public static Long getRecommendedMaxBytesOverMobile(Context context通过移动网络下载的最大字节数
public String getMimeTypeForDownloadedFile(long id)得到下载的mimeType，如何设置后面会进行介绍

其它：通过查看代码我们可以发现还有个CursorTranslator私有静态内部类。这个类主要对Query做了一层代理。将DownloadProvider和DownloadManager之间做个映射。将DownloadProvider中的十几种状态对应到了DownloadManager中的五种状态，DownloadProvider中的失败、暂停原因转换为了DownloadManager的原因。

二、下载管理示例
下面具体介绍利用DownloadManager进行下载。
1、AndroidManifest中添加权限

Java
1
2

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

网络访问权限是必须的，下载地址为sdcard的话需要添加sdcard写权限。

2、调用DownloadManager.Request开始下载

Java
1
2
3
4
5
6
7
8
9
10
11

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。

DownloadManager.Request除了构造函数的Uri必须外，其他设置都为可选设置。下面逐个介绍下：
request.setDestinationInExternalPublicDir(“Trinea”, “MeiLiShuo.apk”);表示设置下载地址为sd卡的Trinea文件夹，文件名为MeiLiShuo.apk。

setDestinationInExternalPublicDir源码

从源码中我们可以看出下载完整目录为Environment.getExternalStoragePublicDirectory(dirType)。不过file是通过file.mkdir()创建的，这样如果上级目录不存在就会新建文件夹异常。所以下载前我们最好自己调用File的mkdirs方法递归创建子目录，如下：

Java
1
2

File folder = new File ( folderName ) ;
return ( folder . exists ( ) && folder . isDirectory ( ) ) ? true : folder . mkdirs ( ) ;

否则，会报异常

1
2

java .lang .IllegalStateException : Unable to create directory : /storage /sdcard0 /Trinea /aa
at android .app .DownloadManager $Request .setDestinationInExternalPublicDir (DownloadManager .java )

其他设置下载路径接口为setDestinationUri，setDestinationInExternalFilesDir，setDestinationToSystemCache。其中setDestinationToSystemCache仅限系统app使用。

request.allowScanningByMediaScanner();表示允许MediaScanner扫描到这个文件，默认不允许。

request.setTitle(“MeiLiShuo”);设置下载中通知栏提示的标题
request.setDescription(“MeiLiShuo desc”);设置下载中通知栏提示的介绍
request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
表示下载进行中和下载完成的通知栏是否显示。默认只显示下载中通知。VISIBILITY_VISIBLE_NOTIFY_COMPLETED表示下载完成后显示通知栏提示。VISIBILITY_HIDDEN表示不显示任何通知栏提示，这个需要在AndroidMainfest中添加权限android.permission.DOWNLOAD_WITHOUT_NOTIFICATION.

request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_WIFI);
表示下载允许的网络类型，默认在任何网络下都允许下载。有NETWORK_MOBILE、NETWORK_WIFI、NETWORK_BLUETOOTH三种及其组合可供选择。如果只允许wifi下载，而当前网络为3g，则下载会等待。
request.setAllowedOverRoaming(boolean allow)移动网络情况下是否允许漫游。

request.setMimeType(“application/com.trinea.download.file”);
设置下载文件的mineType。因为下载管理Ui中点击某个已下载完成文件及下载完成点击通知栏提示都会根据mimeType去打开文件，所以我们可以利用这个属性。比如上面设置了mimeType为application/com.trinea.download.file，我们可以同时设置某个Activity的intent-filter为application/com.trinea.download.file，用于响应点击的打开文件。

Java
1
2
3
4
5
6
7

< intent - filter >
     < action android : name = "android.intent.action.VIEW" / >
     < category android : name = "android.intent.category.DEFAULT" / >
     < data android : mimeType = "application/com.trinea.download.file" / >
< / intent - filter >

request.addRequestHeader(String header, String value)
添加请求下载的网络链接的http头，比如User-Agent，gzip压缩等

3 下载进度状态监听及查询

下载进度状态监听代码

其中我们会监听Uri.parse(“content://downloads/my_downloads”)。然后查询下载状态和进度，发送handler进行更新，handler中处理就是设置进度条和状态等。

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

下载进度状态查询代码

从上面代码可以看出我们主要调用DownloadManager.Query()进行查询。DownloadManager.Query为下载管理对外开放的信息查询类，主要包括以下接口：

setFilterById(long… ids)根据下载id进行过滤
setFilterByStatus(int flags)根据下载状态进行过滤
setOnlyIncludeVisibleInDownloadsUi(boolean value)根据是否在download ui中可见进行过滤。

orderBy(String column, int direction)根据列进行排序，不过目前仅支持DownloadManager.COLUMN_LAST_MODIFIED_TIMESTAMP和DownloadManager.COLUMN_TOTAL_SIZE_BYTES排序。

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

下载成功监听

5、响应通知栏点击
(1) 响应下载中通知栏点击
点击下载中通知栏提示，系统会对下载的应用单独发送Action为DownloadManager.ACTION_NOTIFICATION_CLICKED广播。intent.getData为content://downloads/all_downloads/29669，最后一位为downloadId。
如果同时下载多个应用，intent会包含DownloadManager.EXTRA_NOTIFICATION_CLICK_DOWNLOAD_IDS这个key，表示下载的的downloadId数组。这里设计到下载管理通知栏的显示机制，会在下一篇具体介绍。

(2) 响应下载完成通知栏点击
下载完后会调用下面代码进行处理，从中我们可以发现系统会调用View action根据mimeType去查询。所以可以利用我们在介绍的DownloadManager.Request的setMimeType函数。

openDownload源码

如果界面上过多元素需要更新，且网速较快不断的执行onChange会对页面性能有一定影响。推荐ScheduledExecutorService定期查询，如下:

Java
1
2
3
4
5
6
7
8
9

public static ScheduledExecutorService scheduledExecutorService = Executors . newScheduledThreadPool ( 3 ) ;
Runnable command = new Runnable ( ) {
         @Override
         public void run ( ) {
             updateView ( ) ;
         }
     } ;
scheduledExecutorService . scheduleAtFixedRate ( command , 0 , 3 , TimeUnit . SECONDS ) ;

表示3秒定时刷新

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

  1. Android系统下载管理DownloadManager

    转载: http://www.trinea.cn/android/android-downloadmanager/ http://www.trinea.cn/android/android-downl ...

  2. ［Android］之一：Android系统下载管理DownloadManager

    嗷,这个android系统下载管理DownloadManager功能还是蛮强大的.虽然老大只是让我做一个下载工具类给他们使用,但是想加深一下印象,接下来是摘抄笔记,以后也要自己再看看不要又忘了. 一. ...

  3. Android 系统（58）---Android 系统 UI - SystemUI之功能介绍和UI布局实现

    Android 系统 UI - SystemUI之功能介绍和UI布局实现 前言 Android ROM开发过程中,难免会涉及到对SystemUI的修改,之前做过一些这方面的工作,现在整理下,准备按照如 ...

  4. Android 系统 UI - SystemUI之功能介绍和UI布局实现

    前言 Android ROM开发过程中,难免会涉及到对SystemUI的修改,之前做过一些这方面的工作,现在整理下,准备按照如下章节介绍SystemUI.借此对SystemUI做下整体性回顾.  -S ...

  5. ANDROID 系统下载

    从Android 2.3(API level 9)开始Android用系统服务(Service)的方式提供了Download Manager来优化处理长时间的下载操作.Download Manager ...

  6. Fl Studio 20.8英文切换中文正式版下载及新增功能介绍说明

    水果做电子音乐,可以说是非常牛逼的,但是唯一的缺点就是只有英文版,对于那些想用水果编曲的音乐人们来说,可以说是一个硬伤,没有中文版,因此也可以说是流失了一批潜在的客户. 随着最近两年的版本升级,Cub ...

  7. 电商管理后台功能介绍

    电商管理后台功能介绍 管理员登录.退出 用户管理 1.查看用户列表.可以使用分页跳转页码查看 2.查询指定用户 3.添加用户 4.修改用户信息 5.删除用户 权限管理 角色列表 1.添加角色 2.查看 ...

  8. Tiktok协议，管理粉丝功能介绍

    "uri": "tiktok-obj/8c55056c03bb66f559dadabac17d4ce5", "url_list": [&qu ...

  9. ABB机器人安全板硬件功能介绍+接线方法示例

    ABB机器人安全板硬件功能介绍+接线方法示例 ABB机器人有以下几种硬件停止功能,这些均属于EN 13849-1中描述的安全类别3,该安全类别是双通道发起的停止,如果发生单通道故障(例如接线不良),则 ...

最新文章

  1. iOS开发之Masonry框架源码解析
  2. 【总结整理】关于IE6的兼容性
  3. 使用Go语言从零编写PoS区块链
  4. DP 之 poj 2229
  5. 项目质量管理：质量与质量管理概念
  6. mysql在哪儿查看表的代码_查看mysql数据库及表编码格式
  7. springCloud五大组件--Gateway
  8. 彻底理解被称为二叉树神级遍历的莫里斯（Morris）算法
  9. c++多数据平均数_定量分析中的几个概念-平均数、算数平均数、调和平均数以及权重及应用...
  10. 多模模块接单模光纤跳线/单模模块接多模光纤跳线
  11. 谷歌浏览器（chrome）允许跨域设置的方法
  12. 企业邮箱登录地址设置公司域名
  13. PyCharm vs VSCode 到底谁更牛？
  14. （转）艾宾浩斯遗忘曲线复习计划表
  15. 棋牌算法——“贰柒拾”（字牌）
  16. 程序人生：hello程序的P2P
  17. 机器学习: 离散变量的概率分布
  18. Ghost全盘镜像备份/还原（上）
  19. xbox下载游戏一直显示排队解决方法
  20. 用 Python 验证股神巴菲特的投资经验

热门文章

  1. keil工程 freertos AC5编译器移植到AC6编译器
  2. 阿里云Centos7修改22默认端口
  3. python游戏功能_python 游戏(龙的国度)
  4. 使用Apifox解决测试文件下载出错问题
  5. 度过漫长又艰辛的 2020 年，我收集了 1273 人的年度感悟
  6. java io流过滤流_JAVA io流 文件流 字节流 字符流 过滤流 缓冲流
  7. php acs解密,RSA 加密及php实现
  8. Typora配置smms图床
  9. Unicode和Python的中文处理(收藏)
  10. mac下安装iso软件