Android xUtils3下载文件的使用

xUtils3简介
　　xUtils 包含了orm, http(s), image, view注解, 但依然很轻量级(246K), 并且特性强大, 方便扩展:

1. 稳定的基石: AbsTask和统一的回调接口Callback, 任何异常, 即使你的回调方法实现有异常都会进入onError, 任何情况下onFinished总会让你知道任务结束了.
2. 基于高效稳定的orm工具, http模块得以更方便的实现cookie(支持domain, path, expiry等特性)和 缓存(支持Cache-Control, Last-Modified, ETag等特性)的支持.
3. 有了强大的http及其下载缓存的支持, image模块的实现相当的简洁, 并且支持回收被view持有, 但被Mem Cache移除的图片, 减少页面回退时的闪烁.
4. view注解模块仅仅400多行代码却灵活的支持了各种View注入和事件绑定, 包括拥有多了方法的listener的支持.

本文基于xUtils3实现从服务器下载文件（Apk）的功能，其中，xUtils3网络模块大大方便了在实际开发中网络模块的开发，xUtils3网络模块大致包括GET请求、POST请求、如何使用其他请求方式、上传文件、下载文件、使用缓存等功能，下面将对下载文件进行使用说明：：

1. 集成xUtils3，使用Gradle构建时添加一下依赖即可

   compile 'org.xutils:xutils:3.5.0'

2. 加入所需要的权限声明；

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

3. 初始化创建建Application，并在AndroidManifest.xml文件中进行配置

public class MyMobileApplication extends Application {    @Override    public void onCreate() {        super.onCreate();        x.Ext.init(this);        x.Ext.setDebug(BuildConfig.DEBUG); // 是否输出debug日志, 开启debug会影响性能.    }}

　　AndroidManifest.xml文件中配置如下：

    <application        android:name=".MyMobileApplication"        ......        android:theme="@style/AppTheme">        <activity android:name=".activity.SplashActivity">            ......        </activity>    </application>

1. 下载功能的实现，这里以下载我们自己Tomcat上的Apk为例进行说明

    /**     * 下载服务器端更新后最新的apk     */    private void downloadUpdateApk() {        if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {            mProgressDialog = new ProgressDialog(SplashActivity.this);            String path = Environment.getExternalStorageDirectory().getAbsolutePath() + File.separator;            // mDownloadUrl为JSON从服务器端解析出来的下载地址            RequestParams requestParams = new RequestParams(mDownloadUrl);            // 为RequestParams设置文件下载后的保存路径            requestParams.setSaveFilePath(path);            // 下载完成后自动为文件命名            requestParams.setAutoRename(true);            x.http().get(requestParams, new Callback.ProgressCallback<File>() {                @Override                public void onSuccess(File result) {                    Log.i(tag, "下载成功");                    mProgressDialog.dismiss();                }                @Override                public void onError(Throwable ex, boolean isOnCallback) {                    Log.i(tag, "下载失败");                    mProgressDialog.dismiss();                }                @Override                public void onCancelled(CancelledException cex) {                    Log.i(tag, "取消下载");                    mProgressDialog.dismiss();                }                @Override                public void onFinished() {                    Log.i(tag, "结束下载");                    mProgressDialog.dismiss();                }                @Override                public void onWaiting() {                    // 网络请求开始的时候调用                    Log.i(tag, "等待下载");                }                @Override                public void onStarted() {                    // 下载的时候不断回调的方法                    Log.i(tag, "开始下载");                }                @Override                public void onLoading(long total, long current, boolean isDownloading) {                    // 当前的下载进度和文件总大小                    Log.i(tag, "正在下载中......");                    mProgressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);                    mProgressDialog.setMessage("正在下载中......");                    mProgressDialog.show();                    mProgressDialog.setMax((int) total);                    mProgressDialog.setProgress((int) current);                }            });        }    }

程序运行示例图如下：

参考文章：

1. http://www.2cto.com/kf/201607/524976.html
2. https://github.com/wyouflf/xUtils3