快捷導(dǎo)航

基于DownloadManager的簡單下載器編寫小結(jié)

更新時(shí)間：2017年12月17日 09:05:53 作者：YWQalways樂觀自信愛

Android自帶的DownloadManager是一個(gè)很好的下載文件的工具。該類在API level 9之后出現(xiàn)，它已經(jīng)幫我們處理了下載失敗、重新下載等功能，整個(gè)下載過程全部交給系統(tǒng)負(fù)責(zé)，不需要我們過多的處理，非常的nice。關(guān)鍵的是用起來也很簡單，稍微封裝一下就可以幾句話搞定下載

一直聽說過Android自帶的DownloadManager，只是拖延癥發(fā)作，一直沒有時(shí)間去研究研究，其實(shí)在很多項(xiàng)目開發(fā)中，都有一個(gè)功能是非常重要的,那就是應(yīng)用的檢查更新了！基于DownloadManager，可以做一個(gè)輕量級的下載器，將下載任務(wù)交給系統(tǒng)去執(zhí)行，減輕自身APP的壓力，何樂而不為呢？！

DownloadManager的基本使用姿勢

通過getSystemService進(jìn)行實(shí)例化

DownloadManager downloadManager = (DownloadManager)context.getSystemService(Context.DOWNLOAD_SERVICE);
構(gòu)建下載請求

DownloadManager.Request request = new DownloadManager.Request(Uri.parse("目標(biāo)文件下載地址"));
//設(shè)置目標(biāo)文件夾，如果你想在系統(tǒng)的storage目錄下載一個(gè)testDownload/test/test.apk
request.setDestinationInExternalPublicDir("testDownload", "test/test.apk");
//設(shè)置下載所需的網(wǎng)絡(luò)環(huán)境,設(shè)置了移動(dòng)網(wǎng)絡(luò)和WiFi環(huán)境下均能下載 request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE | DownloadManager.Request.NETWORK_WIFI);
//通知欄設(shè)置
//顯示在通知欄
request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE);

注意?。。∪绻x擇不顯示在通知欄，那么必須聲明以下權(quán)限

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

然后設(shè)置不可見

request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_HIDDEN);

否則將會(huì)拋出一個(gè)securityException

//設(shè)置文件類型為apk類型，當(dāng)downloadManager調(diào)用openFile時(shí)會(huì)喚起相應(yīng)的程序
request.setMimeType("application/cn.trinea.download.file");
 //開始下載,得到一個(gè)唯一的downloadId，大有用處
long downloadId = downloadManager.enqueue(request);

如何獲取下載的情況呢

private int[] getBytesAndStatus(long downloadId) {

    //構(gòu)建一個(gè)數(shù)組，存放已下載文件大小、總大小、下載狀態(tài)
    int[] bytesAndStatus = new int[]{
        -1, -1, 0
    };
    //通過構(gòu)建下載請求時(shí)獲得的downloadId進(jìn)行文件查詢
    DownloadManager.Query query = new DownloadManager.Query().setFilterById(downloadId);
    Cursor cursor = null;
    try {
      cursor = downloadManager.query(query);
      if (cursor != null && cursor.moveToFirst()) {
        //已經(jīng)下載文件大小
        bytesAndStatus[0] = cursor.getInt(cursor.getColumnIndexOrThrow(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR));
        //下載文件的總大小
        bytesAndStatus[1] = cursor.getInt(cursor.getColumnIndexOrThrow(DownloadManager.COLUMN_TOTAL_SIZE_BYTES));
        //下載狀態(tài)
        bytesAndStatus[2] = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS));
      }
    } finally {
      if (cursor != null) {
        cursor.close();
      }
    }
    return bytesAndStatus;
  }

注冊監(jiān)聽文件下載成功的廣播

private BroadcastReceiver downloadCompleteReceiver;
downloadCompleteReceiver = new BroadcastReceiver() {
      @Override
      public void onReceive(Context context, Intent intent) {
        //文件下載成功時(shí)
         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;

               }

         }
      }
    };
//注冊，這里只能攔截文件下載成功的廣播，并不能進(jìn)行進(jìn)度監(jiān)聽，在適當(dāng)?shù)牡胤饺∠嗛啅V播
context.registerReceiver(downloadCompleteReceiver,
        new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));

網(wǎng)上很多博客都是通過自定義ContentObserver獲取本地文件變化，其實(shí)可以另辟蹊徑，通過一個(gè)定時(shí)器間隔調(diào)用以上getBytesAndStatus(long downloadId)能達(dá)到同樣的效果，用Rxjava實(shí)現(xiàn)一個(gè)簡單的定時(shí)器

/**
 * 由于DownloadManager自身沒有提供實(shí)時(shí)進(jìn)度的api，所以通過以下定時(shí)器獲取已下載的文件大小
 */
  private void updateProgress() {
        //每隔0.5秒刷新一次進(jìn)度，在適當(dāng)?shù)牡胤接浀米N 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 在這里進(jìn)行回調(diào)即可
          }
        });

  }

了解完DownloadManager基本的使用方式，那么基于它來封裝一個(gè)簡單易用的下載器吧！

實(shí)現(xiàn)效果

 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);
               //進(jìn)度回調(diào)

            }

            @Override
            public void onSuccess(Uri fileUri) {
             //文件下載成功回調(diào)的Uri
 

            }

            @Override
            public void onFail() {
             //文件下載失敗
  

            }

            @Override
            public void fileAlreadyExits(File file) { 
            //當(dāng)你想重復(fù)下載同樣的文件時(shí)，本地檢測是否存在同樣的文件，進(jìn)行回調(diào)
             
            }
          });
      DownloadHelper downloadHelper = builder.build();
      //開始下載
      downloadHelper.start();
      //移除下載任務(wù)
      downloadHelper.deleteDownloadFile();

源碼請到https://github.com/yuwenque/SimpleDownloadHelper.git

您可能感興趣的文章: