KongzueUpdateSDK
Kongzue APP更新工具
更新日志:
1.3.0:修复安卓8.0设备上安装崩溃的问题;
1.4.0:修复进度显示可能存在问题的bug;
说明
- 本工具无需本地存储读写权限,但使用前请务必保证 targetSdkVersion <= 25 ,经测试,部分机器在大于25的情况下无法正常弹出安装。
- 本工具提供下载、安装步骤,因网络请求框架不确定,本工具不包含到您服务器的检查更新的网络请求,请在获取到相应的更新信息请您自行完成。
- 本工具需要您提供的参数对照表如下:
字段 | 含义 | 是否必须 |
---|---|---|
info | 更新日志 | 可选 |
ver | 版本号 | 可选 |
downloadUrl | 下载地址 | 必须 |
me(Context) | 上下文索引 | 必须 |
packageName | 包名 | 必须 |
onDownloadListener | 下载监听器 | 可选 |
准备
- 修改 AndroidManifest.xml
因 Android 7.0规范限定,我们需要创建一个共享目录来存储下载的文件
请在 AndroidManifest.xml 中加入如下代码:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="您的包名">
<uses-permission android:name="android.permission.INTERNET"/>
<application
...>
...
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="您的包名.fileProvider"
android:grantUriPermissions="true"
android:exported="false">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_path"/>
</provider>
</application>
</manifest>
接下来在 res 目录下创建文件夹 xml,并添加文件 file_path.xml:
<resources xmlns:android="http://schemas.android.com/apk/res/android">
<paths>
<external-path path="" name="download"/>
</paths>
</resources>
- 使用前请先创建UpdateInfo,举例方法如下
updateInfo = new UpdateInfo()
.setInfo("1.上线了极力要求以至于无法再拒绝的收入功能\n" +
"2.出行的二级分类加入了地铁、地铁、地铁\n" +
"3.「关于」新增应用商店评分入口,你们知道怎么做\n" +
"4.「关于」还加入了GitHub地址,情怀+1s\n" +
"5.全新的底层适配框架,优化更多机型")
.setVer("v2.5")
.setDownloadUrl("http://paywhere.kongzue.com/downloads/paywhere.apk");
下载并安装
- 使用如下语句创建下载工具:
me(Context) 传入上下文索引,一般使用本 Activity 即可
packageName 可直接使用 BuildConfig.APPLICATION_ID 获取:
UpdateUtil updateUtil = new UpdateUtil(MainActivity.this, BuildConfig.APPLICATION_ID);
- 开始下载:
updateUtil.doUpdate(updateInfo);
下载完成后会自动调用安装。
- 关于下载的监听
您可以通过以下代码监听下载过程:
UpdateUtil updateUtil = new UpdateUtil(MainActivity.this, BuildConfig.APPLICATION_ID)
.setOnDownloadListener(new UpdateUtil.OnDownloadListener() {
@Override
public void onStart(long downloadId) {
Log.i("MainActivity", "onStart: 下载开始");
}
@Override
public void onDownloading(long downloadId, int progress) {
Log.i("MainActivity", "onStart: 下载中:"+progress);
}
@Override
public void onSuccess(long downloadId) {
Log.i("MainActivity", "onStart: 下载完成");
}
})
其他
可选的更新提示对话框
KongzueUpdateSDK 提供了一个可选使用的简易更新提示对话框,调用方法如下:
UpdateUtil updateUtil = new UpdateUtil(MainActivity.this, BuildConfig.APPLICATION_ID)
.showNormalUpdateDialog(updateInfo,
"检查到更新(" + updateInfo.getVer() + ")",
"从商店下载",
"直接下载",
"取消");
引入KongzueUpdateSDK到您的项目
引入方法:
implementation 'com.kongzue.kongzueupdatesdk:kongzueupdatesdk:1.4.0'
额外的小工具:
UpdateUtil.isWifi() //判断Wifi状态
UpdateUtil.isShowProgressDialog = true; //是否开启进度对话框(默认开启)
Github
地址:https://github.com/kongzue/KongzueUpdateSDK
欢迎Fork&Star
网友评论