本文主要是介绍Android App内部自动更新Library (最新),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
AutoUpdateProject
最新版本已经到1.1.4
最新版本及说明请关注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;
二、根据后台返回受影响的版本号,可控制多个版本同时被强制更新;
三、后台返回最新安装包大小,本地判断安装包是否下载,防止多次下载;
四、内部处理,忽略此版本更新提示;
五、采用无第三方工具类,下载使用HttpURLConnextion,本地存储使用SharedPrefference,以免使用此library带来第三方插件冲突
六、适配Android 7.0
七、默认请求方式为POST请求,对于GET请求无法正常请求,提供配置请求方式
八、添加了对log日志的开关,在调试阶段可打开调试log输出,提交生产环境的时候可以主动的关闭
九、支持判断网络环境,移动数据下只能提示,防止流量外漏。
十、考虑到减少与后台人员的配合的高度耦合,增加了自定义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("测试应用") .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|4public 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、修复bug2、完善部分功能点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|4public 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;}@Overridepublic int getVersionCodes() {return getVersionCode();}@Overridepublic int getIsForceUpdates() {return getIsForceUpdate();}@Overridepublic int getPreBaselineCodes() {return getPreBaselineCode();}@Overridepublic String getVersionNames() {return getVersionName();}@Overridepublic String getDownurls() {return getDownurl();}@Overridepublic String getUpdateLogs() {return getUpdateLog();}@Overridepublic String getApkSizes() {return getSize();}@Overridepublic 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;}@Overridepublic int getVersionCodes() {return getVersionCode();}@Overridepublic int getIsForceUpdates() {return getIsForceUpdate();}@Overridepublic int getPreBaselineCodes() {return getPreBaselineCode();}@Overridepublic String getVersionNames() {return getVersionName();}@Overridepublic String getDownurls() {return getDownurl();}@Overridepublic String getUpdateLogs() {return getUpdateLog();}@Overridepublic String getApkSizes() {return getSize();}@Overridepublic String getHasAffectCodess() {return getHasAffectCodes();}
}
下面图片中是必须实现的方法,sdk会根据这些方法返回的数据进行操作,请务必重写!
第七步、开始使用吧
CretinAutoUpdateUtils.getInstance(MainActivity.this).check();
github地址:https://github.com/MZCretin/AutoUpdateProject
如果排版看着难受,请移步 http://www.jianshu.com/p/39621c0b4c57
如果您觉得有用,请打赏我一杯咖啡的钱!谢谢
这篇关于Android App内部自动更新Library (最新)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!