KongzueUpdateSDK

Kongzue APP更新工具

引入KongzueUpdateSDK到您的项目

引入方法：

implementation 'com.kongzue.kongzueupdatesdk:kongzueupdatesdk:1.4.1'

说明

1. 本工具无需权限，但在 targetSdkVersion >= 26 的情况时可能出现安装程序闪退但不报错的问题，系 Android 8.0 的新规定，请在您的应用中添加如下权限即可：

<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>

2. 本工具提供下载、安装步骤，因网络请求框架不确定，本工具不包含到您服务器的检查更新的网络请求，请在获取到相应的更新信息请您自行完成。
3. 本工具需要您提供的参数对照表如下：

字段	含义	是否必须
info	更新日志	可选
ver	版本号	可选
downloadUrl	下载地址	必须
me(Context)	上下文索引	必须
packageName	包名	必须
onDownloadListener	下载监听器	可选

需要的权限：

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET"/>

准备

1. 修改 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>

2. 使用前请先创建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");

下载并安装

1. 使用如下语句创建下载工具： me(Context) 传入上下文索引，一般使用本 Activity 即可 packageName 可直接使用 BuildConfig.APPLICATION_ID 获取：

UpdateUtil updateUtil = new UpdateUtil(MainActivity.this, BuildConfig.APPLICATION_ID);

2. 开始下载：

updateUtil.doUpdate(updateInfo);

下载完成后会自动调用安装。

3. 关于下载的监听 您可以通过以下代码监听下载过程：

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() + "）",
                "从商店下载",
                "直接下载",
                "取消");

额外的小工具：

UpdateUtil.isWifi()                         //判断Wifi状态
UpdateUtil.isShowProgressDialog = true;     //是否开启进度对话框（默认开启）

更新日志：

1.4.1：

• 修复 onDownloadListener.onSuccess 不执行的问题；

1.4.0：

• 修复进度显示可能存在问题的bug；

1.3.0：

• 修复安卓8.0设备上安装崩溃的问题；

开源协议

Copyright KongzueUpdateSDK

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.