Android 经典笔记之五:DownloadManager下载管理器介绍

潇湘剑雨 · · 188 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

DownloadManager下载管理器介绍 目录介绍:

  • 0.简单介绍
  • 1.所需权限
  • 2.获取对象,开始下载
  • 3.取消下载
  • 4.Request类的介绍
    • 4.5.指定下载的类型
    • 4.6.定制Notification样式
    • 4.7.设置下载文件类型
    • 4.8.添加请求下载的网络链接的http头,比如User-Agent,gzip压缩等
  • 5.Query 类
  • 6.不足之处
  • 7.代码案例【简易】

0.简单介绍

  • 关于DownloadManager简单介绍 DownloadManager是android2.3以后,系统下载的方法,是处理长期运行的HTTP下载的系统服务。客户端可以请求的URI被下载到一个特定的目标文件。客户端将会在后台与http交互进行下载,或者在下载失败,或者连接改变,重新启动系统后重新下载。还可以进入系统的下载管理界面查看进度。DownloadManger有两个内部类,Request 和Query。Request类可设置下载的一些属性。Query类可查询当前下载的进度,下载地址,文件存放目录等数据。

1.所需权限

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

注意,访问本地控件【sd卡,手机内存卡】需要检测是否添加权限

/**检测存储权限*/
private final int REQUEST_EXTERNAL_STORAGE = 1;
private String[] PERMISSIONS_STORAGE = {
        Manifest.permission.READ_EXTERNAL_STORAGE,
        Manifest.permission.WRITE_EXTERNAL_STORAGE
};

public void verifyStoragePermissions(Activity activity) {
    // Check if we have write permission
    int permission = ActivityCompat.checkSelfPermission(activity, Manifest.permission.WRITE_EXTERNAL_STORAGE);
    if (permission != PackageManager.PERMISSION_GRANTED) {
        // We don't have permission so prompt the user
        ActivityCompat.requestPermissions(activity, PERMISSIONS_STORAGE, REQUEST_EXTERNAL_STORAGE);
    }
}

2.获取对象,开始下载

  • 获取对象,开始下载
DownloadManager downloadManager = (DownloadManager)getSystemService(DOWNLOAD_SERVICE);
DownloadManager.Request request = new DownloadManager.Request(Uri.parse(apkUrl));
long id = downloadManager.enqueue(request);
//每下载的一个文件对应一个id,通过此id可以查询数据。

3.取消下载

downloadManager.remove(REFERENCE_1, REFERENCE_2, REFERENCE_3);
该方法返回成功取消的下载的个数,如果一个下载被取消了,所有相关联的文件,部分下载的文件和完全下载的文件都会被删除.

4.Request类的介绍

/**
* 方法1:
* 目录: Android -> data -> com.app -> files -> Download -> dxtj.apk
* 这个文件是你的应用所专用的,软件卸载后,下载的文件将随着卸载全部被删除
*/
request.setDestinationInExternalFilesDir( this , Environment.DIRECTORY_DOWNLOADS ,  "dxtj.apk" );
/**
* 方法2:
* 下载的文件存放地址  SD卡 download文件夹,dxtj.apk
* 软件卸载后,下载的文件会保留
*/
//在SD卡上创建一个文件夹
request.setDestinationInExternalPublicDir(  "/epmyg/"  , "dxtj.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  , "dxtj.apk" ) ;
  • 4.1 指定下载的类型
//指定在WIFI状态下,执行下载操作。
request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_WIFI);
//指定在MOBILE状态下,执行下载操作
request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE);
//是否允许漫游状态下,执行下载操作
request.setAllowedOverRoaming(boolean);
//是否允许“计量式的网络连接”执行下载操作
request.setAllowedOverMetered(boolean); //默认是允许的。
  • 4.2 定制Notification样式
//设置Notification的标题和描述
request.setTitle("标题"); 
request.setDescription("描述");
//设置Notification的显示,和隐藏。
request.setNotificationVisibility(visibility);
VISIBILTY_HIDDEN: Notification:将不会显示,如果设置该属性的话,必须要添加权限
android.permission.DOWNLOAD_WITHOUT_NOTIFICATION.
VISIBILITY_VISIBLE: Notification显示,但是只是在下载任务执行的过程中显示,下载完成自动消失。(默认值)
VISIBILITY_VISIBLE_NOTIFY_COMPLETED : Notification显示,下载进行时,和完成之后都会显示。
VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION :只有当任务完成时,Notification才会显示。
对Notification的设定方法相对较少。
  • 4.3 设置下载文件类型
request.setMimeType("application/vnd.android.package-archive");
这是安卓.apk文件的类型。有些机型必须设置此方法,才能在下载完成后,点击通知栏的Notification时,才能正确的打开安装界面。不然会弹出一个Toast(can not open file).其他文件类型的MimeType
  • 4.4 添加请求下载的网络链接的http头,比如User-Agent,gzip压缩等
request.addRequestHeader(String header, String value);

5.Query 类

  • 我们的需求,可能不只是在Notification 中显示进度就好了,也许,在app中也需要获取实时下载进度。所以Query类就是提供查询的一些方法。
  • 但API中就只有两个方法,原来,他把数据保存在数据库中去了。我们需要获得一个Cursor 结果集,通过结果集获得我们想要的数据。
