• Android DownloadProvider学习 (二)


     

     

     

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

     

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

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

     

    其它:通过查看代码我们可以发现还有个CursorTranslator私有静态内部类。这个类主要对Query做了一层代理。将 DownloadProvider和DownloadManager之间做个映射。将DownloadProvider中的十几种状态对应到了 DownloadManager中的五种状态,DownloadProvider中的失败、暂停原因转换为了DownloadManager的原因。

     

    1、AndroidManifest中添加权限

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

     

     

     
     
    Java
     
    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/com.trinea.download.file");
    long downloadId = downloadManager.enqueue(request);

    上面调用downloadManager的enqueue接口进行下载,返回唯一的downloadId。

     

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

    从源码中我们可以看出下载完整目录为Environment.getExternalStoragePublicDirectory(dirType)。 不过file是通过file.mkdir()创建的,这样如果上级目录不存在就会新建文件夹异常。所以下载前我们最好自己调用File的mkdirs方法 递归创建子目录,如下:

    否则,会报异常

    其他设置下载路径接口为 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,用于响应点击的打开文件。

     

     

    下载进度状态监听代码
     

    其中我们会监听 其中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作为参数。通过接受广播我们可以打开对下载完成的内容进行操作。代码如下:

     

     

     

    openDownload源码
     

     

    如果界面上过多元素需要更新,且网速较快不断的执行onChange会对页面性能有一定影响。推荐ScheduledExecutorService定期查询,如下:

     
    Java
     

    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);
  • 相关阅读:
    css--兼容写法整理
    vuerouter-7._路由高亮
    vuerouter-6_路由杂项
    vuerouter-5.参数传递
    vuerouter-4.编程式导航
    vuerouter-3.路由嵌套
    正则表达式
    STL容器迭代器失效分析
    coredump
    获取结构体成员偏移量
  • 原文地址:https://www.cnblogs.com/kings-boke/p/4504304.html
Copyright © 2020-2023  润新知