XUpdate 一个轻量级、高可用性的Android版本更新框架

时间  2019-11-17
标签 xupdate 一个 轻量级 用性 android 版本 更新 框架 栏目 Android 繁體版
原文   原文链接

XUpdate
api
I
Star

一个轻量级、高可用性的Android版本更新框架。赶忙点击使用说明文档，体验一下吧！android

在提issue前，请先阅读【提问的智慧】，并严格按照issue模板进行填写，节约你们的时间。git

在使用前，请必定要仔细阅读使用说明文档,重要的事情说三遍！！！github

在使用前，请必定要仔细阅读使用说明文档,重要的事情说三遍！！！json

在使用前，请必定要仔细阅读使用说明文档,重要的事情说三遍！！！api

关于我

github
csdn
简书
掘金
知乎

X系列库快速集成

为了方便你们快速集成X系列框架库，我提供了一个空壳模版供你们参考使用: github.com/xuexiangjys…缓存

特色

  • 支持post和get两种版本检查方式，支持自定义网络请求。bash

  • 支持设置只在wifi下进行版本更新。服务器

  • 支持静默下载（后台更新）、自动版本更新。网络

  • 提供界面友好的版本更新提示弹窗，可自定义其主题样式。app

  • 支持自定义版本更新检查器、版本更新解析器、版本更新提示器、版本更新下载器、版本更新安装、出错处理。

  • 支持MD5文件校验、版本忽略、版本强制更新等功能。

  • 支持自定义文件校验方法【默认是MD5校验】。

  • 支持自定义请求API接口。

  • 兼容Android6.0、7.0、8.0和9.0。

  • 支持中文和英文两种语言显示（国际化）

组成结构

本框架借鉴了AppUpdate中的部分思想和UI界面，将版本更新中的各部分环节抽离出来，造成了以下几个部分：

  • 版本更新检查器IUpdateChecker：检查是否有最新版本。

  • 版本更新解析器IUpdateParser：解析服务端返回的数据结果。

  • 版本更新提示器IUpdatePrompter：展现最新的版本信息。

  • 版本更新下载器IUpdateDownloader：下载最新的版本APK安装包。

  • 网络请求服务接口IUpdateHttpService：定义了进行网络请求的相关接口。

除此以外，还有两个监听器：

  • 版本更新失败的监听器OnUpdateFailureListener。

  • 版本更新apk安装的监听器OnInstallListener。

一、演示（请star支持）

  • 默认版本更新

  • 强制版本更新

  • 自定义提示弹窗主题

  • 使用系统弹窗提示

Demo下载

downloads

二、如何使用

目前支持主流开发工具AndroidStudio的使用，直接配置build.gradle，增长依赖便可.

2.一、Android Studio导入方法，添加Gradle依赖

1.先在项目根目录的 build.gradle 的 repositories 添加:

allprojects {
     repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}
复制代码

2.而后在dependencies添加:

dependencies {
  ...
  implementation 'com.github.xuexiangjys:XUpdate:1.1.1'
}
复制代码

2.二、初始化XUpdate

在Application进行初始化配置：

XUpdate.get()
    .debug(true)
    .isWifiOnly(true)                                               //默认设置只在wifi下检查版本更新
    .isGet(true)                                                    //默认设置使用get请求检查版本
    .isAutoMode(false)                                              //默认设置非自动模式，可根据具体使用配置
    .param("versionCode", UpdateUtils.getVersionCode(this))         //设置默认公共请求参数
    .param("appKey", getPackageName())
    .setOnUpdateFailureListener(new OnUpdateFailureListener() {     //设置版本更新出错的监听
        @Override
        public void onFailure(UpdateError error) {
            if (error.getCode() != CHECK_NO_NEW_VERSION) {          //对不一样错误进行处理
                ToastUtils.toast(error.toString());
            }
        }
    })
    .supportSilentInstall(true)                                     //设置是否支持静默安装，默认是true
    .setIUpdateHttpService(new OKHttpUpdateHttpService())           //这个必须设置！实现网络请求功能。
    .init(this);                                                    //这个必须初始化
复制代码

【注意】：若是出现任何问题，可开启debug模式来追踪问题。若是你还须要将日志记录在磁盘上，可实现如下接口

XUpdate.get().setILogger(new ILogger() {
    @Override
    public void log(int priority, String tag, String message, Throwable t) {
        //实现日志记录功能
    }
});
复制代码

2.三、版本更新实体信息

(1) UpdateEntity字段属性

