maven 强制更新_Android App内部更新Library的方法

超详细！安卓巴士开发者大会嘉宾及主题介绍

AutoUpdateProject

最新版本及说明请关注GitHub，欢迎Star。
有什么意见与建议欢迎交流！

github地址：
https://github.com/MZCretin/AutoUpdateProject

公告：移除了之前所有版本的文档说明，从现在起，版本的更新迭代从1.1.2开始进行，之前的老版本使用没有影响，只是不再提供集成说明。

特点概述

一、可从后台主动控制本地app强制更新，主要适用场合是某个版本有bug，会严重影响用户的使用，此时用这种模式，只要用户打开app，提醒强制更新，否则不能进入app；二、根据后台返回受影响的版本号，可控制多个版本同时被强制更新；三、后台返回最新安装包大小，本地判断安装包是否下载，防止多次下载；四、内部处理，忽略此版本更新提示五、library采用无第三方工具类，下载使用HttpURLConnextion，本地存储使用SharedPrefference，以免使用此library带来第三方插件冲突六、library适配Android 7.0七、library默认请求方式为POST请求，对于GET请求无法正常请求，提供配置请求方式八、library添加了对log日志的开关，在调试阶段可打开调试log输出，提交生产环境的时候可以主动的关闭九、library支持判断网络环境，移动数据下智能提示，防止流量外漏。十、考虑到减少与后台人员的配合的高度耦合，增加了自定义model的入口，具体使用请关注使用方式。十一、提供两种模式的版本更新，一种是对话框显示下载进度，一种是通知栏显示后台默默下载形式

使用方式：

第一步、在项目目录下的build.gradle文件下的repositories节点下添加如下代码

allprojects { repositories { ... maven { url 'https://jitpack.io' } } }

第二步、在项目app目录下的build.gradle文件下的dependencies节点下添加 { compile 'com.github.MZCretin:AutoUpdateProject:v1.0' }

第三步、在BaseApplication或者是MainActivity的onCreate()方法中进行初始化(我们推荐在BaseApplication进行初始化，另外不要忘记在AndroidManifest.xml中注册BaseApplication)，你有两种初始化的方式，一种是自定义一些参数，另外一种是直接使用默认参数。如下所示：

//第一种形式 自定义参数 CretinAutoUpdateUtils.Builder builder =         new CretinAutoUpdateUtils.Builder()         //设置更新api         .setBaseUrl("http://120.24.5.102/weixin/app/getversion")         //设置是否显示忽略此版本         .setIgnoreThisVersion(true)         //设置下载显示形式 对话框或者通知栏显示 二选一         .setShowType(CretinAutoUpdateUtils.Builder.TYPE_DIALOG)         //设置下载时展示的图标         .setIconRes(R.mipmap.ic_launcher)         //设置下载时展示的应用吗         .setAppName("测试应用")                 //设置请求方式                .setRequestMethod(CretinAutoUpdateUtils.Builder.METHOD_GET)                //设置自定义的Model类                .setTransition(new UpdateModel())                //设置是否打印log日志                .showLog(true)        .build(); CretinAutoUpdateUtils.init(builder); 

//第二种模式 使用默认值CretinAutoUpdateUtils.init("http://120.24.5.102/weixin/app/getversion");

第四步、在AndroidManifest.xml的application节点下添加如下代码：

<applicationandroid:name=".BaseApp"android:allowBackup="true"android:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:supportsRtl="true"android:theme="@style/AppTheme">        <activity android:name=".MainActivity">            <intent-filter>                <action android:name="android.intent.action.MAIN"/>

                <category android:name="android.intent.category.LAUNCHER"/>            intent-filter>        activity>

        <service android:name="com.cretin.www.cretinautoupdatelibrary.utils.DownloadService"/>    application>

第五步、适配Android7.0

在app module 的 res下建立一个xml文件夹，新建一个install_file.xml，在该文件内填写以下内容：

<?xml  version="1.0" encoding="utf-8"?>    <paths>        <external-path path="Android/data/$(applicationId)/"  name="files_root" />        <external-path path="." name="cretin_install" />    paths>

