Adapt mPaaS 10.2.3 for Xcode 16

更新时间:
复制 MD 格式

Background

Starting April 24, 2025, Apple requires all apps submitted to the App Store to be built with Xcode 16 or later. For details, see the official Apple announcement. Additionally, Xcode 16 no longer supports debug builds for devices running systems earlier than iOS 15. For details, see the Xcode 16 Release Notes.

Current status

mPaaS supports Xcode 16 in baseline version 10.2.3.59 and later. If you use baseline 10.1.68 (deprecated) or earlier, upgrade to the latest 10.2.3 version. Systems earlier than iOS 13 are no longer supported.

Upgrade the baseline

Choose an upgrade method based on your current baseline version.

Current baseline is 10.2.3 main baseline

First, see Adapt mPaaS 10.2.3 for iOS 18 to upgrade to the latest 10.2.3 baseline and perform the necessary adaptations.

Current baseline is a custom baseline

If you use a custom baseline, join the DingTalk group (ID: 145930007362) or submit a ticket to consult with technical support about switching to the 10.2.3 baseline.

Upgrade methods

Upgrade using the Extension plug-in

To upgrade the SDK or components by using the mPaaS Xcode Extension plug-in, use one of the following methods:

Choose the upgrade method that fits your situation.

  • If you already use the Extension plug-in to manage component dependencies but your current baseline is earlier 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 plug-in's Baseline Upgrade section.

  • If you already use the plug-in to manage component dependencies and your current baseline is 10.2.3, use the Update Product Set feature to upgrade the modules you use.

  • If you do not use the plug-in to manage component dependencies, perform the following steps to upgrade:

    1. Install mPaaS Xcode Extension.

    2. Use the Edit Module feature to select the 10.2.3 baseline and add the required modules.

Upgrade using CocoaPods

Follow these steps to install the latest SDK for version 10.2.3:

  1. Verify that the mPaaS component version in your Podfile is 10.2.3.

  2. Run the pod mpaas update 10.2.3 command.

    If the command returns an error, update the plug-in by running the pod mpaas update --all command, and then retry.

  3. Run the pod install command.

Upgrade notes

When you upgrade to baseline version 10.2.3.30 or later by using the Extension plug-in, adding modules such as Threat Perception or Guomi (shown in the following figure) requires an additional step.

image.png

Manually add the libresolv system library to Other Linker Flags in the Build Settings of the main project.

image.png

Otherwise, the following error occurs:

image.png

API changes

This Xcode 16 adaptation does not include any API changes.

List of libraries updated for Xcode 16

  • Mobile Gateway

  • Data Synchronization

  • Message Push

  • Sharing Component

  • Offline Package

  • Mini Program

  • UI Component

  • Framework

  • Upgrade Check

Notes

To use the Alipay payment SDK (AlipaySDK), update it through the Alipay Open Platform.

Test and validation scope

Apple toolchain upgrades can cause unexpected issues. After you adapt your app for Xcode 16, perform a full regression test.