AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

DownloadManager 的使用

2017-05-16 1319
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 一、基本概念    1、DownloadManager是Android 2.3A （API level 9） 引入的，基于http协议，用于处理长时间下载。     2、DownloadManager对于断点续传功能支持很好 。
一、基本概念
    1、DownloadManager是Android 2.3A （API level 9） 引入的，基于http协议，用于处理长时间下载。

    2、DownloadManager对于断点续传功能支持很好 。

 

二、权限设置（由于下载会需要SD卡存储，所以需要SD卡文件读写权限）

    <uses-permission android:name="android.permission.ACCESS_DOWNLOAD_MANAGER" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

 

三、request.setNotificationVisibility 可以用来控制什么时候显示Notification，甚至是隐藏该request的Notification 。

   （1）Request.VISIBILITY_VISIBLE

          在下载进行的过程中，通知栏中会一直显示该下载的Notification，当下载完成时，该Notification会被移除，这是默认的参数值。

 

   （2）Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED

          在下载过程中通知栏会一直显示该下载的Notification，在下载完成后该Notification会继续显示，直到用户点击该Notification或者消除该Notification。

 

   （3）Request.VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION

         只有在下载完成后该Notification才会被显示。

 

    （4）Request.VISIBILITY_HIDDEN

          不显示该下载请求的Notification。如果要使用这个参数，需要在应用的清单文件中加上DOWNLOAD_WITHOUT_NOTIFICATION权限。

 

 相对应的代码

   //设置状态栏中显示Notification

     //设置Notification的标题

    request.setTitle( "微信下载" ) ;

    request.setDescription( "5.3.6" ) ;


     request.setNotificationVisibility( Request.VISIBILITY_VISIBLE ) ;

    request.setNotificationVisibility( Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED ) ;

    request.setNotificationVisibility( Request.VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION ) ;

    request.setNotificationVisibility( Request.VISIBILITY_HIDDEN ) ;

 

 四：下载的文件，存放路径

/**
     * 设置下载文件存储目录
     */
    void setDownloadFilePath( Request request ){
        /**
         * 方法1: 
         * 目录: Android -> data -> com.app -> files -> Download -> 微信.apk
         * 这个文件是你的应用所专用的,软件卸载后，下载的文件将随着卸载全部被删除
         */

        //request.setDestinationInExternalFilesDir( this , Environment.DIRECTORY_DOWNLOADS ,  "微信.apk" );  

        /**
         * 方法2:
         * 下载的文件存放地址  SD卡 download文件夹，pp.jpg
         * 软件卸载后，下载的文件会保留
         */
        //在SD卡上创建一个文件夹
        //request.setDestinationInExternalPublicDir(  "/mydownfile/"  , "weixin.apk" ) ;  


        /**
         * 方法3:
         * 如果下载的文件希望被其他的应用共享
         * 特别是那些你下载下来希望被Media Scanner扫描到的文件（比如音乐文件）
         */
        //request.setDestinationInExternalPublicDir( Environment.DIRECTORY_MUSIC,  "笨小孩.mp3" );  

        /**
         * 方法4
         * 文件将存放在外部存储的确实download文件内，如果无此文件夹，创建之，如果有，下面将返回false。
         * 系统有个下载文件夹，比如小米手机系统下载文件夹  SD卡--> Download文件夹
         */
        //创建目录
        Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).mkdir() ; 

        //设置文件存放路径
        request.setDestinationInExternalPublicDir(  Environment.DIRECTORY_DOWNLOADS  , "weixin.apk" ) ;
    }

 

五、应用实例

package com.app;
import android.app.Activity;
import android.app.DownloadManager;
import android.app.DownloadManager.Query;
import android.app.DownloadManager.Request;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.os.Environment;
import android.view.View;
import android.view.View.OnClickListener;
import android.webkit.MimeTypeMap;
import android.widget.Toast;

public class MainActivity extends Activity implements OnClickListener {

    String url = "http://shouji.360tpcdn.com/150527/c90d7a6a8cded5b5da95ae1ee6382875/com.tencent.mm_561.apk" ;
    private long  mReference = 0 ;  
    private DownloadManager downloadManager ;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView( R.layout.activity_main ) ; 

        //取消下载
        findViewById( R.id.cancle_bt ).setOnClickListener( this );

        //查看下载状态
        findViewById( R.id.look_bt ).setOnClickListener( this );

        //注册广播接收器
        IntentFilter filter = new IntentFilter( DownloadManager.ACTION_DOWNLOAD_COMPLETE ) ;   
        registerReceiver( receiver , filter ) ;   

        Request request = new Request( Uri.parse( url ) );

        //下载网络需求  手机数据流量、wifi
        request.setAllowedNetworkTypes( Request.NETWORK_MOBILE | Request.NETWORK_WIFI ) ;

        //设置是否允许漫游网络 建立请求 默认true
        request.setAllowedOverRoaming( true ) ;

