UIScene life cycle implementation

[davidzampier]

Hello everyone

According to this Apple Technote, the UIScene life cycle will be required in the next major iOS release following iOS 26. However, the current SDK documentation does not provide guidance on the proper way to adopt it with mParticle.

At the moment, our integration relies on the UIApplication Delegate Proxy to intercept key application life-cycle events and handle features such as deep link navigation and user activities. Once the app implements a SceneDelegate, many of these events are handled there instead of in the UIApplication.delegate, meaning they are no longer automatically forwarded to the mParticle SDK.

Additionally, several UIApplicationDelegate methods — including application(_:open:options:) — are now marked as deprecated, along with other key entry points.

---

Questions

Given these upcoming changes, I’d like to clarify a few points:

1. Integration approach
   What’s the correct way to integrate mParticle using the UIScene life cycle?

   • Is there any documentation or example for UIScene-based setups?
   • Should we disable the delegate proxy and manually forward each event to the SDK?

2. Handling launch options
   In application(_:didFinishLaunchingWithOptions:), the launchOptions parameter becomes nil after adopting SceneDelegate.
   Instead, that data is now available in scene(_:willConnectTo:options:) under connectionOptions.

   • If needed, how should this data be forwarded to mParticle to ensure proper handling of app launches from shortcuts, push notifications, or similar entry points?

3. API alignment
   UISceneDelegate methods often provide different types and data structures.

   • Will the SDK be updated to support the UIScene life cycle natively or to match the UISceneDelegate API?
   • If not, is there recommended guidance on how to forward SceneDelegate events without losing contextual information?

---

This change in Apple’s app life-cycle model will soon affect all iOS apps, so having an official recommendation or migration guide from mParticle would be really helpful for developers preparing for iOS 27 and beyond.

[BrandonStalnaker]

Hi @davidzampier ,

Thank you so much for creating this issue and providing such a detailed breakdown of the UIScene lifecycle concerns. We really appreciate you taking the time to outline the specific integration challenges and questions — this level of detail is extremely helpful.

We want to let you know that we are actively aware of these upcoming changes and have been investigating UIScene lifecycle support for the SDK. Apple's deprecation of UIApplicationDelegate methods and the eventual requirement for UIScene-based architecture is definitely on our radar.

However, we don't have a concrete timeline to share at this moment. As we work through the architectural considerations and testing requirements, we'll be sure to update this issue with our progress and any interim guidance we can provide.

In the meantime, we'll keep this issue open and prioritized. Please continue to share any additional insights or specific use cases you encounter as you prepare for iOS 27+.

We'll post updates here as soon as we have more information to share.

Thanks again for bringing this to our attention!

Best regards,
Brandon Stalnaker

PS sorry for the slow reply. There was a miscommunication on who would reply here and the resulting work has been more tied to internal comms with customers.