字段名 类型 默认值 备注
mHasUpdate boolean false 是否有新版本
mIsForce boolean false 是否强制安装：不安装没法使用app
mIsIgnorable boolean false 是否可忽略该版本
mVersionCode int 0 最新版本code
mVersionName String unknown_version 最新版本名称
mUpdateContent String "" 更新内容
mDownloadEntity DownloadEntity ／ 下载信息实体
mIsSilent boolean false 是否静默下载：有新版本时不提示直接下载
mIsAutoInstall boolean true 是否下载完成后自动安装

(2) DownloadEntity字段属性

字段名 类型 默认值 备注
mDownloadUrl String "" 下载地址
mCacheDir String "" 文件下载的目录
mMd5 String "" 下载文件的加密校验值(默认使用md5加密)，用于校验，防止下载的apk文件被替换（最新演示demo中有计算校验值的工具）
mSize long 0 下载文件的大小【单位：KB】
mIsShowNotification boolean false 是否在通知栏上显示下载进度

2.四、文件加密校验方式

本框架默认使用的文件加密校验方法是MD5加密方式，固然若是你不想使用MD5加密，你也能够自定义文件加密器IFileEncryptor,如下是MD5文件加密器的实现供参考：

/**
 * 默认的文件加密计算使用的是MD5加密
 *
 * @author xuexiang
 * @since 2019-09-06 14:21
 */
public class DefaultFileEncryptor implements IFileEncryptor {
    /**
     * 加密文件
     *
     * @param file
     * @return
     */
    @Override
    public String encryptFile(File file) {
        return Md5Utils.getFileMD5(file);
    }

    /**
     * 检验文件是否有效（加密是否一致）
     *
     * @param encrypt 加密值, 若是encrypt为空，直接认为是有效的
     * @param file    须要校验的文件
     * @return 文件是否有效
     */
    @Override
    public boolean isFileValid(String encrypt, File file) {
        return TextUtils.isEmpty(encrypt) || encrypt.equalsIgnoreCase(encryptFile(file));
    }
}

复制代码

最后再调用XUpdate.get().setIFileEncryptor方法设置便可生效。

三、版本更新

3.一、默认版本更新

直接调用以下代码便可完成版本更新操做：

XUpdate.newBuild(getActivity())
        .updateUrl(mUpdateUrl)
        .update();
复制代码

须要注意的是，使用默认版本更新，请求服务器返回的json格式应包括以下内容：

{
  "Code": 0,
  "Msg": "",
  "UpdateStatus": 1,
  "VersionCode": 3,
  "VersionName": "1.0.2",
  "ModifyContent": "一、优化api接口。\r\n二、添加使用demo演示。\r\n三、新增自定义更新服务API接口。\r\n四、优化更新提示界面。",
  "DownloadUrl": "https://raw.githubusercontent.com/xuexiangjys/XUpdate/master/apk/xupdate_demo_1.0.2.apk",
  "ApkSize": 2048
  "ApkMd5": "..."  //md5值没有的话，就没法保证apk是否完整，每次都会从新下载。
}
复制代码

3.二、自动版本更新

自动版本更新：自动检查版本 + 自动下载apk + 自动安装apk（静默安装）。 只须要设置isAutoMode(true),不过若是设备没有root权限的话，是没法作到彻底的自动更新（由于静默安装须要root权限）。

XUpdate.newBuild(getActivity())
        .updateUrl(mUpdateUrl)
        .isAutoMode(true) //若是须要彻底无人干预，自动更新，须要root权限【静默安装须要】
        .update();
复制代码

3.三、强制版本更新

就是用户不更新的话，程序将没法正常使用。只须要服务端返回UpdateStatus字段为2便可。

固然若是你自定义请求返回api的话，只须要设置UpdateEntity的mIsForce字段为true便可。

3.四、自定义版本更新提示弹窗的主题

可设置弹窗的标题背景和按钮颜色。

  • themeColor: 设置主题颜色（升级/安装按钮的背景色）
  • topResId: 弹窗的标题背景的资源图片
XUpdate.newBuild(getActivity())
        .updateUrl(mUpdateUrl)
        .themeColor(ResUtils.getColor(R.color.update_theme_color))
        .topResId(R.mipmap.bg_update_top)
        .update();
复制代码

3.五、自定义版本更新解析器

实现IUpdateParser接口便可实现解析器的自定义。

XUpdate.newBuild(getActivity())
        .updateUrl(mUpdateUrl3)
        .updateParser(new CustomUpdateParser()) //设置自定义的版本更新解析器
        .update();

