描述
效果图
1.jpg
2.jpg
3.jpg
4.jpg
5.jpg
6.jpg
功能介绍
- 支持AndroidX
- 支持后台下载
- 支持强制更新
- 支持自定义下载过程
- 支持 设备 >= Android M 动态权限的申请
- 支持通知栏进度条展示(或者自定义显示进度)
- 支持Android N
- 支持Android O
- 支持Android P
- 支持Android Q
- 支持中/英文双语（国际化）
- 支持自定义内置对话框样式
- 支持取消下载(如果发送了通知栏消息，则会移除)
- 支持下载完成 打开新版本后删除旧安装包文件
- 使用HttpURLConnection下载，未集成其他第三方框架
Demo下载体验
DownloadManager：配置文档
初始化使用
DownloadManager.getInstance(this)
| 属性 | 描述 | 默认值 | 是否必须设置 |
|---|---|---|---|
| context | 上下文 | null | true |
| apkUrl | apk的下载地址 | null | true |
| apkName | apk下载好的名字 | null | true |
| downloadPath | apk下载的位置 (2.7.0以上版本已过时) | getExternalCacheDir() | false |
| showNewerToast | 是否提示用户 "当前已是最新版本" | false | false |
| smallIcon | 通知栏的图标(资源id) | -1 | true |
| configuration | 这个库的额外配置 | null | false |
| apkVersionCode | 更新apk的versionCode (如果设置了那么库中将会进行版本判断下面的属性也就需要设置了) | Integer.MIN_VALUE | false |
| apkVersionName | 更新apk的versionName | null | false |
| apkDescription | 更新描述 | null | false |
| apkSize | 新版本的安装包大小（单位M） | null | false |
| apkMD5 | 新安装包的md5（32位) | null | false |
UpdateConfiguration：配置文档
| 属性 | 描述 | 默认值 |
|---|---|---|
| notifyId | 通知栏消息id | 1011 |
| notificationChannel | 适配Android O的渠道通知 | 详情查阅源码 |
| httpManager | 设置自己的下载过程 | null |
| enableLog | 是否需要日志输出 | true |
| onDownloadListener | 下载过程的回调 | null |
| jumpInstallPage | 下载完成是否自动弹出安装页面 | true |
| showNotification | 是否显示通知栏进度（后台下载提示） | true |
| forcedUpgrade | 是否强制升级 | false |
| showBgdToast | 是否提示 "正在后台下载新版本…" | true |
| onButtonClickListener | 按钮点击事件回调 | null |
| dialogImage | 对话框背景图片资源(图片规范参考demo) | -1 |
| dialogButtonColor | 对话框按钮的颜色 | -1 |
| dialogButtonTextColor | 对话框按钮的文字颜色 | -1 |
| dialogProgressBarColor | 对话框进度条和文字颜色 | -1 |
使用步骤
第一步： app/build.gradle进行依赖
implementation 'com.azhon:appupdate:2.8.0'
- 如果你使用的是
AndroidX，请依赖appupdateX
implementation 'com.azhon:appupdateX:2.8.0'
第二步：兼容Android N 及以上版本，在app/build.gradle添加如下代码
defaultConfig {
//每个应用拥有不同的authorities，防止相同的在同一个手机上无法同时安装
resValue "string", "authorities", applicationId
}
第三步：创建DownloadManager，更多用法请查看这里示例代码
DownloadManager manager = DownloadManager.getInstance(this);
manager.setApkName("appupdate.apk")
.setApkUrl("https://raw.githubusercontent.com/azhon/AppUpdate/master/apk/appupdate.apk")
.setSmallIcon(R.mipmap.ic_launcher)
.download();
如果需要显示内置的对话框那么你需要调用manager.setApkVersionCode()将新版本的versionCode填进去
第四步：混淆打包，只需保持Activity、Service不混淆
-keep public class * extends android.app.Activity
-keep public class * extends android.app.Service
使用技巧
- 框架内部支持中/英文 国际化（其他语言只需要在对应的
string.xml中取相同的名字即可） - 查看版本库中的Log只需要过滤
AppUpdate开头的Tag - 支持校验安装包的MD5避免重复下载，只需要
DownloadManager设置安装包的MD5即可 - 下载完成 打开新版本后删除旧安装包文件，实现思路请移步此处
//旧版本apk的文件保存地址
boolean b = ApkUtil.deleteOldApk(this, getExternalCacheDir().getPath() + "/appupdate.apk");
- 温馨提示：升级对话框中的内容是可以上下滑动的哦！
- 如果需要实现自己一套下载过程，只需要继承
BaseHttpDownloadManager并使用listener更新进度
public class MyDownload extends BaseHttpDownloadManager {}
版本更新记录
- v2.8.0（2020/02/21）
- [修复] LogUtil偶现空指针问题
- [优化] FileProvider改为框架内置，用户无需手动配置
- [优化] apkVersionCode的判断
- 更多更新记录点此查看
下载源码
开源
项目地址: https://github.com/azhon/AppUpdate
项目分类: Android
授权协议 : Apache-2.0
网友评论