mPaaS 10.1.68 升级指南

mPaaS 10.1.68 发布说明

  1. 从 10.1.68 基线开始正式废弃 UIWebView，只支持 WKWebView，详情可参考 mPaaS 适配 WKWebView。App Store 从 2020 年 4 月起不再接受使用 UIWebView 的新 APP，从 2020 年 12 月起不再接受使用 UIWebview 的 APP 的更新，详情请参见 苹果官方声明 。请您尽快升级到10.1.68基线，适配 WKWebView。

  2. 支持 Xcode 11 构建静态库打包，全面兼容 Xcode 11 开发。

mPaaS 10.1.68 升级指南

使用 mPaaS Xcode Extension 进行升级

前提条件

mPaaS Xcode Extension 已更新为 1.1.0 或更高版本。关于更新 mPaaS Xcode Extension 请参见 更新 mPaaS Xcode Extension。

操作步骤

  1. 在 Xcode 菜单中，点击 Editor > mPaaS > 编辑工程，打开 mPaaS Xcode Extension。
    • 如果您已经集成了10.1.68 基线版本，请选择 更新产品集 选项，升级到最新产品集即可。
    • 如果您使用的基线版本非 10.1.68，请选择 升级基线 选项，选择升级的基线版本为 10.1.68。
      升级时间可能比较长，请您耐心等待，不要关闭插件窗口。
      升级基线
  2. 更新或升级成功后，插件上即展示工程的 SDK 版本为 10.1.68。

使用 CocoaPods 接入升级

前提条件

已安装 CocoaPods mPaaS 插件。

  • 如您尚未安装 CocoaPods mPaaS插件，请您在终端执行以下脚本安装 CocoaPods 插件。
    1.   sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)
  • 如您已安装了 CocoaPods mPaaS 插件，则可以直接使用升级命令pod mpaas update --all升级插件。更多 CocoaPods mPaaS 插件使用信息，请参见 基于原生框架且使用 CocoaPods 接入。

操作步骤

  1. 在 Podfile 中，将 SDK 版本设置改为 10.1.68。
    2

  2. 执行 pod mpaas update 10.1.68，即可安装 10.1.68 基线的最新 SDK。

  3. 根据需要执行 pod install 或 pod update 即可完成对应工程下 10.1.68 的升级。

后续步骤

如果在 CocoaPods 接入时出现类似如下的错误：

  1. Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.68 found !!! Check name & version in Podfile.

可尝试按照以下步骤解决：

  1. 运行 gem list | grep 'mPaaS' 命令检查 CocoaPods 插件版本，如下图所示。
    cocoapod 故障排查

  2. 若 CocoaPods 插件版本 < 0.9.5，请运行以下脚本重新安装插件。

  1. sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

组件使用升级指南

如果您当前的基线版本 <10.1.60 且集成了 H5 容器、小程序和热修复组件，那么请您详细阅读下列说明：

  • 请阅读 H5 容器 10.1.60 升级指南 了解 H5 容器和离线包升级的更多信息。
  • 请阅读 小程序 10.1.60 升级指南 了解小程序升级的更多信息。
  • 若当前基线版本 < 10.1.60，则热修复库也必须升级至 10.1.68 版本。由于线上可用的热修复库是通过工单或技术支持人员提供，请您 提交工单 申请或联系 mPaaS 支持人员。

组件 API 变更

mPaaS 组件从 10.1.32 基线开始添加了适配层，如您使用的基线未使用适配层 API，请先行阅读 mPaaS 10.1.32 适配 iOS 13。

建议您在升级 SDK 后使用适配层的 API，具体可参考以下各组件文档中的旧版本升级注意事项：

注意：
  • 需重点关注项目中 mPaaS 各组件的配置类的 category 和 info.plist 中的配置发生的变化。
  • 强烈建议您修改代码，使用中间层（适配器）方法而非直接使用底层方法，因为某些底层方法可能会在将来的版本中发生变更或废弃。如果您继续使用，在将来的更新中可能需要花费更多的时间进行适配。

定制库处理

10.1.68 基线版本各组件合入了定制化的需求，但是为了稳妥起见，如果此前您的依赖中包含定制库且是从低版本 SDK（如 10.1.32）升级至 10.1.68 版本，您的定制库可能需要基于新版本重新定制，请 提交工单 或联系 mPaaS 支持人员确认。

分享组件

10.1.68 版本分享组件中的第三方 SDK 已升级，包括微信 SDK，微博 SDK，QQ 互联 SDK。由于微信和 QQ 的分享在最新版本中增加了 Universal Link 的特性，因此请您注意对新版 SDK 进行适配，适配内容包括：

  1. 对应平台的应用配置信息更新（在第三方开发者账号中的应用管理中查看），具体适配方式查看参考链接的内容。
  2. 对于微信分享，mPaaS 分享组件的配置信息中需要增加字段 “universalLink”，取值为实际应用的 Universal Link 地址