本文主要结合源码介绍Android系统下载管理DownloadManager的强大功能及使用。
这是许久来准备写的一系列博客,这篇主要介绍DownloadManager的功能和示例,后面还有两篇会介绍下载管理的底层设计(DownloadProvider、DownloadManager、DownloadManagerUI)、下载管理如何进行功能增强和bug修改。
更多下载相关开源项目可见 Android 下载。
Demo APK 可以方便的查看效果,在各大应用商店搜索 trinea android 下载即可,如:Google Play。
可运行代码地址可见DownloadManager Demo,效果图如下:
1 |
Android网络应用开发中经常需要下载文件,如音乐、应用、系统升级包。一般的要求是统一的管理(暂停、继续、取消)中心、断点续传、并发下载、wifi及3g的不同处理、下载完成后处理、管理中心与应用的交互。可以使用RandomAccessFile和多线程自己实现。三方应用通常要么跳转到浏览器下载,要么勉强实现后却像天天动听、海豚浏览器那样bug百出(鄙视下)。实际上Android下载管理已经提供了功能强大(超乎你的想象)的API供第三方调用,google play、chrome都会调用系统下载管理进行下载。本文就以一个示例着手介绍DownloadManager的使用及丰富功能。 |
一、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中添加权限
1 2 |
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> |
网络访问权限是必须的,下载地址为sdcard的话需要添加sdcard写权限。
2、调用DownloadManager.Request开始下载
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/cn.trinea.download.file"); long downloadId = downloadManager.enqueue(request); |
上面调用downloadManager的enqueue接口进行下载,返回唯一的downloadId。
DownloadManager.Request除了构造函数的Uri必须外,其他设置都为可选设置。下面逐个介绍下:
request.setDestinationInExternalPublicDir(“Trinea”, “MeiLiShuo.apk”);表示设置下载地址为sd卡的Trinea文件夹,文件名为MeiLiShuo.apk。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
public Request setDestinationInExternalPublicDir(String dirType, String subPath) { File file = Environment.getExternalStoragePublicDirectory(dirType); Xlog.v(XLOGTAG, "setExternalPublicDir: dirType " + dirType + " subPath " + subPath + "file" + file); if (file.exists()) { if (!file.isDirectory()) { throw new IllegalStateException(file.getAbsolutePath() + " already exists and is not a directory"); } } else { if (!file.mkdir()) { throw new IllegalStateException("Unable to create directory: "+ file.getAbsolutePath()); } } setDestinationFromBase(file, subPath); return this; } |
从源码中我们可以看出下载完整目录为Environment.getExternalStoragePublicDirectory(dirType)。不过file是通过file.mkdir()创建的,这样如果上级目录不存在就会新建文件夹异常。所以下载前我们最好自己调用File的mkdirs方法递归创建子目录,如下:
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/cn.trinea.download.file”);
设置下载文件的mineType。因为下载管理Ui中点击某个已下载完成文件及下载完成点击通知栏提示都会根据mimeType去打开文件,所以我们可以利用这个属性。比如上面设置了mimeType为application/cn.trinea.download.file,我们可以同时设置某个Activity的intent-filter为application/cn.trinea.download.file,用于响应点击的打开文件。
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/cn.trinea.download.file" /> </intent-filter> |
request.addRequestHeader(String header, String value)
添加请求下载的网络链接的http头,比如User-Agent,gzip压缩等
3 下载进度状态监听及查询
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |
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的主要代码如下,可直接引入TrineaAndroidCommon@Github(欢迎star和fork^_^)作为你项目的library(如何拉取代码及添加公共库):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
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为下载管理对外开放的信息查询类,主要包括以下接口:
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作为参数。通过接受广播我们可以打开对下载完成的内容进行操作。代码如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
class CompleteReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { // get complete download id long completeDownloadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1); // to do here } }; private CompleteReceiver completeReceiver; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.download_manager_demo); … completeReceiver = new CompleteReceiver(); /** register download success broadcast **/ registerReceiver(completeReceiver, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE)); } @Override protected void onDestroy() { super.onDestroy(); unregisterReceiver(completeReceiver); } |
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函数。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
private void openDownload(Context context, Cursor cursor) { String filename = cursor.getString(cursor.getColumnIndexOrThrow(Downloads.Impl._DATA)); String mimetype = cursor.getString(cursor.getColumnIndexOrThrow(Downloads.Impl.COLUMN_MIME_TYPE)); Uri path = Uri.parse(filename); // If there is no scheme, then it must be a file if (path.getScheme() == null) { path = Uri.fromFile(new File(filename)); } Intent activityIntent = new Intent(Intent.ACTION_VIEW); mimetype = DownloadDrmHelper.getOriginalMimeType(context, filename, mimetype); activityIntent.setDataAndType(path, mimetype); activityIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); try { context.startActivity(activityIntent); } catch (ActivityNotFoundException ex) { Log.d(Constants.TAG, "no activity for " + mimetype, ex); } } |
如果界面上过多元素需要更新,且网速较快不断的执行onChange会对页面性能有一定影响。推荐ScheduledExecutorService定期查询,如下:
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秒定时刷新
我下载了源码,整个工程的,通过SVN的,但是整个工程就有问题,没有R.java 很多错误,博主帮忙看看啊
你好,我把你提供的源码移植到自己项目中,出现了一个问题:当下载进度到百分之百的时候,直接显示下载失败..文件也已经被删除了,.但是我看到你的例子就可以正常运行,是不是我配的权限有问题??帮忙解答下,,谢谢了
能正常下载应该不是权限问题,你先试试其他url能否正常下载,不能的话再调试看看日志
我查看了DownloadManager下载失败,返回的是错误未知….不知道是哪里出了问题…奇怪的是提示下载失败,文件就自动删除了…
是的,是有几个地方,下载失败,会自动删除,你搜索下delete,通过调用关系debug看看原因
我只是把项目从activity中移植到fragment中就出现这样的问题。。。。还有一个问题。为什么我改权限的包名,改成我项目的包名,就会出现空指针异常..显示不了列表信息
没懂什么意思
请问楼主,在下载时发现存储空间不足,然后在设置中将存储位置进行更改后再次点击重新下载,但是还是提示内存不足,如果重新下载一个新的文件则不会出现这种情况。请问:我该如何在更改默认存储路径后,对原先下载失败的文件点击重新下载,能够成功更改路径。
做不到的,只能重新建立一个下载,系统不提供修改下载地址的接口
在下载失败时,点击列表中的该项,会弹出一个dialog,在dialog中有一个重新下载的功能。如果在这里将当前存储路径改为设置中默认的存储路径。这样应该可以吧?
如果你们自己改rom,有源码的话,你想怎么搞都可以。我刚才指的是一般应用没法完成这个,因为DownloadManager不提供修改目的地址的接口
如果你可以修改源码,在你说的重新下载地方,把目的地址改掉,同时改掉已下载大小应该就可以了
我遇到个怪现象,在Browser下载的图片保存之后,它应该会加载到Downloads的数据库里面吧,并且Downloads里面也有下载的记录吧。但重启之后,Downloads里面没东西了,图库里面也看不到下载的图片了,请问这是什么情况呢?
很正常,浏览器很多默认使用的都是系统的下载管理。重启之后图片丢失可能是被什么应用删除掉了,但肯定不是下载管理。
你可以使用下面几种方式排查:
使用浏览器下载其他类型文件,如打开百度,搜索微信下载,看重启后是否会消失
如果仍会消失,换其他浏览器进行测试。
如果不会消失,应该是跟图片相关应用删除的,如图库
但是进去Downloads这个apk里面也没有下载记录喔,这里应该有写进它的数据库的吧!
下载记录是可以删除的,开始下载时肯定是写入数据库了,DownloadProvider数据库地址:
adb pull /data/data/com.android.providers.downloads/databases/downloads.db d:\\
我下载微信了,重启后在Downloads也看不到记录,有什么方法可以不让他删除这些记录呢?
他要是按照数据库id去删除的话,是没办法不让他删除的
试试其他浏览器,来定位是不是这个浏览器的问题。或者kill 浏览器进程重启浏览器来判断是不是该浏览器删除的
换了另外的浏览器、下载完后把浏览器kill掉,重启之后还是同样的现象!但是Downloads的数据库一直都是有记录的,只是说进去Downloads的界面看不到记录。是不是被隐藏了还是怎么地呢?
应该是隐藏了,数据库中有个is_visible_in_downloads_ui字段
设置那个也没用,我崩溃了!
数据库中is_visible_in_downloads_ui为1, deleted 为0, status 为200就可以看见了,你看看
我下载微信了,重启后在Downloads也看不到记录,有什么方法可以不让他删除这些记录呢?
查看API,看到DownloadManager是从API 9 开始加入的,但是我将Demo的minSdkVersion改为8之后,依然可以下载,请问为何?支持包里已经包含DownloadManager了吗?但是在android.support.v4中又没找到。
还有个问题,我在支持包V7中已经看到ActionBar,是说现在3.0以下的版本可以通过支持包使用系统的Actionbar了是吗(调低sdk之后,Holo的主题不能用了,你原本Demo的炫酷瞬间荡然无存…)
android:minSdkVersion是说apk能运行的最低android版本。实际调用的是你运行机器系统的接口,如果你的系统小于android:minSdkVersion是无法运行该apk的
理论上3.0以下可以通过引入v7使用Actionbar
使用2.3的测试机试了下,果然在调用API 11的方法是报错,明白这个机制了。
那现在就头疼了,因为项目需求的API等级为8,也就是完全无法使用系统的下载管理来进行下载,还是必须完全自己实现一套,这对于我这个菜鸟而言可谓任务艰巨=。=
不知道你们具体什么情况,但现在一般应用都是api等级为9,即为android2.3,这部分以上占据了市场份额的95%以上,跟windows的xp类似,难道还去考虑兼容win98吗。
你可以跟项目提这个,你自己写下载,从开发到完善,对多线程数据库不熟悉的话可能要半个多月,为了项目进度还是从2.3开始支持比较好
请问,DownloadManager支持设置同时下载个数吗
不支持设置的,DownloadHandler.java中读取的是config_MaxConcurrentDownloadsAllowed这个变量
查了下DownloadHandler,这个类是从4.0开始加入的吗?之前用的DownloadProvider的开源项目里没有这个类。。头疼了,如果在里面的话,应该很容易就能改了
试了,很好用,比我们自己写的强大多了,见识了
楼主按照你的样子做。恢复下载直接挂掉了。请问楼主的恢复下载是断点续传吗?
正在找怎么响应通知栏点击呢,太感谢了
请问楼主可以实现暂停和继续吗?我找了好久没有找到接口
暂停、继续接口没有,不过系统已经预留了这个功能。非下载管理进程要通过修改DownloadProvider才能实现,大概这两天会说下怎么修改这块的代码去支持
写的真不错,我一直以为没办法得到下载进度呢,学习了