本文介绍了 mPaaS 10.2.3 版本基线针对 iOS 27 进行的适配，以及用户需要完成的适配工作。
背景
iOS 27 于 2026 年 9 月正式发布。针对新的系统特性和接口，App 需要进行相关适配。目前 mPaaS 已在 10.2.3.75 及以上 的基线版本中完成 iOS 27 的适配和测试工作。
现状
mPaaS 作为基础库，已经在 Xcode 26 构建的 IPA 包下完成 iOS 27 的适配和测试工作。如您的应用计划在苹果 App Store 上线，当前请使用 Xcode 26 打包。
Xcode 27 的相关工具链正在完善中。待工具链完善后，mPaaS 也会推出在 Xcode 27 构建环境下适配 iOS 27 的版本。
升级基线
请将基线版本升级到 10.2.3.75 及以上。
当前基线为 10.2.3 主基线
请将当前使用的产品集更新到 10.2.3 最新版本。
当前基线为定制基线
如果您使用的是定制基线，请搜索群号 41708565 加入钉钉群，或 提交工单 咨询对应的售后及技术支持人员，确认是否可以切换到 10.2.3 基线。
升级方式
基于 Extension 插件升级
使用 mPaaS Xcode Extension 插件升级 SDK/组件，您可以选择以下两种方式：
请根据自身情况选择升级方式：
基于 CocoaPods 升级
按照以下步骤安装 10.2.3 版本的最新 SDK：
确保 Podfile 中 mPaaS 组件的版本号为 10.2.3。
执行
pod mpaas update 10.2.3。如果命令执行报错，请先执行pod mpaas update --all更新插件，再重新执行。执行
pod install。
API 变更
本次 iOS 27 适配暂无 mPaaS 对外 API 使用方式变化。
iOS 27 适配
iOS 27 于 2026 年 9 月正式发布，针对新的系统特性和接口，App 需要进行相关适配。
本基线已在 Xcode 26 构建的 IPA 包下完成 iOS 27 的适配和测试工作。
如您的应用计划在苹果 App Store 上线，当前请使用 Xcode 26 打包。
Xcode 27 的相关工具链正在完善中。待工具链完善后，mPaaS 也会推出在 Xcode 27 构建环境下适配 iOS 27 的版本。
iOS 27 的适配点主要涉及以下组件，包括但不限于：
基础框架
扫码
移动网关
消息推送
分享组件
可视化埋点
离线包
小程序
UI 组件
升级检测
定位组件
CDP 营销组件
部分内部依赖组件
使用以上组件的 App，均需要在 iOS 27 下进行完整测试验证，以保障功能、兼容性和稳定性。
定制基线的处理
如果您使用的是定制基线，可能需要基于新版本重新定制，请 提交工单 或联系 mPaaS 支持人员确认。
注意事项
使用 Xcode 26 构建时，不再支持 iOS 15 之前的系统。如需兼容更早版本，请在升级前评估 App 的最低系统版本。
完成 iOS 27 适配后，建议在 iOS 27 真机环境下对 App 进行全面回归测试，重点验证启动、页面生命周期、网络、推送、扫码、小程序、离线包、定位和分享等核心链路。