DownloadManager.Query query = new DownloadManager.Query();
Cursor cursor = downloadManager.query(query.setFilterById(id));
if (cursor != null && cursor.moveToFirst()) {
    //下载的文件到本地的目录
    String address = cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI));
    //已经下载的字节数
    int bytes_downloaded = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR));
    //总需下载的字节数
    int bytes_total = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_TOTAL_SIZE_BYTES));
    //Notification 标题
    String title =cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_TITLE));
    //描述
    String description =cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_DESCRIPTION));
    //下载对应id
    long id =cursor.getLong(cursor.getColumnIndex(DownloadManager.COLUMN_ID));
    //下载文件名称
    String filename =cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_FILENAME));
    //下载文件的URL链接
    String url =cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_URI));
}

6.不足之处

  • 1、我发现,在下载的时候,发送Notification时 是没有声音的。也没有设置声音的方法。不过这影响不大。主要的功能实现就好。
  • 2、因为这是系统的类,每个系统的Notification界面是不一样的。这就是每个rom厂家的自定义了。小米和魅族的就大不一样。魅族Notification上有一个下载暂停的按钮,而小米没有。所以导致Notification是不能统一的。其实,暂停的话用户可以点击notification,进入到下载管理界面,就有暂停按钮了。

7.代码案例【简易】

/**
* 开始下载
* @param context
*/
private static void startDownload(Context context) {
    int status = getDownloadStatus(context);
    if (status != DOWNLOAD_STATUS_NEED_LOAD) {
        // 不用下载则无需下列操作
        return;
    }

    DialogUtils.showToast(context, "开始下载安装包...");
    // parse url
    Uri mUri = Uri.parse(path);
    // create request
    DownloadManager.Request r = new DownloadManager.Request(mUri);
    // set request property
    String apkName = getDownloadApkName(context);
    // set 下载路径
    r.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, apkName);
    // set Notification
    r.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
    // create manager
    DownloadManager dm = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE);
    // key code, set mine type
    r.setMimeType("application/vnd.android.package-archive");
    // add to queue
    dm.enqueue(r);
}

/**获得Apk的名称*/
@NonNull
private static String getDownloadApkName(Context context) {
    return context.getString(R.string.app_name) + "_" + version + ".apk";
}

/**
* 判断当前版本文件下载状态
* @param context
* @return
*/
private static int getDownloadStatus(Context context) {
    DownloadManager.Query query = new DownloadManager.Query();
    DownloadManager dm = (DownloadManager) context.getSystemService(Activity.DOWNLOAD_SERVICE);
    Cursor c = dm.query(query);

    if (!c.moveToFirst()) {
        // 无下载内容
        return DOWNLOAD_STATUS_NEED_LOAD;
    }

    do {
        int status = c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS));
        String title = c.getString(c.getColumnIndex(DownloadManager.COLUMN_TITLE));
        String apkName = getDownloadApkName(context);
        if (title.equals(apkName)) {
            // 如果下载列表中文件是当前版本应用,则继续判断下载状态
            if (status == DownloadManager.STATUS_SUCCESSFUL) {
                // 如果已经下载,返回状态,同时直接提示安装
                String uri = c.getString(c.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI));
                promptInstall(context, Uri.parse(uri));
                return DOWNLOAD_STATUS_LOADED;
            } else if (status == DownloadManager.STATUS_RUNNING
                    || status == DownloadManager.STATUS_PAUSED
                    || status == DownloadManager.STATUS_PENDING) {
                return DOWNLOAD_STATUS_RUNNING;
            } else {
                // 失败也视为可以再次下载
                return DOWNLOAD_STATUS_NEED_LOAD;
            }
        }
    } while (c.moveToNext());
    return DOWNLOAD_STATUS_NEED_LOAD;
}

/**
* 根据下载队列id获取下载Uri
* @param enqueueId
* @return null-获取不到
*/
public static Uri getDownloadUriById(Context context, long enqueueId) {
    DownloadManager.Query query = new DownloadManager.Query();
    query.setFilterById(enqueueId);
    DownloadManager dm = (DownloadManager) context.getSystemService(Activity.DOWNLOAD_SERVICE);
    Cursor c = dm.query(query);
    if (c.moveToFirst()) {
        int columnIndex = c.getColumnIndex(DownloadManager.COLUMN_STATUS);
        if (DownloadManager.STATUS_SUCCESSFUL == c.getInt(columnIndex)) {
            String uri = c.getString(c.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI));
            return Uri.parse(uri);
        }
    }
    return null;
}

/**
* 安装文件
* @param context      上下文
* @param data          uri地址
*/
public static void promptInstall(Context context, Uri data) {
    Intent promptInstall = new Intent(Intent.ACTION_VIEW).setDataAndType(data, "application/vnd.android.package-archive");
    // FLAG_ACTIVITY_NEW_TASK 可以保证安装成功时可以正常打开 app
    promptInstall.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    context.startActivity(promptInstall);
}

其他

  • 知乎:https://www.zhihu.com/people/yang-chong-69-24/pins/posts
  • 领英:https://www.linkedin.com/in/chong-yang-049216146/
  • 简书:http://www.jianshu.com/u/b7b2c6ed9284
  • csdn:http://my.csdn.net/m0_37700275
  • 网易博客:http://yangchong211.blog.163.com/
  • 新浪博客:http://blog.sina.com.cn/786041010yc
  • github:https://github.com/yangchong211
  • 喜马拉雅听书:http://www.ximalaya.com/zhubo/71989305/
  • 脉脉:yc930211
  • 开源中国:https://my.oschina.net/zbj1618/blog
  • 邮箱:yangchong211@163.com

本文来自:开源中国博客

感谢作者:潇湘剑雨

查看原文:Android 经典笔记之五:DownloadManager下载管理器介绍

188 次点击  
加入收藏 微博
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet