文档

mPaaS 10.2.3 升级指南

更新时间:

mPaaS 10.2.3 基线基于 10.1.68.52 版本,融合了多条定制化基线中的新组件、定制功能、合规改造等变更,包括但不限于以下特性。

安全合规

无线保镖支持国密签名,使用本基线需要更换无线保镖图片为 V6 版本,如使用原有 V5 图片会导致无线保镖报错,升级图片请参看 配置 V6 无线保镖图片

新增组件

  • 国密 SSL(专有云)

  • 人脸核身(专有云)

  • 终端环境检测(专有云)

  • 移动威胁感知/设备风险咨询(专有云)

  • 扫一扫 AI

  • 智能双录(专有云)

  • 魔方卡片

兼容性

  • 从 mPaaS 10.2.3.4 起,支持 targetSdkVersion 31。

  • 支持 targetSdkVersion 30。

  • CPU 架构仅支持 armeabi-v7a 和 arm64-v8a ,不再支持 armeabi。

  • 接入方式不再维护 mPaaS Inside 方式,原 mPaaS Inside 接入如需升级到 10.2.3,请修改为 mPaaS AAR 接入。

  • 默认适配 Android 13,升级后无需额外适配工作。

升级指南

配置 V6 无线保镖图片

  1. 在 mPaaS 控制台中 下载最新的配置文件

    image

  2. 确认下载的配置文件(Ant-mpaas-xxxxx-Android.config)中存在名为 v6Base64Code 的 key 及其对应的 value 有值,如 value 为空请确认下载前已上传签名正确的 APK 并重新下载。

  3. 升级您工程中的 easyconfig 插件到 2.8.4 版本,在根目录下 build.gradle 中修改如下配置。

    classpath 'com.android.boost.easyconfig:easyconfig:2.8.4'
  4. 配置完成,重新编译 APK 即可。

    重要

    升级为 v6 版本后依然需要开启 v1 签名,详情请参考如何解决运行时出现的 608 错误或 libsgmain 的 native 错误

安全保障

基于 mPaaS 框架开发 App 时,使用 H5 容器/小程序的 App 会较多使用 JSAPI,建议在打开 URL 时以及使用 JSAPI 时对 URL 进行校验,确保是 App 业务内的 URL 才能进行加载打开或限制 URL 的 JSAPI 调用范围和权限,以防因为未鉴权造成问题。

  1. 设置 JSAPI 鉴权

  2. 设置 URL 白名单

组件管理变更

在更新至 10.2.3 基线版本之后,以下组件发生了变更,如您之前有选择这些组件,则需要按照以下改动重新操作。更多信息,请参考 组件管理

  • 同步服务 已变更为 移动同步

  • 扫码 已变更为 扫一扫

  • 新增 扫一扫 AI ,如需使用 AI 识别扫码能力,可添加该组件。

组件使用升级指南

统一存储

从 10.2.3 基线起,数据库存储创建 OrmLiteSqliteOpenHelper 的方法有更新,详情请参见 创建 OrmLiteSqliteOpenHelper

组件 API 变更

统一存储

  • 新增 com.alibaba.mpaasdb.MPSQLiteOpenHelper

  • 新增 com.alibaba.mpaasdb.MPSQLiteDatabase

  • 移除 com.alibaba.sqlcrypto.sqlite.SQLiteDatabase

  • com.j256.ormlite.xx 全部变更为 com.alibaba.j256.ormlite.xx

定制基线处理

如果您使用的是定制基线,可能需要基于新版本重新定制,欢迎搜索群号 41708565 加入钉钉群联系 mPaaS 支持人员确认。

回归测试

组件

验证项目

移动网关

  • RPC 请求是否正常

  • RPC 请求开启验签后是否正常

移动推送

  • 用户维度推送是否正常

  • 厂商通道推送是否正常

移动同步

  • 同步功能是否正常

统一存储

UC 内核

  • 在 Android 13 设备上是否开启

H5 容器和离线包

  • 依赖 UC 内核特性的业务是否正常

  • 离线包下载更新是否正常

小程序

  • 依赖 UC 内核特性的业务是否正常

  • 小程序下载更新是否正常

开关配置

  • 开关下发和更新是否正常

升级

  • 版本更新检测是否正常

热修复

  • 补丁包下载是否正常

智能投放

  • 展位及素材信息下载更新是否正常

定位

  • 签到功能是否正常

音视频通话

  • 通话是否成功建立并且画面正常