public class CustomUpdateParser implements IUpdateParser {
    @Override
    public UpdateEntity parseJson(String json) throws Exception {
        CustomResult result = JsonUtil.fromJson(json, CustomResult.class);
        if (result != null) {
            return new UpdateEntity()
                    .setHasUpdate(result.hasUpdate)
                    .setIsIgnorable(result.isIgnorable)
                    .setVersionCode(result.versionCode)
                    .setVersionName(result.versionName)
                    .setUpdateContent(result.updateLog)
                    .setDownloadUrl(result.apkUrl)
                    .setSize(result.apkSize);
        }
        return null;
    }
}

复制代码

3.六、自定义版本更新检查器+版本更新解析器+版本更新提示器

  • 实现IUpdateChecker接口便可实现检查器的自定义。

  • 实现IUpdateParser接口便可实现解析器的自定义。

  • 实现IUpdatePrompter接口便可实现提示器的自定义。

XUpdate.newBuild(getActivity())
        .updateUrl(mUpdateUrl3)
        .updateChecker(new DefaultUpdateChecker() {
            @Override
            public void onBeforeCheck() {
                super.onBeforeCheck();
                CProgressDialogUtils.showProgressDialog(getActivity(), "查询中...");
            }
            @Override
            public void onAfterCheck() {
                super.onAfterCheck();
                CProgressDialogUtils.cancelProgressDialog(getActivity());
            }
        })
        .updateParser(new CustomUpdateParser())
        .updatePrompter(new CustomUpdatePrompter(getActivity()))
        .update();


public class CustomUpdatePrompter implements IUpdatePrompter {

    private Context mContext;

    public CustomUpdatePrompter(Context context) {
        mContext = context;
    }

    @Override
    public void showPrompt(@NonNull UpdateEntity updateEntity, @NonNull IUpdateProxy updateProxy) {
        showUpdatePrompt(updateEntity, updateProxy);
    }

    /**
     * 显示自定义提示
     *
     * @param updateEntity
     * @param updateProxy
     */
    private void showUpdatePrompt(final @NonNull UpdateEntity updateEntity, final @NonNull IUpdateProxy updateProxy) {
        String updateInfo = UpdateUtils.getDisplayUpdateInfo(updateEntity);

        new AlertDialog.Builder(mContext)
                .setTitle(String.format("是否升级到%s版本？", updateEntity.getVersionName()))
                .setMessage(updateInfo)
                .setPositiveButton("升级", new DialogInterface.OnClickListener() {
                    @Override
                    public void onClick(DialogInterface dialog, int which) {
                        updateProxy.startDownload(updateEntity, new OnFileDownloadListener() {
                            @Override
                            public void onStart() {
                                HProgressDialogUtils.showHorizontalProgressDialog(mContext, "下载进度", false);
                            }

                            @Override
                            public void onProgress(float progress, long total) {
                                HProgressDialogUtils.setProgress(Math.round(progress * 100));
                            }

                            @Override
                            public boolean onCompleted(File file) {
                                HProgressDialogUtils.cancel();
                                return true;
                            }

                            @Override
                            public void onError(Throwable throwable) {
                                HProgressDialogUtils.cancel();
                            }
                        });
                    }
                })
                .setNegativeButton("暂不升级", null)
                .setCancelable(false)
                .create()
                .show();
    }
复制代码

3.七、只使用XUpdate的下载器功能进行apk的下载

XUpdate.newBuild(getActivity())
        .apkCacheDir(PathUtils.getExtDownloadsPath()) //设置下载缓存的根目录
        .build()
        .download(mDownloadUrl, new OnFileDownloadListener() {   //设置下载的地址和下载的监听
            @Override
            public void onStart() {
                HProgressDialogUtils.showHorizontalProgressDialog(getContext(), "下载进度", false);
            }

            @Override
            public void onProgress(float progress, long total) {
                HProgressDialogUtils.setProgress(Math.round(progress * 100));
            }

            @Override
            public boolean onCompleted(File file) {
                HProgressDialogUtils.cancel();
                ToastUtils.toast("apk下载完毕，文件路径：" + file.getPath());
                return false;
            }

            @Override
            public void onError(Throwable throwable) {
                HProgressDialogUtils.cancel();
            }
        });
复制代码

3.八、只使用XUpdate的APK安装的功能

_XUpdate.startInstallApk(getContext(), FileUtils.getFileByPath(PathUtils.getFilePathByUri(getContext(), data.getData()))); //填写文件所在的路径
复制代码

若是你的apk安装不同凡响，你能够实现本身的apk安装器。你只须要实现OnInstallListener接口，并经过XUpdate.setOnInstallListener进行设置便可生效。

混淆配置

-keep class com.xuexiang.xupdate.entity.** { *; }
复制代码

特别感谢

github.com/WVector/App…

联系方式

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程