全部产品
云市场

mPaaS 10.1.68-beta 升级指南

更新时间:2020-03-20 16:43:09

mPaaS 10.1.68 发布说明

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

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

mPaaS 10.1.68-beta 升级指南

使用 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-beta 基线版本,请选择 更新产品集 选项,升级到最新产品集即可。
    • 如果您使用的基线版本非 10.1.68-beta,请选择 升级基线 选项,选择升级的基线版本为 10.1.68-beta。
      升级时间可能比较长,请您耐心等待,不要关闭插件窗口。
      升级基线
  2. 更新或升级成功后,插件上即展示工程的 SDK 版本为 10.1.68-beta

使用 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-beta
    10.1.68-beta

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

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

后续步骤

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

  1. Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.68-beta 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 各组件的配置类的 categoryinfo.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 地址