基于DownloadManager的简单下载器

一直听说过Android自带的DownloadManager,只是拖延症发作,一直没有时间去研究研究,其实在很多项目开发中,都有一个功能是非常重要的,那就是应用的检查更新了!基于DownloadManager,可以做一个轻量级的下载器,将下载任务交给系统去执行,减轻自身APP的压力,何乐而不为呢?!

DownloadManager的基本使用姿势

通过getSystemService进行实例化

DownloadManager downloadManager = (DownloadManager)context.getSystemService(Context.DOWNLOAD_SERVICE);

构建下载请求

DownloadManager.Request request = new DownloadManager.Request(Uri.parse("目标文件下载地址"));
//设置目标文件夹,如果你想在系统的storage目录下载一个testDownload/test/test.apk
request.setDestinationInExternalPublicDir("testDownload", "test/test.apk");
//设置下载所需的网络环境,设置了移动网络和WiFi环境下均能下载 request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE | DownloadManager.Request.NETWORK_WIFI);
//通知栏设置
//显示在通知栏
request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE);

注意!!!如果选择不显示在通知栏,那么必须声明以下权限

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

然后设置不可见

request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_HIDDEN);

否则将会抛出一个securityException

//设置文件类型为apk类型,当downloadManager调用openFile时会唤起相应的程序
request.setMimeType("application/cn.trinea.download.file");
 //开始下载,得到一个唯一的downloadId,大有用处
long downloadId = downloadManager.enqueue(request);

如何获取下载的情况呢

private int[] getBytesAndStatus(long downloadId) {

       //构建一个数组,存放已下载文件大小、总大小、下载状态
       int[] bytesAndStatus = new int[]{
               -1, -1, 0
       };
       //通过构建下载请求时获得的downloadId进行文件查询
       DownloadManager.Query query = new DownloadManager.Query().setFilterById(downloadId);
       Cursor cursor = null;
       try {
           cursor = downloadManager.query(query);
           if (cursor != null && cursor.moveToFirst()) {
               //已经下载文件大小
               bytesAndStatus[0] = cursor.getInt(cursor.getColumnIndexOrThrow(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR));
               //下载文件的总大小
               bytesAndStatus[1] = cursor.getInt(cursor.getColumnIndexOrThrow(DownloadManager.COLUMN_TOTAL_SIZE_BYTES));
               //下载状态
               bytesAndStatus[2] = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS));
           }
       } finally {
           if (cursor != null) {
               cursor.close();
           }
       }
       return bytesAndStatus;
   }

注册监听文件下载成功的广播

private BroadcastReceiver downloadCompleteReceiver;
downloadCompleteReceiver = new BroadcastReceiver() {
            @Override
            public void onReceive(Context context, Intent intent) {
                //文件下载成功时
                 DownloadManager.Query query = new DownloadManager.Query();
                //通过下载的id查找
                query.setFilterById(downloadId);
                Cursor c = downloadManager.query(query);
                if (c.moveToFirst()) {
                        int status = c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS));
                       switch (status) {
                            //下载完成
                            case DownloadManager.STATUS_SUCCESSFUL:

                                  break;

                              }

                  }
            }
        };
//注册,这里只能拦截文件下载成功的广播,并不能进行进度监听,在适当的地方取消订阅广播
context.registerReceiver(downloadCompleteReceiver,
                new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));

网上很多博客都是通过自定义ContentObserver获取本地文件变化,其实可以另辟蹊径,通过一个定时器间隔调用以上getBytesAndStatus(long downloadId)能达到同样的效果,用Rxjava实现一个简单的定时器

/**
  * 由于DownloadManager自身没有提供实时进度的api,所以通过以下定时器获取已下载的文件大小
  */
   private void updateProgress() {
               //每隔0.5秒刷新一次进度,在适当的地方记得注销 timeDisposable
                Disposable  timeDisposable = Observable.interval(500, TimeUnit.MILLISECONDS).subscribeOn(Schedulers.io())
               .observeOn(AndroidSchedulers.mainThread()).subscribe(new DataConsumer<Long>() {
                   @Override
                   public void acceptData(@io.reactivex.annotations.NonNull Long aLong) {

                       int [ ]  bytesAndStatus = getBytesAndStatus(downloadId);
                       //todo 在这里进行回调即可
                   }
               });

   }

了解完DownloadManager基本的使用方式,那么基于它来封装一个简单易用的下载器吧!

实现效果

  DownloadHelper.Builder builder = new DownloadHelper.Builder(this).title("下载通知")
                    .description("正在下载新版本V1.2.0")
                    .downloadUrl("http://download.sj.qq.com/upload/connAssitantDownload/upload/MobileAssistant_1.apk")
                    .fileSaveName("MobileAssistant_1.apk").fileSavePath("testDownload")
                    .notifyVisible(true)
                    .fileType(DownloadHelper.FileType.APK).apkInstallHint(true).onProgressListener(new DownloadHelper.OnDownloadProgressListener() {
                        @Override
                        public void onProgress(int downloadedSize, int totalSize) {

                            int progress =(int)((downloadedSize*1.0f/totalSize)*100);
                            Logger.d("progress=%d",progress);
                             //进度回调

                        }

                        @Override
                        public void onSuccess(Uri fileUri) {
                          //文件下载成功回调的Uri
 

                        }

                        @Override
                        public void onFail() {
                          //文件下载失败
    

                        }

                        @Override
                        public void fileAlreadyExits(File file) { 
                        //当你想重复下载同样的文件时,本地检测是否存在同样的文件,进行回调
                          
                        }
                    });
            DownloadHelper downloadHelper = builder.build();
            //开始下载
            downloadHelper.start();
            //移除下载任务
            downloadHelper.deleteDownloadFile();

源码请到https://github.com/yuwenque/SimpleDownloadHelper.git

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,829评论 1 331
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,603评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,846评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,600评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,780评论 3 272
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,695评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,136评论 2 293
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,862评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,453评论 0 229
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,942评论 2 233
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,347评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,790评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,293评论 3 221
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,839评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,448评论 0 181
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,564评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,623评论 2 249

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,050评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,472评论 25 707
  • DownloadManager简介DownloadManager是Android 2.3(API level 9)...
    AJoyce_阅读 23,207评论 9 81
  • “忍一时风平浪静,退一步海阔天空”,“把对你不好的人名字写在沙滩上,把对你好的人名字刻在石头上”,风儿吹走了烦恼,...
    晓群阅读 257评论 2 0
  • 这是第二个21天的最后一天,比想象中快,但是这个21天并不完美。如果说第一个21天只是适应,那么第二次开始本应做的...
    Fx_阅读 127评论 0 1