DownloadManager的使用

本文转自 http://www.cnblogs.com/zhaoyanjun/p/4591960.html，在此感谢作者

一、基本概念
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";
        }
    }
}

一、基本概念
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" ) ;
    }

时间： 2024-07-29 20:15:41

DownloadManager的使用的相关文章

DownloadManager 下载管理类

演示简介从Android 2.3开始新增了一个下载管理类,在SDK的文档中我们查找android.app.DownloadManager可以看到.下载管理类可以长期处理多个HTTP下载任务,客户端只需要给出请求的Uri和存放目标文件的位置即可,下载管理使用了一个AIDL服务器,所以可以放心的在后台执行,同时实例化的方法需要使用getSystemService(Context.DOWNLOAD_SERVICE) ,我们可以轻松的通过新增的这个API实现Android平台上的文件下载操作. Do

android webview downloadManager文件下载管理

一.downloadmanager类说明: 从Android 2.3开始新增了一个下载管理类,在SDK的文档中我们查找android.app.DownloadManager可以看到.下载管理类可以长期处理多个HTTP下载任务,客户端只需要给出请求的Uri和存放目标文件的位置即可,下载管理使用了一个AIDL服务器所以可以放心的在后台执行,同时实例化的方法需要使用getSystemService(Context.DOWNLOAD_SERVICE) ,Android123再次提醒使用API Level

使用DownloadManager实现下载功能

使用Android自带的DownloadManager实现下载功能 DownloadManager.Request request = new DownloadManager.Request(Uri.parse(APK_URL)); request.setDestinationInExternalPublicDir(DOWNLOAD_FOLDER_NAME, DOWNLOAD_FILE_NAME); request.setTitle(getString(R.string.download_not

使用downloadmanager调用系统的下载

/** * 文件名 UpdateDownload.java * 包含类名列表 com.issmobile.numlibrary.tool * 版本信息版本号 * 创建日期 2014年7月14日 * 版权声明 */ package com.issmobile.numlibrary.tool; import com.iss.utils.LogUtil; import android.annotation.SuppressLint;import android.app.DownloadMana

Android中的文件下载——DownLoadManager

一.问题概述在android开发中,经常会使用到文件下载的功能,比如app版本更新等.在api level 9之后,android系统为我们提供了DownLoadManager类,这是android提供的系统服务,我们通过这个服务完成文件下载.整个下载过程全部交给系统负责,不需要我们过多的处理. 通过API文档,可以看出DownLoadManager包含两个内部类: DownLoadManager.Query:主要用于查询下载信息. DownLoadManager.Request:主要用于发起

Android 下载模块分析(DownloadManager和DownloadProvider)

Android下载模块主要有2个部分组成:DownloadManager和DownloadProvider:其中DownloadManager提供接口供调用,具体的实现是 DownloadProvider,包括相关数据信息的保存及文件下载. DownloadManager是系统开放给第三方应用使用的类,包含两个静态内部类DownloadManager.Query和DownloadManager.Request. DownloadManager.Request用来请求一个下载 DownloadMa

Android系统下载管理DownloadManager功能介绍及使用示例

http://www.trinea.cn/android/android-downloadmanager/ 本文主要结合源码介绍Android系统下载管理DownloadManager的强大功能及使用.这是许久来准备写的一系列博客,这篇主要介绍DownloadManager的功能和示例,后面还有两篇会介绍下载管理的底层设计(DownloadProvider.DownloadManager.DownloadManagerUI).下载管理如何进行功能增强和bug修改. 示例APK可从这些地址下载:G

Android 使用 DownloadManager 管理系统下载任务的方法

从Android 2.3(API level 9)开始Android用系统服务(Service)的方式提供了Download Manager来优化处理长时间的下载操作.Download Manager处理HTTP连接并监控连接中的状态变化以及系统重启来确保每一个下载任务顺利完成. 在大多数涉及到下载的情况中使用Download Manager都是不错的选择,特别是当用户切换不同的应用以后下载需要在后台继续进行,以及当下载任务顺利完成非常重要的情况(DownloadManager对于断点续传功能支

【转】 Pro Android学习笔记（七五）：HTTP服务（9）：DownloadManager

目录(?)[-] 小例子保存在哪里下载文件信息设置和读取查看下载状态和取消下载文章转载只能用于非商业性质,且不能带有虚拟货币.积分.注册等附加条件,转载须注明出处:http://blog.csdn.net/flowingflying/ 应用有时需要从web中下载一个大文件,并保存在本地,这个操作过程是标准的,因此在Android2.3引入了DownloadManager类.相关的学习也可以参考Android学习笔记(四六):互联网通信-文件下载. 小例子先看一个小例子,如下图所示.lay

Android--调用系统的DownLoadManager去下载文件

代码里面有详细的注释: 1 /** 2 * 该方法是调用了系统的下载管理器 3 */ 4 public void downLoadApk(Context context,String url){ 5 /** 6 * 在这里返回的 reference 变量是系统为当前的下载请求分配的一个唯一的ID, 7 * 我们可以通过这个ID重新获得这个下载任务,进行一些自己想要进行的操作 8 * 或者查询下载的状态以及取消下载等等 9 */ 10 Uri uri = Uri.parse(url); //下载连