        //设置通知类型
        setNotification( request ) ;

        //设置下载路径
        setDownloadFilePath( request ) ;

        /*在默认的情况下，通过Download Manager下载的文件是不能被Media Scanner扫描到的 。
        进而这些下载的文件（音乐、视频等）就不会在Gallery 和  Music Player这样的应用中看到。
        为了让下载的音乐文件可以被其他应用扫描到，我们需要调用Request对象的
         */
        request.allowScanningByMediaScanner() ; 

        /*如果我们希望下载的文件可以被系统的Downloads应用扫描到并管理，
        我们需要调用Request对象的setVisibleInDownloadsUi方法，传递参数true。*/
        request.setVisibleInDownloadsUi( true ) ;

        //设置请求的Mime
        MimeTypeMap mimeTypeMap = MimeTypeMap.getSingleton();
        request.setMimeType(mimeTypeMap.getMimeTypeFromExtension(url));

        //开始下载
        downloadManager = (DownloadManager)getSystemService(DOWNLOAD_SERVICE) ;
        mReference = downloadManager.enqueue( request ) ;

        /*
        下载管理器中有很多下载项，怎么知道一个资源已经下载过，避免重复下载呢？
        我的项目中的需求就是apk更新下载，用户点击更新确定按钮，第一次是直接下载，
        后面如果用户连续点击更新确定按钮，就不要重复下载了。
        可以看出来查询和操作数据库查询一样的
         */
        Query query = new Query() ;
        query.setFilterById( mReference );
        Cursor cursor = downloadManager.query( query ) ;  
        if ( !cursor.moveToFirst() ) {// 没有记录     

        } else {
            //有记录
        }

    }

    /**
     * 设置状态栏中显示Notification
     */
    void setNotification(Request request ) {
        //设置Notification的标题
        request.setTitle( "微信下载" ) ;

        //设置描述
        request.setDescription( "5.3.6" ) ;

        //request.setNotificationVisibility( Request.VISIBILITY_VISIBLE ) ;

        request.setNotificationVisibility( Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED ) ;

        //request.setNotificationVisibility( Request.VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION ) ;

        //request.setNotificationVisibility( Request.VISIBILITY_HIDDEN ) ; 
    }

    /**
     * 设置下载文件存储目录
     */
    void setDownloadFilePath( Request request ){
        /**
         * 方法1: 
         * 目录: Android -> data -> com.app -> files -> Download -> 微信.apk
         * 这个文件是你的应用所专用的,软件卸载后，下载的文件将随着卸载全部被删除
         */

        //request.setDestinationInExternalFilesDir( this , Environment.DIRECTORY_DOWNLOADS ,  "微信.apk" );  

        /**
         * 方法2:
         * 下载的文件存放地址  SD卡 download文件夹，pp.jpg
         * 软件卸载后，下载的文件会保留
         */
        //在SD卡上创建一个文件夹
        //request.setDestinationInExternalPublicDir(  "/mydownfile/"  , "weixin.apk" ) ;  


        /**
         * 方法3:
         * 如果下载的文件希望被其他的应用共享
         * 特别是那些你下载下来希望被Media Scanner扫描到的文件（比如音乐文件）
         */
        //request.setDestinationInExternalPublicDir( Environment.DIRECTORY_MUSIC,  "笨小孩.mp3" );  

        /**
         * 方法4
         * 文件将存放在外部存储的确实download文件内，如果无此文件夹，创建之，如果有，下面将返回false。
         * 系统有个下载文件夹，比如小米手机系统下载文件夹  SD卡--> Download文件夹
         */
        //创建目录
        Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).mkdir() ; 

        //设置文件存放路径
        request.setDestinationInExternalPublicDir(  Environment.DIRECTORY_DOWNLOADS  , "weixin.apk" ) ;
    }

    /**
     * 广播接受器, 下载完成监听器
     */
    BroadcastReceiver receiver = new BroadcastReceiver() {    
        @Override     
        public void onReceive(Context context, Intent intent) { 
            String action = intent.getAction() ;
            if( action.equals( DownloadManager.ACTION_DOWNLOAD_COMPLETE  )){
                //下载完成了
                //获取当前完成任务的ID
                long  reference = intent.getLongExtra( DownloadManager.EXTRA_DOWNLOAD_ID , -1 );

                Toast.makeText( MainActivity.this , "下载完成了" ,  Toast.LENGTH_SHORT ).show() ;
                
                //自动安装应用
                Util util = new Util() ;
                util.openFile(context );
                
            }

            if( action.equals( DownloadManager.ACTION_NOTIFICATION_CLICKED )){
                //广播被点击了
                Toast.makeText( MainActivity.this , "广播被点击了" ,  Toast.LENGTH_SHORT ).show() ;
            }
        }   
    };

    @Override
    public void onClick(View v) {
        switch ( v.getId() ) {
        case R.id.cancle_bt :
            //取消下载， 如果一个下载被取消了，所有相关联的文件，部分下载的文件和完全下载的文件都会被删除。
            downloadManager.remove( mReference ) ;
            break ;

        case R.id.look_bt :
            Query query = new Query() ;
            query.setFilterById( mReference );
            Cursor cursor = downloadManager.query( query ) ;  

            if( cursor == null ){ 
                Toast.makeText( MainActivity.this , "Download not found!", Toast.LENGTH_LONG ).show(); 
            }else{  //以下是从游标中进行信息提取 
                cursor.moveToFirst(); 
                String msg = statusMessage( cursor ) ;
                Toast.makeText( MainActivity.this , msg  ,  Toast.LENGTH_SHORT ).show() ;
            }
            break;
        }
    }   

    /**
     * 查询状态
     * @param c
     * @return
     */
    private String statusMessage(Cursor c){  
        switch(c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS ))){ 
        case DownloadManager.STATUS_FAILED:  
            return "Download failed";  
        case DownloadManager.STATUS_PAUSED:  
            return "Download paused";  
        case DownloadManager.STATUS_PENDING:  
            return "Download pending";  
        case DownloadManager.STATUS_RUNNING: 
            return "Download in progress!";  
        case DownloadManager.STATUS_SUCCESSFUL:  
            return "Download finished";  
        default: 
            return "Unknown Information";  
        } 
    }
}


