快速开始

目前，升级 SDK 支持 原生 AAR 接入 和 组件化接入 两种接入方式。

整个过程分为以下四步：

1. 添加 SDK

2. 工程配置

3. 初始化 mPaaS（仅原生 AAR 接入需要）

4. 升级检测

前置条件

• 若采用原生 AAR 方式接入，需要先 mPaaS 添加到您的项目中。

• 若采用组件化方式接入，需要先完成 组件化接入流程。

添加 SDK

原生 AAR 方式

在工程中通过 组件管理（AAR） 在工程中安装 升级（UPGRADE）组件。更多信息，参考 管理组件依赖。

组件化方式

在 Portal 和 Bundle 工程中通过 组件管理 安装 升级（UPGRADE） 组件。更多信息，参考 添加组件依赖。

工程配置

配置 AndroidManifest

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

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

2. 在 AndroidManifest.xml 文件中添加以下配置。

   将通配符 ${applicationId} 替换为真实的包名。例如，将 ${applicationId}.fileprovider 替换为 com.mpaas.mobiledeliveryservice.fileprovider。

    <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>

   说明

   更多关于配置 AndroidManifest.xml 的信息，请参见 应用清单概览。

3. 在 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>

添加资源

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

初始化 mPaaS

如果您使用原生 AAR 接入方式，则需要初始化 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) {
  // 错误
}