全部产品
Search
文档中心

移动开发平台mPaaS:mPaaS 10.1.68 升级指南

更新时间:Aug 24, 2023

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 升级指南

使用 CocoaPods 接入升级

前提条件

已安装 CocoaPods mPaaS 插件。

  • 如您尚未安装 CocoaPods mPaaS插件,请您在终端执行以下脚本安装 CocoaPods 插件。

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

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

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

后续步骤

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

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,请运行以下脚本重新安装插件。

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

组件使用升级指南

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

组件 API 变更

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

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

说明
  • 强烈建议您修改代码,使用中间层(适配器)方法而非直接使用底层方法,因为某些底层方法可能会在将来的版本中发生变更或废弃。如果您继续使用,在将来的更新中可能需要花费更多的时间进行适配。

定制库处理

10.1.68 基线版本各组件合入了定制化的需求,但是为了稳妥起见,如果此前您的依赖中包含定制库且是从低版本 SDK(如 10.1.32)升级至 10.1.68 版本,您的定制库可能需要基于新版本重新定制,请搜索群号 41708565 加入钉钉群进行咨询。

分享组件

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

  1. 对应平台的应用配置信息更新(在第三方开发者账号中的应用管理中查看),具体适配方式查看参考链接的内容。

  2. 对于微信分享,mPaaS 分享组件的配置信息中需要增加字段 “universalLink”,取值为实际应用的 Universal Link 地址。