在AndroidManifest.xml文件的application标签内填下以下内容

 <providerandroid:name="android.support.v4.content.FileProvider"android:authorities="${applicationId}.fileprovider"android:grantUriPermissions="true"android:exported="false"                >                <meta-dataandroid:name="android.support.FILE_PROVIDER_PATHS"android:resource="@xml/install_file" />            provider>

第六步、必须返回字段的说明

此library的使用需要与后台联动配合，下面是后台需要返回给我们使用的字段说明：

/** * Created by cretin on 2017/3/8. */

public class UpdateEntity {    public int versionCode = 0;    //是否强制更新 0 不强制更新 1 hasAffectCodes拥有字段强制更新 2 所有版本强制更新    public int isForceUpdate = 0;    //上一个版本版本号    public int preBaselineCode = 0;    //版本号 描述作用    public String versionName = "";    //新安装包的下载地址    public String downurl = "";    //更新日志    public String updateLog = "";    //安装包大小 单位字节    public String size = "";    //受影响的版本号 如果开启强制更新 那么这个字段包含的所有版本都会被强制更新 格式 2|3|4    public String hasAffectCodes = "";}

所以需要后台返回给我们这些字段，这些字段都是必须的，相关说明请看注释，下面是一个参考

{    "versionCode": "18",     "isForceUpdate": "1",     "preBaselineCode": "0",     "versionName": "2.1.1",     "downurl": "http://120.24.5.102/Webconfig/frj01_211_jiagu_sign.apk",     "hasAffectCodes": "11|12|13|14|15|16|17",     "updateLog": "1、修复bug            2、完善部分功能点            3、系统升级，强制更新            ",     "size": 10291218}

情况一：使用默认的model类

sdk默认的model类为UpdateEntity.java，具体如下，你需要保证你们后台返回的json数据可以解析成如下的model类，否则会报无法解析的错误。

/** * Created by cretin on 2017/3/8. */

public class UpdateEntity implements LibraryUpdateEntity{    public int versionCode = 0;    //是否强制更新 0 不强制更新 1 hasAffectCodes拥有字段强制更新 2 所有版本强制更新    public int isForceUpdate = 0;    //上一个版本版本号    public int preBaselineCode = 0;    //版本号 描述作用    public String versionName = "";    //新安装包的下载地址    public String downurl = "";    //更新日志    public String updateLog = "";    //安装包大小 单位字节    public String size = "";    //受影响的版本号 如果开启强制更新 那么这个字段包含的所有版本都会被强制更新 格式 2|3|4    public String hasAffectCodes = "";

    public int getVersionCode() {        return versionCode;    }

    public void setVersionCode(int versionCode) {        this.versionCode = versionCode;    }

    public int getIsForceUpdate() {        return isForceUpdate;    }

    public void setIsForceUpdate(int isForceUpdate) {        this.isForceUpdate = isForceUpdate;    }

    public int getPreBaselineCode() {        return preBaselineCode;    }

    public void setPreBaselineCode(int preBaselineCode) {        this.preBaselineCode = preBaselineCode;    }

    public String getVersionName() {        return versionName;    }

    public void setVersionName(String versionName) {        this.versionName = versionName;    }

    public String getDownurl() {        return downurl;    }

    public void setDownurl(String downurl) {        this.downurl = downurl;    }

    public String getUpdateLog() {        return updateLog;    }

    public void setUpdateLog(String updateLog) {        this.updateLog = updateLog;    }

    public String getSize() {        return size;    }

    public void setSize(String size) {        this.size = size;    }

    public String getHasAffectCodes() {        return hasAffectCodes;    }

    public void setHasAffectCodes(String hasAffectCodes) {        this.hasAffectCodes = hasAffectCodes;    }

    @Override    public int getVersionCodes() {        return getVersionCode();    }

    @Override    public int getIsForceUpdates() {        return getIsForceUpdate();    }

    @Override    public int getPreBaselineCodes() {        return getPreBaselineCode();    }

    @Override    public String getVersionNames() {        return getVersionName();    }

    @Override    public String getDownurls() {        return getDownurl();    }

    @Override    public String getUpdateLogs() {        return getUpdateLog();    }

    @Override    public String getApkSizes() {        return getSize();    }

