mPaaS 10.2.3 Compatibility with iOS 27
This document describes the mPaaS 10.2.3 baseline's compatibility with iOS 27 and outlines the required steps.
Background
iOS 27 was officially released in September 2026. Apps require compatibility updates to support the new system features and APIs. mPaaS has completed the adaptation and testing for iOS 27 in baseline version 10.2.3.75 and later.
Current status
As a foundational library, mPaaS has adapted and tested for iOS 27 using IPA packages built with Xcode 26. If you plan to release your App on the App Store, you must use Xcode 26 for packaging.
The toolchain for Xcode 27 is not yet final. Once finalized, mPaaS will release a compatible version for the Xcode 27 build environment.
Baseline upgrade
Upgrade your baseline to version 10.2.3.75 or later.
Main baseline
Update your current product set to the latest 10.2.3 version.
Customized baselines
If you are using a customized baseline, join our DingTalk group by searching for group number 41708565, or submit a ticket to consult our support team about switching to the 10.2.3 baseline.
Upgrade methods
Using the Extension plugin
To upgrade the SDK or components using the mPaaS Xcode Extension plugin, choose one of the following methods:
Choose an upgrade method based on your scenario:
If you already use the Extension plugin to manage component dependencies but your current baseline is older than 10.2.3, use the Upgrade baseline feature to upgrade to version 10.2.3.
NoteYou can view your current baseline version in the Baseline Upgrade section of the plugin.
If you already use the plugin to manage component dependencies and your current baseline is 10.2.3, use the Update product set feature to upgrade your modules.
If you do not use the plugin to manage component dependencies, follow these steps to upgrade:
Use the Edit modules feature to select the 10.2.3 baseline and add the required modules.
Using CocoaPods
Follow these steps to install the latest SDK for version 10.2.3:
Make sure the version number for mPaaS components in your Podfile is 10.2.3.
Run
pod mpaas update 10.2.3. If the command fails, first runpod mpaas update --allto update the plugin, and then run the command again.Run
pod install.
API changes
This iOS 27 compatibility update does not change any public mPaaS APIs.
iOS 27 adaptation
The iOS 27 compatibility updates primarily affect the following components, including but not limited to:
Basic framework
Scan
Mobile Gateway
Message Push
Share
Visual tracking
Offline package
Mini Program
UI component
Upgrade Check
Location
CDP component
Internal dependencies
Apps that use any of these components require thorough testing on iOS 27 to ensure their functionality, compatibility, and stability.
About customized baselines
If you are using a customized baseline, you may need to re-customize it based on the new version. Please submit a ticket or contact mPaaS support to confirm.
Important notes
Building with Xcode 26 drops support for iOS versions earlier than 15. If you need to support earlier versions, evaluate your App's minimum OS version before you upgrade.
After completing the iOS 27 compatibility updates, we recommend full regression testing on a physical device running iOS 27. Pay special attention to core processes such as App startup, page lifecycle, networking, push notifications, Scan, Mini Program, offline package, Location, and Share.