开发过程中，发现很多更新库定制样式比较费事(如自定义dialog功能不完善，更新dialog和下载dialog耦合高等)，且功能不是特别契合需求(如使用dialogfragment封装难修改圆角、样式较难定制)，为加快开发速度提升效率，空闲时间简单封装了一个应用更新库和dialog库，独立于okhttp和retrofit。
项目地址：https://github.com/ibshe/AppUpdateLib
或：https://gitee.com/zkzyjs/AppUpdateLib
功能：
轻量、易用、可定制的android更新和dialog库，xml自定义ui，默认ios极简风格，一行代码(不超过60字符)实现更新提示和下载安装。全静默更新，强制更新等，支持本地json和直接读取服务端json，一个builder定制化各种dialog，个性化toast。
效果图：
image
使用方式：
1、在你项目的根目录 build.gradle中加入如下配置：
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
2、主app的build.gradle中添加依赖：
support版本：
github方式：
dependencies {
implementation 'com.github.ibshe:AppUpdateLib:1.0.7'
}
androidX版本：
dependencies {
implementation 'com.github.ibshe:AppUpdateLibX:1.0.7'
}
3、用法：
- 一行代码检查更新、下载安装，mJsonUrl为服务器json文件(格式随意，如.txt、.json等)地址，只需放到能访问的web容器内即可
new UpdateWrapper.Builder(this,mJsonUrl).build().start();
服务端json格式(文件)
{
"versionCode":24,
"versionName":"1.7.8",
"content":"增加报表导出功能",
"minSupport":4,
"url":"http://103.45.138.168/apps/music_pj.apk",
"updateTitle":"发现新版本",
"mustUpdate":false,
"date":"2021-06-01 09:02:10"
}
以上使用默认的更新dialog和下载dialog样式，以及默认toast提示。也可自定义获取到服务端数据后解析成实体VersionModel传入，效果相同，实体优先级较json地址高。
new UpdateWrapper.Builder(this,null)
.model(mModel)//本地实体,优先级 > url
.build()
.start();
- 自定义更新dialog样式
class CustomDialog extends AbstractUpdateDialog {
public CustomDialog(Context context, final String title, final String negivteTx, final String positiveTx, int layoutId) {
super(context, title, negivteTx, positiveTx, layoutId, false, RadiusEnum.UPDATE_RADIUS_10, new DownlaodCallback() {
@Override
public void callback(int code, String message) {
Log.i(TAG,message);
}
});
this.customOnCreate(new BindingCallback() {
@Override
public void bindingVh(DialogViewHolder holder) {
View view = holder.getConvertView();
view.setBackgroundResource(ScreenUtils.getDrawableId(RadiusEnum.UPDATE_RADIUS_30.getType()));
titleTv = view.findViewById(R.id.title);
contentTv = view.findViewById(R.id.message);
negtive = view.findViewById(R.id.negtive);
positive = view.findViewById(R.id.positive);
titleTv.setText(title);
contentTv.setText(BaseConfig.UPDATE_CONTENT);
negtive.setText(negivteTx);
positive.setText(positiveTx);
negtive.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
cancel();
}
});
positive.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
start();
}
});
}
});
}
}
使用自定义更新dialog：
new UpdateWrapper.Builder(this,mJsonUrl)
.customDialog(new CustomDialog(this,"发现新版本","取消","升级",R.layout.custom_update_dialog))
.checkEveryday(false)
.radius(RadiusEnum.UPDATE_RADIUS_30)
.build()
.start();
3、静默下载(无notification，后台下载完成直接跳转安装)
new DownloadWrapper(this,mDownloadUrl,true,RadiusEnum.UPDATE_RADIUS_30).start();
4、强制更新
new UpdateWrapper.Builder(this,mJsonUrl)
.isMustUpdate(true)
.build()
.start();
5、设置下载dialog样式
new DownloadDialog.Builder(this,mDownloadUrl,false)
.downloadCallback(new DownlaodCallback() {
@Override
public void callback(int code, String message) {
}
})
.build()
.setDialogStyle(R.drawable.update_bg_dark)
.setCancelColor(R.color.orange)
.setConfirmColor(R.color.dark_tx)
.setTitleColor(R.color.dark_tx)
.setLineColor(R.color.lineGray)
.setProgressStyle(getResources().getDrawable(R.drawable.custom_progressbar_bg))
.start();
6、不弹或自定义更新dialog，下面方式调用直接下载
new DownloadWrapper(this,mDownloadUrl,false,RadiusEnum.UPDATE_RADIUS_10)
.start();
或者：
new DownloadDialog.Builder(this,mDownloadUrl,false)
.radius(RadiusEnum.UPDATE_RADIUS_10)
.build().start();
7、主要参数
new UpdateWrapper.Builder(this,mJsonUrl)
.title("测试更新")//更新dialog标题
.negtiveText("取消")//更新dialog取消按钮
.radius(RadiusEnum.UPDATE_RADIUS_10)//更新和下载dialog圆角弧度同时生效
.positiveText("立即升级")//更新dialog确定按钮
.checkEveryday(false)//默认false 立即下载,true 每天最多检查一次。如今日已检查，则不再检查
.showNetworkErrorToast(true)//无网络提示
.showNoUpdateToast(true)//无更新提示
.isPost(false)//检查更新请求协议是否为POST，默认GET
.isMustUpdate(false)//是否强制更新
.backgroundDownload(false)//是否后台下载
.model(null)//本地实体，不传默认为null，优先级大于mJsonUrl
.downloadCallback(new DownlaodCallback() {//下载状态回调
@Override
public void callback(int code, String message) {
//code 1、后台下载；2、取消下载；3、下载完成；4、下载失败；
//Code 1. Background download; 2. Cancel the download; 3. Download completed; 4. Download failed;
Log.i(TAG,message);
}
})
.updateCallback(new UpdateWrapper.UpdateCallback() {//获取远端信息回调
@Override
public void res(VersionModel model, boolean hasNewVersion) {
Log.i(TAG,model.toString());
}
})
.build()
.start();
8、当做dialog使用，自定义dialog样式，自定义toast都OK
new BsDialog(this, R.layout.custom_update_dialog) {
@Override
public void onBindViewHolder(DialogViewHolder holder) {
View view = holder.getConvertView();
titleTv = view.findViewById(com.boge.update.R.id.title);
contentTv = view.findViewById(com.boge.update.R.id.message);
negtive = view.findViewById(com.boge.update.R.id.negtive);
positive = view.findViewById(com.boge.update.R.id.positive);
titleTv.setText(TextUtils.isEmpty(mTitle)?(TextUtils.isEmpty(BaseConfig.UPDATE_TITLE)?mContext.getString(R.string.update_lib_dialog_title):BaseConfig.UPDATE_TITLE):mTitle);
contentTv.setText(BaseConfig.UPDATE_CONTENT);
negtive.setText(TextUtils.isEmpty(mNegivteTx)?(TextUtils.isEmpty(BaseConfig.UPDATE_NEGITIVE)?mContext.getString(R.string.update_no_thanks):BaseConfig.UPDATE_NEGITIVE):mNegivteTx);
positive.setText(TextUtils.isEmpty(mPositiveTx)?(TextUtils.isEmpty(BaseConfig.UPDATE_POSITIVE)?mContext.getString(R.string.update_sure):BaseConfig.UPDATE_POSITIVE):mPositiveTx);
if(mRadius.getType() != 10){
view.setBackgroundResource(ScreenUtils.getDrawableId(mRadius.getType()));
}
negtive.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
cancel();
}
});
positive.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
start();
}
});
}
}.backgroundLight(0.5)
.setCancelAble(true)
.setCanceledOnTouchOutside(true)
.showDialog();
9、代码混淆
-keep class com.boge.update.** {*;}
更多参数查看demo，欢迎提出问题或参与开源，ibshen@aliyun.com，如对你有帮助请star支持，谢谢
demo下载
或 apk看效果
网友评论