六：项目下载地址

http://download.csdn.net/detail/yanzi2015/8839023

 

 

 

 

 

 

 

 

文章标签：
Android开发
存储
赵彦军521
目录
相关文章
熊猫Jay字节之旅
|
SQL Oracle 关系型数据库
不小心删除表或数据后，如何利用Oracle的闪回进行恢复
不小心删除表或数据后，如何利用Oracle的闪回进行恢复
熊猫Jay字节之旅
261 0
大数据文摘
|
3月前
|
XML 人工智能 Java
java通过自定义TraceId实现简单的链路追踪
本文介绍了如何在Spring Boot项目中通过SLF4J的MDC实现日志上下文traceId追踪。内容涵盖依赖配置、拦截器实现、网关与服务间调用的traceId传递、多线程环境下的上下文同步，以及logback日志格式配置。适用于小型微服务架构的链路追踪，便于排查复杂调用场景中的问题。
大数据文摘
143 0
LuckiBit
|
10月前
|
C语言
【C语言】continue 关键字详解
`continue` 关键字在 C 语言中用于跳过当前循环中的剩余代码，并立即开始下一次迭代。它主要用于控制循环中的流程，使程序在满足特定条件时跳过某些代码。
LuckiBit
985 1
【C语言】continue 关键字详解
91HTTP代理
|
10月前
|
网络安全 数据安全/隐私保护 UED
HTTP代理稳定性大作战长效和短效的实力较量
随着数字化时代的发展，网络安全和隐私保护成为核心需求。本文对比了长效和短效HTTP代理在连接稳定性、服务可用性、出错率及网络延迟稳定性方面的表现，帮助用户更好地选择适合的代理类型。
91HTTP代理
215 9
sunrr
|
JSON 前端开发 JavaScript
JSON文件如何读取？
JSON文件如何读取？
sunrr
783 5
梦笔生花伟
|
芯片
LDO的原理及测试方法
LM317是一种可调稳压器，核心是Bandgap Reference，用于提供1.25到37V的输出电压和1.5A的电流。了解其内部结构有助于测试和电路设计，例如理解温度系数对稳定性的影响，以及参数如IADJ（通常为50uA）的设计。测试时关注输出电压的线性和负载调整率，同时注意输入电流与输出电流的关系。LM317的测试还包括参考电压、滤波器性能、纹波抑制比等，确保电路的稳定性和效率。在多站点测试中，还需确保辅助电路的一致性和校准。
梦笔生花伟
552 4
互联网课堂
|
Java
什么锁比读写锁性能更高？
Java并发编程中，ReentrantReadWriteLock是高效的锁机制，但在高并发环境下，乐观锁（如CAS）和JDK 8引入的StampedLock可提供更高性能。StampedLock支持读锁、写锁和乐观读锁，其乐观读锁在读多写少的场景下能提升并发性能，通过tryOptimisticRead方法实现。当乐观读锁无效时，可无缝切换至悲观读锁。
互联网课堂
238 1
荔枝科研社
|
Python
分段模型线性化(PWL)【Python|Gurobi实现】
分段模型线性化(PWL)【Python|Gurobi实现】
荔枝科研社
1115 0
逆向lin狗
|
数据安全/隐私保护
App逆向百例|11|某咖啡App参数分析
App逆向百例|11|某咖啡App参数分析
逆向lin狗
622 0
gbip7sii3jwms
|
存储 移动开发 算法
408操作系统学习笔记——输入/输出（I/O）管理（下）
408操作系统学习笔记——输入/输出（I/O）管理
gbip7sii3jwms
619 1
408操作系统学习笔记——输入/输出（I/O）管理（下）