Android DownloadProvider学习（二）

时间 2019-11-11

标签 android downloadprovider 学习栏目 Android 繁體版

原文原文链接

DownloadManager.Request用来请求一个下载，DownloadManager.Query用来查询下载信息，这两个类的具体功能会在后面穿插介绍。DownloadManager的源码可见DownloadManager@Grepcode。css

DownloadManager主要提供了下面几个接口：
public int remove(long… ids)删除下载，若下载中取消下载。会同时删除下载文件和记录。
java

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

其它：经过查看代码咱们能够发现还有个CursorTranslator私有静态内部类。这个类主要对Query作了一层代理。将 DownloadProvider和DownloadManager之间作个映射。将DownloadProvider中的十几种状态对应到了 DownloadManager中的五种状态，DownloadProvider中的失败、暂停缘由转换为了DownloadManager的缘由。git

一、AndroidManifest中添加权限github

       
Java

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

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

 
       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。app

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

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>

其中咱们会监听其中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排序。

DownloadManager.ACTION_DOWNLOAD_COMPLETE这个广播，并传递downloadId做为参数。经过接受广播咱们能够打开对下载完成的内容进行操做。代码以下：

下载成功监听
      
  

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

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

Android DownloadProvider学习 （二）

Android DownloadProvider学习（二）