源码
写在前面
之前项目需要实现内部更新功能,看到了Android实现APP在线下载更新这篇文章,对于能够一行代码就集成更新模块很感兴趣,看了下作者的源码,发现和项目需求略有些出入,而且没有做7.0的适配,所以尝试着写了一个更新库,总体思路参考该作者,致谢!
需求与实现代码
项目里的需求主要是这样
- 1.进入APP时进行自动更新检测,同时在设置页可以手动检测更新。
- 2.后台提供版本号和版本名进行选择更新,同时提供最低版本名和版本号,也就是在目前版本低于最低版本时,说明后台API发生了变化,低于最低版本的APP已经不能用了,必须强制更新。
代码完成后写起来是这样的,参考了作者的写法,只是多了一些可选的字段。
UpdateManager.getInstance().init(this)
.compare(UpdateManager.COMPARE_VERSION_NAME)
.downloadUrl("http://aaa.apk")
.downloadTitle("我在下载xxxb了")
.lastestVerCode(0)
.minVerCode(1)
.lastestVerName("1.1")
.update();
大致思路
- 1.更新下载的话,考虑采用官方提供的DownloadManager。之前想用其它下载库,不过app的更新模块也就只有更新版本才会用到,还是不要再引入额外的依赖了,而且DownloadManager用起来还是挺方便的。
- 2.由于存在手动更新的功能,如果当前已经处于更新了,那再调用更新模块的话,需要进行提示;同时,如果是最新版本了,进入APP时不进行提示,但在手动更新时需要,所以考虑采用单例模式和接口回调,将检测结果返回。
- 3.采用注册广播的方式,监听下载完成并自动安装
- 4.主要代码分为UpdateManager和UpdateReceiver,前者负责更新版本对比和下载APK,后者负责下载完成后的操作。
UpdateManager
先在AndroidManifest里进行注册权限
采用单例进行创建,简化版的构建者模式进行参数设置
public static UpdateManager getInstance() {
if (mInstance == null) {
mInstance = new UpdateManager();
}
return mInstance;
}
/**
* 初始化,必备
*/
public UpdateManager init(Context context) {
this.mContext = context;
mCurrentVerName = LibUtils.getVersionName(mContext);
mCurrentVerCode = LibUtils.getVersionCode(mContext);
return this;
}
/**
* 最新版本名
*/
public UpdateManager lastestVerName(String versionName) {
this.mLastestVerName = versionName;
return this;
}
在update()的方法中,开始进入更新流程,先判断当前是否处于更新下载中,然后进行版本对比
public UpdateManager update() {
if (isUpdating) {
Toast.makeText(mContext, "正在更新中...", Toast.LENGTH_SHORT).show();
return this;
} else {
checkUpdate();
return this;
}
}
/**
* 检查更新
*/
private void checkUpdate() {
// 跳过版本对比,强制更新
if (isForce) {
beginUpdate(true);
if (mListener != null) {
mListener.onCheckResult(RESULT_FORCE);
}
return;
}
switch (mCompare) {
case COMPARE_VERSION_CODE:
compareVerCode();
break;
case COMPARE_VERSION_NAME:
compareVerName();
break;
default:
compareVerCode();
break;
}
}
对比版本后,如果设置了最低版本,同时当前版本又低于最低版本时,提示必须更新,否则退出程序;反之只进行新版本提示,最后进行下载
private void download() {
if (TextUtils.isEmpty(mDownloadUrl)) {
return;
}
String filePath = null;
if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {//外部存储卡
filePath = Environment.getExternalStorageDirectory().getAbsolutePath();
} else {
Toast.makeText(mContext, "没有SD卡", Toast.LENGTH_SHORT).show();
return;
}
mApkPath = filePath + File.separator + "update.apk";
File file = new File(mApkPath);
if (file.exists()) {
file.delete();
}
Uri fileUri = Uri.parse("file://" + mApkPath);
Uri uri = Uri.parse(mDownloadUrl);
DownloadManager downloadManager = (DownloadManager) mContext
.getSystemService(Context.DOWNLOAD_SERVICE);
DownloadManager.Request request = new DownloadManager.Request(uri);
request.setVisibleInDownloadsUi(true);
request.setTitle(mDownloadTitle);
request.setDestinationUri(fileUri);
mApkId = downloadManager.enqueue(request);
isUpdating = true;
}
这里大概分三步
- 1.SD卡判断和路径设置
- 2.获取DownloadManager并构建下载请求request
- 3.调用enqueue发起异步下载,返回id作为标识,设置更新状态为下载中
UpdateReceiver
UpdateReceiver继承自BroadcastReceiver,监听下载完成,先在AndroidManifest里进行注册receiver
然后在onReceive中进行下载完成后的逻辑
if (!DownloadManager.ACTION_DOWNLOAD_COMPLETE.equals(intent.getAction())) {
return;
}
DownloadManager.Query query = new DownloadManager.Query();
query.setFilterById(UpdateManager.mApkId);
DownloadManager downloadManager = (DownloadManager) context
.getSystemService(Context.DOWNLOAD_SERVICE);
Cursor cursor = downloadManager.query(query);
if (cursor.moveToFirst()) {
int status = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS));
switch (status) {
case DownloadManager.STATUS_PAUSED:
break;
case DownloadManager.STATUS_PENDING:
UpdateManager.isUpdating = true;
break;
case DownloadManager.STATUS_RUNNING:
UpdateManager.isUpdating = true;
break;
case DownloadManager.STATUS_SUCCESSFUL:
UpdateManager.isUpdating = false;
installApk(context);
break;
case DownloadManager.STATUS_FAILED:
UpdateManager.isUpdating = false;
downloadManager.remove(UpdateManager.mApkId);
break;
default:
break;
}
}
通过DownloadManger下载后,系统会发出广播。如果此时还有其它下载任务时,怎么知道完成的是不是我们的apk下载呢?可以通过DownloadManager.Query配合Cursor进行查询
This class may be used to filter download manager queries
在UpdateManager的最后,我们发起下载任务时,返回了一个id,这个id可以设置到Query中, 通过Cursor获取下载状态status,具体用法参考代码或者文档。当下载完成后,设置更新状态为否,同时如果下载成功的话进行自动安装。
private void installApk(Context context) {
if (TextUtils.isEmpty(UpdateManager.mApkPath)) {
return;
}
Uri uri;
Intent intent = new Intent(Intent.ACTION_VIEW);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
uri = FileProvider.getUriForFile(context, context.getPackageName() + ".fileprovider",
new File(UpdateManager.mApkPath));
} else {
uri = Uri.fromFile(new File(UpdateManager.mApkPath));
}
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.setDataAndType(uri, "application/vnd.android.package-archive");
context.startActivity(intent);
// 是否关闭app
// android.os.Process.killProcess(android.os.Process.myPid());
}
自动安装的代码比较简单,通过设置下载完成的apk本地uri就可以进行自动安装,不过在7.0之后,对应用外访问的Uri进行处理加密,如果直接传入uri进行安装的话的话,在7.0上的手机会报错,所以需要用到FileProvider
自动安装7.0 适配
关于FileProvider详情参考文档介绍或者Android7.0须知--应用间共享文件(FileProvider)这篇文章,这里只大概说下怎么用。
- 1.在res目录下创建xml文件夹,新建个file_paths文件,文件命名看个人。
- 2.在AndroidManifest里注册provider
这里需要注意的是authorities,命名为应用包名+".fileprovider",android:resource是刚刚新建的xml文件
- 3.设置权限FLAG_GRANT_READ_URI_PERMISSION,使用FileProvider.getUriForFile获取uri
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
uri = FileProvider.getUriForFile(context, context.getPackageName() + ".fileprovider",
new File(UpdateManager.mApkPath));
}
使用相关
具体可参考源码
- 1.在app的build.gradle中添加依赖
compile 'cn.xiaoluo:update-manager:1.2.0'
- 2.AndroidManifest里进行注册FileProvider,需要把android:authorities中的包名替换成应用包名
- 参数介绍
UpdateManager.getInstance().init(this) // 获取实例并初始化,必要
.compare(UpdateManager.COMPARE_VERSION_NAME) // 通过版本号或版本名比较,默认版本号
.downloadUrl("http://aaa.apk") // 下载地址,必要
.downloadTitle("我在下载xxxb了") // 下载标题
.lastestVerName("1.0") // 最新版本名
.lastestVerCode(0) // 最新版本号
.minVerName("1.0") // 最低版本名
.minVerCode(1) // 最低版本号
.isForce(true) // 是否强制更新,true无视版本直接更新
.update() // 开始更新
// 设置版本对比回调
.setListener(new UpdateManager.UpdateListener() {
@Override
public void onCheckResult(String result) {
Toast.makeText(mContext, result, Toast.LENGTH_SHORT).show();
}
});
- 简单使用
UpdateManager.getInstance().init(this)
.downloadUrl("http://aaa.apk")
.lastestVerCode(2)
.update();
- 版本对比:
版本名:采用版本管理格式(如1.0.0),依次对比各个数字,越往前决定权越高,如2.0.1 > 1.9.9
当前前面各数字均一致时,以更长的为高版本,如1.2.2.1 > 1.2.2
版本号:数值高的为高版本