快速开始

在 mPaaS 控制台发布 App 的新版本，客户端可以通过升级接口检测到该新版本，进而提醒用户下载更新。

本文介绍如何添加与发布管理功能相关的 升级 SDK。目前，升级 SDK 支持 原生 AAR 接入、mPaaS Inside 接入 和 组件化接入 三种接入方式。

整个过程分为以下四步：

1. 添加 SDK
2. 工程配置
3. 初始化 mPaaS（仅原生 AAR 接入或 mPaaS Inside 接入需要）
4. 升级检测

前置条件

• 若采用原生 AAR 方式接入，需要先 将 mPaaS 添加到您的项目中。
• 若采用 mPaaS Inside 方式接入，需要先完成 mPaaS Inside 接入流程。
• 若采用组件化方式接入，需要先完成 组件化接入流程。

添加 SDK

原生 AAR 方式

参考 AAR 组件管理，通过 组件管理（AAR） 在工程中安装 升级（UPGRADE）组件。

mPaaS Inside 方式

在工程中通过 组件管理 安装 升级（UPGRADE）组件。

更多信息，参考 管理组件依赖 > 增删组件依赖。

组件化方式

在 Portal 和 Bundle 工程中通过 组件管理 安装 升级（UPGRADE） 组件。

更多信息，参考 管理组件依赖 > 增删组件依赖。

工程配置

配置 AndroidManifest

1. 在 AndroidManifest.xml 中添加以下权限：

    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

2. 在 portal 工程主 module 的 src/main/res/xml 目录下创建文件 file_paths.xml，文件内容为：

    <?xml version="1.0" encoding="utf-8"?>
    <resources>
    <paths>
     <external-files-path
         name="download"
         path="com.alipay.android.phone.aliupgrade/downloads" />
     <external-path
         name="download_sdcard"
         path="ExtDataTunnel/files/com.alipay.android.phone.aliupgrade/downloads" />
    </paths>
    </resources>

3. 在 AndroidManifest.xml 文件中添加以下配置：

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

添加资源

将 values 目录下 strings.xml、styles.xml、colors.xml 的内容合并即可。

初始化 mPaaS

如果您使用原生 AAR 接入或 mPaaS Inside 接入方式，则需要初始化 mPaaS。

在 Application 对象中添加以下代码：

public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        // mPaaS 初始化回调设置
        QuinoxlessFramework.setup(this, new IInitCallback() {
            @Override
            public void onPostInit() {
                // 此回调表示 mPaaS 已经初始化完成，mPaaS 相关调用可在这个回调里进行
            }
        });
    }
    @Override
    public void onCreate() {
        super.onCreate();
        // mPaaS 初始化
        QuinoxlessFramework.init();
    }
}

快速升级检测

快速检测新版本，仅返回检测结果：

MPUpgrade mMPUpgrade = new MPUpgrade();
// 同步方法，子线程中调用
int result = mMPUpgrade.fastCheckHasNewVersion();
if (result == UpgradeConstants.HAS_NEW_VERSION) {
  // 有新版本
} else if (result == UpgradeConstants.HAS_NO_NEW_VERSION) {
  // 没有新版本
} else if (result == UpgradeConstants.HAS_SOME_ERROR) {
  // 错误
}