AutoUpdateProject
最新版本及说明请关注GitHub，欢迎Star。
有什么意见与建议欢迎交流！
github地址：https://github.com/MZCretin/AutoUpdateProject
公告：移除了之前所有版本的文档说明，从现在起，版本的更新迭代从1.1.2开始进行，之前的老版本使用没有影响，只是不再提供集成说明。
查看历史版本使用说明：
http://www.jianshu.com/p/29783ac71757
http://blog.csdn.net/u010998327/article/details/62036622
V1.1.2版本
Android App内部版本更新library
特点概述
一、可从后台主动控制本地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节点下添加如下代码：
<application android: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> <!--these codes--> <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标签内填下以下内容
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.fileprovider"
android:grantUriPermissions="true"
android:exported="false"
>
<meta-data
android: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();
點擊查看更多內容
為 TA 點贊
評論
評論
共同學習，寫下你的評論
評論加載中...
作者其他優質文章
正在加載中
感謝您的支持，我會繼續努力的～
掃碼打賞，你說多少就多少
贊賞金額會直接到老師賬戶
支付方式
打開微信掃一掃，即可進行掃碼打賞哦