进阶指南 - 移动开发平台 mPaaS

接入 SDK 之后，您可以根据业务需求，设置升级白名单，使用 SDK 进行升级检测、并提示用户。

设置白名单

设置白名单用户 ID：

   
    MPLogger.setUserId("您的白名单ID");

检测新版本

快速检测新版本，并弹框提示：

说明：仅快速显示升级弹框，不包含强制升级逻辑，若您需要强制升级，请使用自定义升级来进行实现。
```
     
        MPUpgrade mMPUpgrade = new MPUpgrade();
        mMPUpgrade.fastCheckNewVersion(activity, drawable);
     
```

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

     
        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) {
          // 错误
        }

获取升级详细信息

调用 fastGetClientUpgradeRes 方法获取更多详细信息：

   
    MPUpgrade mMPUpgrade = new MPUpgrade();
    // 同步方法，子线程中调用
    ClientUpgradeRes clientUpgradeRes = mMPUpgrade.fastGetClientUpgradeRes();

以下返回的示例显示新版本号、下载地址等信息：

ClientUpgradeRes

其中部分参数含义如下：

downloadURL：下载地址
guideMemo：升级信息
newestVersion：最新版本
resultStatus：升级模式
- 202 为单次提醒
- 204 为多次提醒
- 203/206 为强制更新

其它自定义检测

更多定制，参考以下操作示例：

实现 MPaaSCheckCallBack 接口，用于响应升级 SDK 发出的请求，如弹出提示框：

     
        MPUpgrade mMPUpgrade = new MPUpgrade();
        mMPUpgrade.setUpgradeCallback(new MPaaSCheckVersionService.MPaaSCheckCallBack() {
             .........
        });

调用 MPUpgrade.checkNewVersion 方法检测升级信息。

说明： MPUpgrade 内部封装了 MPaaSCheckVersionService 的调用；您也可以自行定制实现。有关 MPaaSCheckVersionService 和 MPaaSCheckCallBack 的介绍，请参见 API 说明。

自定义安装包下载目录（10.1.60 及以上版本支持）

配置如下：

   
    File dir = getApplicationContext().getExternalFilesDir("自定义目录");
    MPUpgrade mpUpgrade = new MPUpgrade();
    mpUpgrade.setDownloadPath(dir.getAbsolutePath());

同时在 file_path.xml 中添加以下配置：

   
    // external-files-path 对应 getExternalFilesDir 的目录
    // 请使用与您自定义的目录对应的元素，如果您不清楚该如何选择，请搜索“适配 File Provider”
    <external-files-path
      name="download"
      path="自定义目录" />

处理强制升级解析包失败的问题

部分 rom 在强制升级后，会出现解析包失败问题。发生该问题的原因是，在部分 rom 中，安装包时会访问相应的 App 进程。而强制升级会强制结束 App 进程，所以导致解析包失败。虽然这种 rom 定制行为本身是不符合原生 Android 的行为，但您仍可以通过以下方式进行解决：设置UpgradeForceExitCallback，在 needForceExit 返回 false 即可。

实现回调。

     
       public class UpgradeForceExitCallbackImpl implements UpgradeForceExitCallback {
           @Override
           public boolean needForceExit(boolean forceExitApp, MicroApplicationContext context) {
               // 返回 false，就不强制杀掉进程，不会有安装包解析失败问题；返回 true，需要自行对进程的退出进行处理，会走到下面 doForceExit 方法中。
               return false;
           }
           @Override
           public void doForceExit(boolean forceExitApp, MicroApplicationContext context) {
               // 如果需要关闭进程，则需要上面 needForceExit 返回 true，然后在本方法内自行关闭进程。
           }
       }

设置回调。
```
     
       MPUpgrade mpUpgrade = new MPUpgrade();
       mpUpgrade.setForceExitCallback(new UpgradeForceExitCallbackImpl());
     
```
注意：
- 使用同一 MPUpgrade 实例设置回调或请求升级。
- 设置回调后可以避免解析包失败问题，但升级组件将不再自动帮您杀进程。因此当用户没有点击安装而是返回到应用的时候，请您自行设置不可取消的弹框遮盖层，以防止用户绕过强制升级。