mPaaS 10.2.3 Compatibility with iOS 27

Updated at:

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.

    Note

    You 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:

    1. Install mPaaS Xcode Extension.

    2. 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:

  1. Make sure the version number for mPaaS components in your Podfile is 10.2.3.

  2. Run pod mpaas update 10.2.3. If the command fails, first run pod mpaas update --all to update the plugin, and then run the command again.

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