应用升级-联运应用开发-联运服务

场景介绍

在应用启动完成后或用户在应用中主动检查应用新版本时，应用需要调用HMS Core SDK的升级接口检测华为应用市场是否有新版本应用。如果需要升级，HMS Core SDK将拉起升级提示框提示用户在华为应用市场升级应用。

您在调用AppUpdateClient.showUpdateDialog方法时传入强制更新按钮参数mustBtnOne的取值不同会带来不同的用户体验。

当mustBtnOne参数传入true时：若您在AppGallery Connect中升级应用的版本时选择了强制升级，用户只能选择立即更新。
若不选择强制升级，用户可以不立即更新应用而继续使用老版本的应用。
当mustBtnOne参数传入false时：若您在AppGallery Connect中升级应用的版本时选择了强制升级，用户可以选择立即更新或者选择退出应用。若不选择强制升级，用户可以不立即更新应用而继续使用老版本的应用。

说明

请务必保证您的客户端中补充“退出应用”按钮的逻辑处理，否则会导致强制更新失效。

前提条件

已在AppGallery Connect中创建Android应用。
已在您的工程中添加当前应用的AppGallery Connect配置文件。
已配置HMS Core的Maven地址。
已添加appservice SDK的编译依赖，具体请参见添加编译依赖。
收起
自动换行
深色代码主题
复制
```
implementation 'com.huawei.hms:appservice:{version}'
```
{version}替换为APP Service的最新版本号，请参见添加编译依赖。
已添加混淆脚本。

开发步骤

本功能涉及的关键开发步骤如下：

调用JosApps.getAppUpdateClient方法初始化AppUpdateClient对象，并调用AppUpdateClient.checkAppUpdate方法请求检查应用是否有更新。
收起
自动换行
深色代码主题
复制
```
public void checkUpdate() {
    AppUpdateClient client = JosApps.getAppUpdateClient(this);
    client.checkAppUpdate(this, callback);
}
```

SDK通过回调方式将检查结果返回给应用，应用从回调结果中onUpdateInfo方法返回的ApkUpgradeInfo实例确认应用是否有更新。如果有新版本，则调AppUpdateClient.showUpdateDialog方法请求拉起升级提示页面。

收起
自动换行
深色代码主题
复制
private static class Callback implements CheckUpdateCallBack {
    private WeakReference<Context> mContextWeakReference;
    public Callback(Context context) {
        mContextWeakReference = new WeakReference<>(context);
    }
    @Override
    public void onUpdateInfo(Intent intent) {
        if (intent != null) {
            // 更新状态信息
            int status = intent.getIntExtra(UpdateKey.STATUS, -99);
            Log.i(TAG, "check update status is:" + status);
            // 返回错误码
            int rtnCode = intent.getIntExtra(UpdateKey.FAIL_CODE, -99);
            // 返回失败信息
            String rtnMessage = intent.getStringExtra(UpdateKey.FAIL_REASON);
            // 强制更新应用时，弹出对话框后用户是否点击“退出应用”按钮
            boolean isExit = intent.getBooleanExtra(UpdateKey.MUST_UPDATE, false);
            Log.i(TAG, "rtnCode = " + rtnCode + "rtnMessage = " + rtnMessage);

            Serializable info = intent.getSerializableExtra(UpdateKey.INFO);
            // 如果info属于ApkUpgradeInfo类型，则拉起更新弹框
            if (info instanceof ApkUpgradeInfo) {
                Context context = mContextWeakReference.get();
                if (context != null) {
                    // showUpdateDialog接口中最后一个字段传入不同取值会带来不同的用户体验，具体请参考本文档的场景描述，此处以false为例
                    JosApps.getAppUpdateClient(context).showUpdateDialog(context,(ApkUpgradeInfo) info,false);
                }
                Log.i(TAG, "check update success and there is a new update");
            }
            Log.i(TAG, "check update isExit=" + isExit);
            if (isExit) {
                // 是强制更新应用，用户在弹出的升级提示框中选择了“退出应用”，处理逻辑由您自行控制，这里只是个例子
                System.exit(0);
            }
        }
    }

    @Override
    public void onMarketInstallInfo(Intent intent) {

    }

    @Override
    public void onMarketStoreError(int i) {

    }

    @Override
    public void onUpdateStoreError(int i) {

    }
}