You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
225 lines
8.8 KiB
225 lines
8.8 KiB
# AppUpdater
|
|
|
|
|
|
|
|
[](https://raw.githubusercontent.com/jenly1314/AppUpdater/master/app/release/app-release.apk)
|
|
[](https://repo1.maven.org/maven2/com/github/jenly1314/AppUpdater)
|
|
[](https://bintray.com/beta/#/jenly/maven/app-updater)
|
|
[](https://jitpack.io/#jenly1314/AppUpdater)
|
|
[](https://travis-ci.org/jenly1314/AppUpdater)
|
|
[](https://circleci.com/gh/jenly1314/AppUpdater)
|
|
[](https://android-arsenal.com/api?level=15)
|
|
[](https://opensource.org/licenses/mit-license.php)
|
|
[](https://jenly1314.github.io/)
|
|
[](http://shang.qq.com/wpa/qunwpa?idkey=8fcc6a2f88552ea44b1411582c94fd124f7bb3ec227e2a400dbbfaad3dc2f5ad)
|
|
|
|
AppUpdater for Android 是一个专注于App更新，一键傻瓜式集成App版本升级的轻量开源库。(无需担心通知栏适配；无需担心重复点击下载；无需担心App安装等问题；这些AppUpdater都已帮您处理好。)
|
|
核心库主要包括app-updater和app-dialog。
|
|
> 下载更新和弹框提示分开，是因为这本来就是两个逻辑。完全独立开来能有效的解耦。
|
|
* app-updater 主要负责后台下载更新App，无需担心下载时各种配置相关的细节，一键傻瓜式升级。
|
|
* app-dialog 主要是提供常用的Dialog和DialogFragment，简化弹框提示，布局样式支持自定义。
|
|
> app-updater + app-dialog 配合使用，谁用谁知道。
|
|
|
|
|
|
## 功能介绍
|
|
- [x] 专注于App更新一键傻瓜式升级
|
|
- [x] 够轻量，体积小
|
|
- [x] 支持监听下载过程
|
|
- [x] 支持下载失败，重新下载
|
|
- [x] 支持下载优先取本地缓存
|
|
- [x] 支持通知栏提示内容和过程全部可配置
|
|
- [x] 支持取消下载
|
|
- [x] 支持使用OkHttpClient下载
|
|
- [x] 支持Android 10(Q)
|
|
- [x] 支持Android 11(R)
|
|
- [x] 支持Android 12(S)
|
|
|
|
## Gif 展示
|
|
|
|
|
|
> 你也可以直接下载 [演示App](https://raw.githubusercontent.com/jenly1314/AppUpdater/master/app/release/app-release.apk) 体验效果
|
|
|
|
## 引入
|
|
|
|
### Gradle:
|
|
|
|
1. 在Project的 **build.gradle** 里面添加远程仓库
|
|
|
|
```gradle
|
|
allprojects {
|
|
repositories {
|
|
//...
|
|
mavenCentral()
|
|
}
|
|
}
|
|
```
|
|
|
|
2. 在Module的 **build.gradle** 里面添加引入依赖项
|
|
|
|
```gradle
|
|
|
|
//----------AndroidX 版本
|
|
//app-updater
|
|
implementation 'com.github.jenly1314.AppUpdater:app-updater:1.1.3'
|
|
//app-dialog
|
|
implementation 'com.github.jenly1314.AppUpdater:app-dialog:1.1.3'
|
|
|
|
```
|
|
|
|
|
|
以前发布至JCenter的版本
|
|
|
|
```gradle
|
|
|
|
//----------AndroidX 版本
|
|
//app-updater
|
|
implementation 'com.king.app:app-updater:1.0.10-androidx'
|
|
//app-dialog
|
|
implementation 'com.king.app:app-dialog:1.0.10-androidx'
|
|
|
|
//----------Android Support 版本
|
|
//app-updater
|
|
implementation 'com.king.app:app-updater:1.0.10'
|
|
//app-dialog
|
|
implementation 'com.king.app:app-dialog:1.0.10'
|
|
```
|
|
|
|
## 示例
|
|
|
|
```Java
|
|
//一句代码，傻瓜式更新
|
|
new AppUpdater(getContext(),url).start();
|
|
```
|
|
```Java
|
|
//简单弹框升级
|
|
AppDialogConfig config = new AppDialogConfig(context);
|
|
config.setTitle("简单弹框升级")
|
|
.setConfirm("升级") //旧版本使用setOk
|
|
.setContent("1、新增某某功能、\n2、修改某某问题、\n3、优化某某BUG、")
|
|
.setOnClickConfirm(new View.OnClickListener() { //旧版本使用setOnClickOk
|
|
@Override
|
|
public void onClick(View v) {
|
|
new AppUpdater.Builder()
|
|
.setUrl(mUrl)
|
|
.build(getContext())
|
|
.start();
|
|
AppDialog.INSTANCE.dismissDialog();
|
|
}
|
|
});
|
|
AppDialog.INSTANCE.showDialog(getContext(),config);
|
|
```
|
|
```Java
|
|
//简单DialogFragment升级
|
|
AppDialogConfig config = new AppDialogConfig(context);
|
|
config.setTitle("简单DialogFragment升级")
|
|
.setConfirm("升级") //旧版本使用setOk
|
|
.setContent("1、新增某某功能、\n2、修改某某问题、\n3、优化某某BUG、")
|
|
.setOnClickConfirm(new View.OnClickListener() { //旧版本使用setOnClickOk
|
|
@Override
|
|
public void onClick(View v) {
|
|
new AppUpdater.Builder()
|
|
.setUrl(mUrl)
|
|
.setFilename("AppUpdater.apk")
|
|
.build(getContext())
|
|
.setHttpManager(OkHttpManager.getInstance())//不设置HttpManager时，默认使用HttpsURLConnection下载，如果使用OkHttpClient实现下载，需依赖okhttp库
|
|
.start();
|
|
AppDialog.INSTANCE.dismissDialogFragment(getSupportFragmentManager());
|
|
}
|
|
});
|
|
AppDialog.INSTANCE.showDialogFragment(getSupportFragmentManager(),config);
|
|
|
|
```
|
|
|
|
更多使用详情，请查看[app](app)中的源码使用示例或直接查看[API帮助文档](https://javadoc.jitpack.io/com/github/jenly1314/AppUpdater/1.1.0/javadoc/index.html)
|
|
|
|
## 混淆
|
|
|
|
**app-updater** [Proguard rules](app-updater/proguard-rules.pro)
|
|
|
|
**app-dialog** [Proguard rules](app-dialog/proguard-rules.pro)
|
|
|
|
## 版本记录
|
|
|
|
#### v1.1.3：2022-04-25
|
|
* 统一日志管理
|
|
* 适配Android 12(S)
|
|
* 优化细节
|
|
|
|
#### v1.1.2：2021-11-18
|
|
* AppDialog对外提供更多与WindowManager.LayoutParams相关的配置
|
|
|
|
#### v1.1.1：2021-9-14
|
|
* 对外提供更多可配置参数
|
|
* 优化细节
|
|
|
|
#### v1.1.0：2021-7-2 (从v1.1.0开始不再发布至JCenter)
|
|
* 后续版本只支持androidx，版本名称不再带有androidx标识
|
|
* 优化细节
|
|
|
|
#### v1.0.10：2021-3-4
|
|
* AppDialogConfig添加构造参数，简化自定义扩展用法
|
|
* 优化细节
|
|
|
|
#### v1.0.9：2020-12-11
|
|
* 优化默认Dialog样式的显示细节
|
|
|
|
#### v1.0.8：2020-1-2
|
|
* 支持MD5校验
|
|
* 对外提供获取Dialog方法
|
|
|
|
#### v1.0.7：2019-12-18
|
|
* 优化细节
|
|
|
|
#### v1.0.6：2019-11-27
|
|
* 新增OkHttpManager 如果使用了OkHttpManager则必须依赖[okhttp](https://github.com/square/okhttp)
|
|
* 优化细节 (progress,total 变更 int -> long)
|
|
|
|
#### v1.0.5：2019-9-4
|
|
* 支持取消下载
|
|
|
|
#### v1.0.4：2019-6-4 [开始支持AndroidX版本](https://github.com/jenly1314/AppUpdater/tree/androidx)
|
|
* 支持添加请求头
|
|
|
|
#### v1.0.3：2019-5-9
|
|
* 新增支持下载APK优先取本地缓存，避免多次下载相同版本的APK文件
|
|
* AppDialog支持隐藏Dialog的标题
|
|
|
|
#### v1.0.2：2019-3-18
|
|
* 新增通知栏是否震动和铃声提示配置
|
|
* AppDialogConfig新增getView(Context context)方法
|
|
|
|
#### v1.0.1：2019-1-10
|
|
* 升级Gradle到4.6
|
|
|
|
#### v1.0 ：2018-6-29
|
|
* AppUpdater初始版本
|
|
|
|
## 赞赏
|
|
如果您喜欢AppUpdater，或感觉AppUpdater帮助到了您，可以点右上角“Star”支持一下，您的支持就是我的动力，谢谢 :smiley:<p>
|
|
您也可以扫描下面的二维码，请作者喝杯咖啡 :coffee:
|
|
<div>
|
|
<img src="https://jenly1314.github.io/image/pay/wxpay.png" width="280" heght="350">
|
|
<img src="https://jenly1314.github.io/image/pay/alipay.png" width="280" heght="350">
|
|
<img src="https://jenly1314.github.io/image/pay/qqpay.png" width="280" heght="350">
|
|
<img src="https://jenly1314.github.io/image/alipay_red_envelopes.jpg" width="233" heght="350">
|
|
</div>
|
|
|
|
## 关于我
|
|
Name: <a title="关于作者" href="https://about.me/jenly1314" target="_blank">Jenly</a>
|
|
|
|
Email: <a title="欢迎邮件与我交流" href="mailto:jenly1314@gmail.com" target="_blank">jenly1314#gmail.com</a> / <a title="给我发邮件" href="mailto:jenly1314@vip.qq.com" target="_blank">jenly1314#vip.qq.com</a>
|
|
|
|
CSDN: <a title="CSDN博客" href="http://blog.csdn.net/jenly121" target="_blank">jenly121</a>
|
|
|
|
CNBlogs: <a title="博客园" href="https://www.cnblogs.com/jenly" target="_blank">jenly</a>
|
|
|
|
GitHub: <a title="GitHub开源项目" href="https://github.com/jenly1314" target="_blank">jenly1314</a>
|
|
|
|
Gitee: <a title="Gitee开源项目" href="https://gitee.com/jenly1314" target="_blank">jenly1314</a>
|
|
|
|
加入QQ群: <a title="点击加入QQ群" href="http://shang.qq.com/wpa/qunwpa?idkey=8fcc6a2f88552ea44b1411582c94fd124f7bb3ec227e2a400dbbfaad3dc2f5ad" target="_blank">20867961</a>
|
|
<div>
|
|
<img src="https://jenly1314.github.io/image/jenly666.png">
|
|
<img src="https://jenly1314.github.io/image/qqgourp.png">
|
|
</div>
|
|
|
|
|