基于DownloadManager的简单下载器编写小结

 更新时间:2017年12月17日 09:05:53   作者:YWQalways乐观自信爱  
Android自带的DownloadManager是一个很好的下载文件的工具。该类在API level 9之后出现,它已经帮我们处理了下载失败、重新下载等功能,整个下载过程全部交给系统负责,不需要我们过多的处理,非常的nice。关键的是用起来也很简单,稍微封装一下就可以几句话搞定下载

一直听说过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

相关文章

  • Android Gradle Plug 4.1.0 升级后gradle获取manifest位置失败问题解决

    Android Gradle Plug 4.1.0 升级后gradle获取manifest位置失败问题解决

    这篇文章主要介绍了Android Gradle Plug 4.1.0 升级后gradle获取manifest位置失败问题解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-10-10
  • Java程序员转Android开发必读经验一份

    Java程序员转Android开发必读经验一份

    小编最近几日偷偷的发现部分Java程序员想转安卓开发,故此加紧补充知识,为大家搜集资料,积极整理前人的经验,希望可以给正处于困惑中的你,带来些许的帮助。
    2017-11-11
  • Flutter路由守卫拦截的实现

    Flutter路由守卫拦截的实现

    路由守卫拦截最常见的应用场景就是对用户数据权限的校验,本文主要介绍了Flutter路由守卫拦截的实现,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-04-04
  • Android自定义view制作绚丽的验证码

    Android自定义view制作绚丽的验证码

    这篇文章主要介绍了Android自定义view制作绚丽的验证码的相关资料,需要的朋友可以参考下
    2016-03-03
  • android实现状态栏添加图标的函数实例

    android实现状态栏添加图标的函数实例

    这篇文章主要介绍了android实现状态栏添加图标的函数,较为详细的分析了Android状态栏添加及删除图标的具体实现技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-10-10
  • Android应用隐私合规检测实现方案详解

    Android应用隐私合规检测实现方案详解

    这篇文章主要介绍了Android应用隐私合规检测实现方案,我们需要做的就是提前检测好自己的应用是否存在隐私合规问题,及时整改过来,下面提供Xposed Hook思路去检测隐私合规问题,建议有Xposed基础的童鞋阅读,需要的朋友可以参考下
    2022-07-07
  • Android 图片选择详解及实例代码

    Android 图片选择详解及实例代码

    这篇文章主要介绍了 Android 图片选择详解及实例代码的相关资料,需要的朋友可以参考下
    2016-12-12
  • 全面解析Android系统指纹启动流程

    全面解析Android系统指纹启动流程

    这篇文章主要介绍了全面解析Android系统指纹启动流程,对Android启动原理感兴趣的同学可以参考下
    2021-04-04
  • Android中ViewPager你所不知道的优化技巧分享

    Android中ViewPager你所不知道的优化技巧分享

    提到ViewPager想必各位同学一点都不陌生,它是Android中最常用的组件之一,这篇文章小编就带大家一起来看看ViewPager一些新的优化方式吧
    2024-04-04
  • flutter 路由跳转的实现示例

    flutter 路由跳转的实现示例

    这篇文章主要介绍了flutter 路由跳转的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-08-08

最新评论