    @Override    public String getHasAffectCodess() {        return getHasAffectCodes();    }}

情况二：使用自定义的model类

首先，在初始化sdk的时候采用自定义参数的方式，使用 new CretinAutoUpdateUtils.Builder().setTransition(new UpdateModel())方式传入你自定义的model类，请注意，自定义的UpdateModel类必须实现sdk的LibraryUpdateEntity接口，并实现该接口所必须实现的方法，在这些方法中返回给sdk必须的字段，这样sdk才能成功的获取相对应的信息。下面是一个具体的实现：

import com.cretin.www.cretinautoupdatelibrary.model.LibraryUpdateEntity;

/** * Created by cretin on 2017/4/21. */

public class UpdateModel implements LibraryUpdateEntity{

    /**     * id : test     * page : 1     * rows : 10     * isForceUpdate : 0     * preBaselineCode : 0     * versionName : V1.0.1     * versionCode : 3     * downurl : http://120.24.5.102/Webconfig/frj01_211_jiagu_sign.apk     * updateLog : 1、修复bug     * size : 10291218     * hasAffectCodes : 1|2     * createTime : 1489651956000     * iosVersion : 1     */

    private String id;    private int page;    private int rows;    private int isForceUpdate;    private int preBaselineCode;    private String versionName;    private int versionCode;    private String downurl;    private String updateLog;    private String size;    private String hasAffectCodes;    private long createTime;    private int iosVersion;

    public String getId() {        return id;    }

    public void setId(String id) {        this.id = id;    }

    public int getPage() {        return page;    }

    public void setPage(int page) {        this.page = page;    }

    public int getRows() {        return rows;    }

    public void setRows(int rows) {        this.rows = rows;    }

    public int getIsForceUpdate() {        return isForceUpdate;    }

    public void setIsForceUpdate(int isForceUpdate) {        this.isForceUpdate = isForceUpdate;    }

    public int getPreBaselineCode() {        return preBaselineCode;    }

    public void setPreBaselineCode(int preBaselineCode) {        this.preBaselineCode = preBaselineCode;    }

    public String getVersionName() {        return versionName;    }

    public void setVersionName(String versionName) {        this.versionName = versionName;    }

    public int getVersionCode() {        return versionCode;    }

    public void setVersionCode(int versionCode) {        this.versionCode = versionCode;    }

    public String getDownurl() {        return downurl;    }

    public void setDownurl(String downurl) {        this.downurl = downurl;    }

    public String getUpdateLog() {        return updateLog;    }

    public void setUpdateLog(String updateLog) {        this.updateLog = updateLog;    }

    public String getSize() {        return size;    }

    public void setSize(String size) {        this.size = size;    }

    public String getHasAffectCodes() {        return hasAffectCodes;    }

    public void setHasAffectCodes(String hasAffectCodes) {        this.hasAffectCodes = hasAffectCodes;    }

    public long getCreateTime() {        return createTime;    }

    public void setCreateTime(long createTime) {        this.createTime = createTime;    }

    public int getIosVersion() {        return iosVersion;    }

    public void setIosVersion(int iosVersion) {        this.iosVersion = iosVersion;    }

    @Override    public int getVersionCodes() {        return getVersionCode();    }

    @Override    public int getIsForceUpdates() {        return getIsForceUpdate();    }

    @Override    public int getPreBaselineCodes() {        return getPreBaselineCode();    }

    @Override    public String getVersionNames() {        return getVersionName();    }

    @Override    public String getDownurls() {        return getDownurl();    }

    @Override    public String getUpdateLogs() {        return getUpdateLog();    }

    @Override    public String getApkSizes() {        return getSize();    }

    @Override    public String getHasAffectCodess() {        return getHasAffectCodes();    }}

下面图片中是必须实现的方法，sdk会根据这些方法返回的数据进行操作，请务必重写！

第七步、开始使用吧

CretinAutoUpdateUtils.getInstance(MainActivity.this).check();

github地址：
https://github.com/MZCretin/AutoUpdateProject

大家都在看

关于Apt注解实践与总结【包含20篇博客】

从零开始跨平台开发 Flutter 1.0 环境搭建

23种设计模式及案例整理分享

一篇文章告诉你MVC、MVP、MVVM

欢迎前往安卓巴士博客区投稿，技术成长于分享

期待巴友留言，共同探讨学习