mPaaS 10.1.60 升级指南

关于 mPaaS 10.1.60

  1. 10.1.60 基线已正式支持 WKWebView 接口，详情请参考 10.1.60 适配 WKWebView。由于 App Store 从 2020 年 4 月起不再接受使用 UIWebView 的新 APP，从 2020 年 12 月起不再接受使用 UIWebview 的 APP 的更新，详情请参见 苹果官方声明 。因此，请开发者注意使用 WKWebView 替换 UIWebView。
  2. 10.1.60 基线最新版已适配 iOS 13 和 Xcode 11，详情可参考 mPaaS 10.1.60 适配 iOS 13。
  3. 10.1.60 基线新增加了小程序组件。小程序正式版拥有更加完善的 API，且在稳定性、兼容性等方面有了大幅提高。关于小程序升级请参见 小程序升级指南，关于小程序 IDE 新增调试、预览、发布等功能的详情请参见 开发小程序。
  4. 10.1.60 基线对 H5 容器整体进行大幅优化，提供了更加简化的接入流程，持续补强能力，在兼容性、稳定性等方面有显著提高。关于 H5 容器和离线包升级，请参见 H5 容器升级指南。
  5. 10.1.60 基线新增加 智能投放 组件。智能投放提供了在应用内个性化投放广告的能力，支持针对定向人群进行个性化广告投放，帮助 APP 运营人员精准、及时触达用户，详情请参见 智能投放。
  6. 10.1.60 基线的整体组件的兼容性、稳定性都有了大幅提高，功能也有着显著提升，具体的发布说明请参见 iOS SDK 发布说明。
  7. 10.1.60 基线已不支持 iOS 8。

mPaaS 10.1.60 升级指南

使用 mPaaS Xcode Extension 进行升级（推荐）

前提条件

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

操作步骤

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

使用 mPaaS 插件接入升级

前提条件

Xcode mPaaS 插件已更新到 5.0.7 或以上的版本。
xcode mpaas 插件版本

操作步骤

  1. 在当前工程下打开插件面板。
    • 如果您已经集成了10.1.60-beta基线版本，切换至 mPaaS产品集更新 选项，升级到最新产品集即可。
      mPaaS产品集更新
    • 如果您使用的基线版本非 10.1.60-beta，请选择 mPaaS基线升级 选项，选择升级的基线版本为 10.1.60。升级时间可能比较长，请您耐心等待，不要关闭插件窗口。
      mPaaS基线升级
  2. 更新或升级成功后，插件上即展示工程的 SDK 版本为 10.1.60。

使用 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.60。
    10.1.60

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

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

后续步骤

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

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

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

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

  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.60 版本。由于线上可用的热修复库是通过工单或技术支持人员提供，请您 提交工单 申请或联系 mPaaS 支持人员。

组件 API 变更

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

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

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

定制库处理

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