- 实现android版本更新
- 对kotlin适配，调用更简单
- 自定义接口协议，可以不改变现有项目的协议就能使用
- 支持get,post请求
- 支持进度显示，对话框进度条，和通知栏进度条展示
- 支持后台下载
- 支持强制更新
- 支持简单主题色配置(可以自动从顶部图片提取主色)
- 支持自定义对话框（可以监听下载进度）
- 支持静默下载（可以设置wifi状态下）
- 支持android7.0
点击下载 Demo.apk 或扫描下面的二维码安装
dependencies {
compile 'com.qianwen:update-app:3.3.0'
}
1,java
//最简方式
new UpdateAppManager
.Builder()
//当前Activity
.setActivity(this)
//更新地址
.setUpdateUrl(mUpdateUrl)
//实现httpManager接口的对象
.setHttpManager(new UpdateAppHttpUtil())
.build()
.update();
2,kotlin
updateApp(mUpdateUrl, UpdateAppHttpUtil()).update()1，自定义接口协议，根据自己项目的接口，自己实现 parseJson 方法
String path = Environment.getExternalStorageDirectory().getAbsolutePath();
Map<String, String> params = new HashMap<String, String>();
params.put("appKey", "ab55ce55Ac4bcP408cPb8c1Aaeac179c5f6f");
params.put("appVersion", Utils.getVersionName(this));
params.put("key1", "value2");
params.put("key2", "value3");
new UpdateAppManager
.Builder()
//必须设置，当前Activity
.setActivity(this)
//必须设置，实现httpManager接口的对象
.setHttpManager(new OkGoUpdateHttpUtil())
//必须设置，更新地址
.setUpdateUrl(mUpdateUrl)
//以下设置，都是可选
//设置请求方式，默认get
.setPost(false)
//添加自定义参数，默认version=1.0.0（app的versionName）；apkKey=唯一表示（在AndroidManifest.xml配置）
.setParams(params)
//设置点击升级后，消失对话框，默认点击升级后，对话框显示下载进度
.hideDialogOnDownloading(false)
//设置头部，不设置显示默认的图片，设置图片后自动识别主色调，然后为按钮，进度条设置颜色
.setTopPic(R.mipmap.top_8)
//为按钮，进度条设置颜色，默认从顶部图片自动识别。
//.setThemeColor(ColorUtil.getRandomColor())
//设置apk下砸路径，默认是在下载到sd卡下/Download/1.0.0/test.apk
.setTargetPath(path)
//设置appKey，默认从AndroidManifest.xml获取，如果，使用自定义参数，则此项无效
//.setAppKey("ab55ce55Ac4bcP408cPb8c1Aaeac179c5f6f")
.build()
//检测是否有新版本
.checkNewApp(new UpdateCallback() {
/**
* 解析json,自定义协议
*
* @param json 服务器返回的json
* @return UpdateAppBean
*/
@Override
protected UpdateAppBean parseJson(String json) {
UpdateAppBean updateAppBean = new UpdateAppBean();
try {
JSONObject jsonObject = new JSONObject(json);
updateAppBean
//（必须）是否更新Yes,No
.setUpdate(jsonObject.optString("update"))
//（必须）新版本号，
.setNewVersion(jsonObject.optString("new_version"))
//（必须）下载地址
.setApkFileUrl(jsonObject.optString("apk_file_url"))
//（必须）更新内容
.setUpdateLog(jsonObject.optString("update_log"))
//大小，不设置不显示大小，可以不设置
.setTargetSize(jsonObject.optString("target_size"))
//是否强制更新，可以不设置
.setConstraint(false)
//设置md5，可以不设置
.setNewMd5(jsonObject.optString("new_md51"));
} catch (JSONException e) {
e.printStackTrace();
}
return updateAppBean;
}
/**
* 网络请求之前
*/
@Override
public void onBefore() {
CProgressDialogUtils.showProgressDialog(JavaActivity.this);
}
/**
* 网路请求之后
*/
@Override
public void onAfter() {
CProgressDialogUtils.cancelProgressDialog(JavaActivity.this);
}
/**
* 没有新版本
*/
@Override
public void noNewApp() {
Toast.makeText(JavaActivity.this, "没有新版本", Toast.LENGTH_SHORT).show();
}
});
2，自定义接口协议+自定义对话框+显示下载进度对话框
其他代码和上面一样，只需重写UpdateCallback 的 hasNewApp方法，然后调用自己的对话框
/**
* 有新版本
*
* @param updateApp 新版本信息
* @param updateAppManager app更新管理器
*/
@Override
public void hasNewApp(UpdateAppBean updateApp, UpdateAppManager updateAppManager) {
//自定义对话框
showDiyDialog(updateApp, updateAppManager);
}
下面是简单的对话框，新版本信息从 updateApp 对象获取，updateAppManager 可以控制后台开始下载，也可以监听下载进度。
/**
* 自定义对话框
*
* @param updateApp
* @param updateAppManager
*/
private void showDiyDialog(final UpdateAppBean updateApp, final UpdateAppManager updateAppManager) {
String targetSize = updateApp.getTargetSize();
String updateLog = updateApp.getUpdateLog();
String msg = "";
if (!TextUtils.isEmpty(targetSize)) {
msg = "新版本大小：" + targetSize + "\n\n";
}
if (!TextUtils.isEmpty(updateLog)) {
msg += updateLog;
}
new AlertDialog.Builder(this)
.setTitle(String.format("是否升级到%s版本？", updateApp.getNewVersion()))
.setMessage(msg)
.setPositiveButton("升级", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
//显示下载进度
if (isShowDownloadProgress) {
updateAppManager.download(new DownloadService.DownloadCallback() {
@Override
public void onStart() {
HProgressDialogUtils.showHorizontalProgressDialog(JavaActivity.this, "下载进度", false);
}
/**
* 进度
* @param progress 进度 0.00 -1.00 ，总大小
* @param totalSize 总大小 单位B
*/
@Override
public void onProgress(float progress, long totalSize) {
HProgressDialogUtils.setProgress(Math.round(progress * 100));
}
/**
*
* @param total 总大小 单位B
*/
@Override
public void setMax(long total) {
}
@Override
public void onFinish() {
HProgressDialogUtils.cancel();
}
@Override
public void onError(String msg) {
Toast.makeText(JavaActivity.this, msg, Toast.LENGTH_SHORT).show();
HProgressDialogUtils.cancel();
}
});
} else {
//不显示下载进度
updateAppManager.download();
}
dialog.dismiss();
}
})
.setNegativeButton("暂不升级", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
dialog.dismiss();
}
})
.create()
.show();
}例如：https://raw.githubusercontent.com/WVector/AppUpdateDemo/master/json/json.txt?appKey=ab55ce55Ac4bcP408cPb8c1Aaeac179c5f6f&version=0.1.0
1,appkey app的唯一标志
appkey可以在manifest文件中配置，也可以在代码中添加
xml配置如下：
<meta-data
android:name="UPDATE_APP_KEY"
android:value="ab55ce55Ac4bcP408cPb8c1Aaeac179c5f6f"/>
2,version 版本号，工具自动添加(服务器判断客户端传过来的version和服务器存的最新的version，决定是否更新)
3, 服务器app后台管理界面
1,有新版本
{
"update": "Yes",//有新版本
"new_version": "0.8.3",//新版本号
"apk_file_url": "https://raw.githubusercontent.com/WVector/AppUpdateDemo/master/apk/app-debug.apk", //apk下载地址
"update_log": "1，添加删除信用卡接口\r\n2，添加vip认证\r\n3，区分自定义消费，一个小时不限制。\r\n4，添加放弃任务接口，小时内不生成。\r\n5，消费任务手动生成。",//更新内容
"target_size": "5M",//apk大小
"new_md5":"A818AD325EACC199BC62C552A32C35F2",
"constraint": false//是否强制更新
}
2,没有新版本
{
"update": "No",//没有新版本
}
class UpdateAppHttpUtil implements HttpManager {
/**
* 异步get
*
* @param url get请求地址
* @param params get参数
* @param callBack 回调
*/
@Override
public void asyncGet(@NonNull String url, @NonNull Map<String, String> params, @NonNull final Callback callBack) {
OkHttpUtils.get()
.url(url)
.params(params)
.build()
.execute(new StringCallback() {
@Override
public void onError(Call call, Response response, Exception e, int id) {
callBack.onError(validateError(e, response));
}
@Override
public void onResponse(String response, int id) {
callBack.onResponse(response);
}
});
}
/**
* 异步post
*
* @param url post请求地址
* @param params post请求参数
* @param callBack 回调
*/
@Override
public void asyncPost(@NonNull String url, @NonNull Map<String, String> params, @NonNull final Callback callBack) {
OkHttpUtils.post()
.url(url)
.params(params)
.build()
.execute(new StringCallback() {
@Override
public void onError(Call call, Response response, Exception e, int id) {
callBack.onError(validateError(e, response));
}
@Override
public void onResponse(String response, int id) {
callBack.onResponse(response);
}
});
}
/**
* 下载
*
* @param url 下载地址
* @param path 文件保存路径
* @param fileName 文件名称
* @param callback 回调
*/
@Override
public void download(@NonNull String url, @NonNull String path, @NonNull String fileName, @NonNull final FileCallback callback) {
OkHttpUtils.get()
.url(url)
.build()
.execute(new FileCallBack(path, fileName) {
@Override
public void inProgress(float progress, long total, int id) {
super.inProgress(progress, total, id);
callback.onProgress(progress, total);
}
@Override
public void onError(Call call, Response response, Exception e, int id) {
callback.onError(validateError(e, response));
}
@Override
public void onResponse(File response, int id) {
callback.onResponse(response);
}
@Override
public void onBefore(Request request, int id) {
super.onBefore(request, id);
callback.onBefore();
}
});
}
} //最简方式
new UpdateAppManager
.Builder()
//当前Activity
.setActivity(this)
//更新地址
.setUpdateUrl(mUpdateUrl)
//实现httpManager接口的对象
.setHttpManager(new UpdateAppHttpUtil())
.build()
.update();
/**
* 静默下载，下载完才弹出升级界面
*
* @param view
*/
public void silenceUpdateApp(View view) {
new UpdateAppManager
.Builder()
//当前Activity
.setActivity(this)
//更新地址
.setUpdateUrl(mUpdateUrl)
//实现httpManager接口的对象
.setHttpManager(new UpdateAppHttpUtil())
//只有wifi下进行，静默下载(只对静默下载有效)
.setOnlyWifi()
.build()
.silenceUpdate();
}
/**
* 静默下载，并且自定义对话框
*
* @param view
*/
public void silenceUpdateAppAndDiyDialog(View view) {
new UpdateAppManager
.Builder()
//当前Activity
.setActivity(this)
//更新地址
.setUpdateUrl(mUpdateUrl)
//实现httpManager接口的对象
.setHttpManager(new UpdateAppHttpUtil())
//只有wifi下进行，静默下载(只对静默下载有效)
.setOnlyWifi()
.build()
.checkNewApp(new SilenceUpdateCallback() {
@Override
protected void showDialog(UpdateAppBean updateApp, UpdateAppManager updateAppManager, File appFile) {
showSilenceDiyDialog(updateApp, appFile);
}
});
}
/**
* 静默下载自定义对话框
*
* @param updateApp
* @param appFile
*/
private void showSilenceDiyDialog(final UpdateAppBean updateApp, final File appFile) {
String targetSize = updateApp.getTargetSize();
String updateLog = updateApp.getUpdateLog();
String msg = "";
if (!TextUtils.isEmpty(targetSize)) {
msg = "新版本大小：" + targetSize + "\n\n";
}
if (!TextUtils.isEmpty(updateLog)) {
msg += updateLog;
}
new AlertDialog.Builder(this)
.setTitle(String.format("是否升级到%s版本？", updateApp.getNewVersion()))
.setMessage(msg)
.setPositiveButton("安装", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
AppUpdateUtils.installApp(JavaActivity.this, appFile);
dialog.dismiss();
}
})
.setNegativeButton("暂不升级", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
dialog.dismiss();
}
})
.create()
.show();
}
进度条使用的是代码家的「NumberProgressBar」
V3.3.0
1，可以设置不显示通知栏进度条。 2，可以设置忽略版本。 3，优化下载时页面卡的问题（由于下载进度回调调用频繁，造成ui线程阻塞。） 4，可以静默下载，类似网易云音乐，并且设置wifi状态下
V3.2.9
1，新增自定义对话框。 2，适配kotlin，写法更简单。
Copyright 2017 千匍
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent