API 说明

了解 Android 的升级 SDK 中相关 API 接口的使用方法。

MPaaSCheckVersionService

checkNewVersion

检查应用是否有更新,该方法启动异步任务执行更新检查,无论是否有更新,都会调用 MPaaSCheckCallBack 的相应回调方法。

void checkNewVersion(Activity activity)

setIntervalTime

设置单次提醒的间隔时间。

void setIntervalTime(long interval202)

默认是 3 天,单位:毫秒。

setMPaasCheckCallBack

设置升级 SDK 检测更新时调用的回调实例。

void setMPaaSCheckCallBack(MPaaSCheckCallBack mPaaSCheckCallBack)

installApk

安装新版本安装包,可在MPaaSCheckCallBack.alreadyDownloaded 方法中调用。

void installApk(String filePath)
void installApk(ClientUpgradeRes res)

update

执行下载安装包请求,可在 MPaaSCheckCallBack.showUpgradeDialog 方法中调用。

void update(ClientUpgradeRes res)

MPaaSCheckCallBack

startCheck

调用检测升级接口后被调用,接入方可以在此方法内提示用户加载中。

void startCheck()

isUpdating

当重复调用检测升级接口时被调用。

void isUpdating()

onException

当检测升级过程中发生异常时调用。

void onException(Throwable throwable)

dealDataInValid

检测升级返回的升级信息有效时被调用。

void dealDataInValid(Activity activity, ClientUpgradeRes result)

dealHasNoNewVersion

检测升级返回的升级信息无效时被调用。

void dealHasNoNewVersion(Activity activity, ClientUpgradeRes result)

alreadyDownloaded

检测升级时发现新版本安装包已经下载完成时被调用。接入方可以在此时提示用户安装升级包。如果选择安装,调用 MPaaSCheckVersionService.installApk 方法安装。

void alreadyDownloaded(Activity activity, ClientUpgradeRes result)

showUpgradeDialog

当检测到新版本信息但未下载完安装包时被调用,接入方可在此时提示用户是否升级,如果选择升级的话,调用 MPaaSCheckVersionService.update 方法触发下载任务。

void showUpgradeDialog(Activity activity, ClientUpgradeRes result)

onLimit

当检测到新版本信息但距上次检测的时间小于设定间隔时间时被调用,仅在配置为 单次提示 时有效。

void onLimit(Activity activity, ClientUpgradeRes result, String reason)