mPaaS 10.1.68 发布说明
从 10.1.68 基线开始正式废弃 UIWebView,只支持 WKWebView,详情可参考 mPaaS 适配 WKWebView。App Store 从 2020 年 4 月起不再接受使用 UIWebView 的新 APP,从 2020 年 12 月起不再接受使用 UIWebview 的 APP 的更新。请您尽快升级到 10.1.68 基线,适配 WKWebView。
支持 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 接入。
操作步骤
在 Podfile 中,将 SDK 版本设置改为 10.1.68。
执行
pod mpaas update 10.1.68
,即可安装 10.1.68 基线的最新 SDK。根据需要执行
pod install
或pod update
即可完成对应工程下 10.1.68 的升级。
后续步骤
如果在 CocoaPods 接入时出现类似如下的错误:
Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.68 found !!! Check name & version in Podfile.
可尝试按照以下步骤解决:
运行
gem list | grep 'mPaaS'
命令检查 CocoaPods 插件版本,如下图所示。若 CocoaPods 插件版本 < 0.9.5,请运行以下脚本重新安装插件。
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 升级指南 了解小程序升级的更多信息。
组件 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 进行适配,适配内容包括:
对应平台的应用配置信息更新(在第三方开发者账号中的应用管理中查看),具体适配方式查看参考链接的内容。
对于微信分享,mPaaS 分享组件的配置信息中需要增加字段 “universalLink”,取值为实际应用的 Universal Link 地址。