Blog
ENGINEERING

How to migrate AppDelegate to UISceneDelegate (iOS 26 Requirement)

Mike Miller

October 23, 2025

iOS26 Push Notifications Changes

Table of contents

1. TL;DR

2. What’s Changing — and Why It Affects Push Notifications

3. What’s Not Changing — The APNs Flow Remains the Same

4. How to Support Scenes — Step-by-Step (UIKit and SwiftUI)

5. When Enforcement Happens — iOS 26 vs iOS 27 Timeline

6. Final Checklist & Takeaways

Apple is changing how UIKit apps start — and it directly impacts push notifications.
Starting in iOS 26, developers began seeing console warnings urging adoption of the scene-based life cycle (UIScene). With iOS 27, that shift becomes mandatory.
If your app doesn’t use scenes, it won’t launch when built with the new SDK — and without launch, there’s no way to register for remote notifications or receive APNs tokens.

In iOS 26, iPadOS 26, Mac Catalyst 26, tvOS 26, visionOS 26, you'll start seeing the following message:

"UIScene lifecycle will soon be required. Failure to adopt will result in an assert in the future."

This guide explains exactly what’s changing, what stays the same, and the fastest way to migrate — so your push notifications keep flowing and app keeps working.


1. TL;DR

  • iOS 26: Apps must start supporting UISceneDelegate.
  • iOS 27 SDK: Non-scene apps will crash on launch. Enforcement happens when you build with the iOS 27 SDK, not simply by running on the OS.
  • Push fundamentals stay the same: You’ll still request authorization, register for remote notifications, and receive APNs device tokens in AppDelegate.
  • Keep your AppDelegate. Token callbacks still arrive there.
  • Add a UISceneDelegate. Add a UISceneDelegate now to ensure your push registration and Courier token sync continue working with iOS 27 and beyond.
  • But where does didRegisterForRemoteNotificationsWithDeviceToken go now? It stays in your AppDelegate — there’s no UISceneDelegate equivalent. Apple hasn’t introduced a scene-based version of that callback, so keep handling APNs tokens in AppDelegate (or let CourierDelegate handle it automatically).
  • Test on a physical device. We're seeing inconsistent results with the simulator. Simulated devices are not a reliable way to ensure your push notifications are working with iOS 26 at the moment.

2. What’s Changing — and Why It Affects Push Notifications

Apple is retiring the single-window AppDelegate life cycle and making UIScene mandatory for UIKit apps — a shift that started back in iOS 13 but is only now being enforced. Scenes allow each window to manage its own state, enabling features like iPad multitasking and smoother background/foreground transitions.

By iOS 26, Apple began warning developers:

“This process does not adopt the UIScene lifecycle. This will become an assert in a future version.”

That future version is the iOS 27 SDK.
If your app doesn’t declare a scene, it won’t launch — meaning didRegisterForRemoteNotificationsWithDeviceToken() in your App Delegate never runs, and APNs tokens are never issued. No token = no push.

Supporting a scene in your app ensures:

  • Your app launches correctly on iOS 27 and later.
  • Push registration occurs reliably once a scene connects.
  • Your tokens flow through to Courier without interruption.

3. What’s Not Changing — The APNs Flow Remains the Same

Apple hasn’t changed the push fundamentals.
Here’s the core flow that still applies in both UIKit and SwiftUI:

Copied!

// 1. Ask permission
UNUserNotificationCenter.current()
.requestAuthorization(options: [.alert, .badge, .sound]) { granted, _ in
if granted {
DispatchQueue.main.async {
UIApplication.shared.registerForRemoteNotifications()
}
}
}
// 2. Receive the device token
func application(_ application: UIApplication,
didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
let token = deviceToken.map { String(format: "%02x", $0) }.joined()
print("APNs token: \(token)")
// Send to backend / Courier
}
  • Token callbacks still live in AppDelegate.
  • Courier integration doesn’t change. If you use CourierDelegate, all of this is done automatically for you.
  • Permission API is identical. UNUserNotificationCenter is still how you request notification authorization.

4. How to Support Scenes — Step-by-Step (UIKit and SwiftUI)

UIKit Apps

  1. Add the Scene Manifest to Info.plist

Copied!

<key>UIApplicationSceneManifest</key>
<dict>
<key>UIApplicationSupportsMultipleScenes</key>
<false/>
<key>UISceneConfigurations</key>
<dict>
<key>UIWindowSceneSessionRoleApplication</key>
<array>
<dict>
<key>UISceneConfigurationName</key>
<string>Default Configuration</string>
<key>UISceneDelegateClassName</key>
<string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
</dict>
</array>
</dict>
</dict>
  1. Create a UIWindowSceneDelegate

Copied!

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
var window: UIWindow?
func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
// Use this method to optionally configure and attach the UIWindow `window` to the provided UIWindowScene `scene`.
// If using a storyboard, the `window` property will automatically be initialized and attached to the scene.
// This delegate does not imply the connecting scene or session are new (see `application:configurationForConnectingSceneSession` instead).
guard let _ = (scene as? UIWindowScene) else { return }
}
func sceneDidDisconnect(_ scene: UIScene) {
// Called as the scene is being released by the system.
// This occurs shortly after the scene enters the background, or when its session is discarded.
// Release any resources associated with this scene that can be re-created the next time the scene connects.
// The scene may re-connect later, as its session was not necessarily discarded (see `application:didDiscardSceneSessions` instead).
}
func sceneDidBecomeActive(_ scene: UIScene) {
// Called when the scene has moved from an inactive state to an active state.
// Use this method to restart any tasks that were paused (or not yet started) when the scene was inactive.
}
func sceneWillResignActive(_ scene: UIScene) {
// Called when the scene will move from an active state to an inactive state.
// This may occur due to temporary interruptions (ex. an incoming phone call).
}
func sceneWillEnterForeground(_ scene: UIScene) {
// Called as the scene transitions from the background to the foreground.
// Use this method to undo the changes made on entering the background.
}
func sceneDidEnterBackground(_ scene: UIScene) {
// Called as the scene transitions from the foreground to the background.
// Use this method to save data, release shared resources, and store enough scene-specific state information
// to restore the scene back to its current state.
}
}
  1. Keep AppDelegate for APNs Callbacks

Copied!

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication,
didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
let token = deviceToken.map { String(format: "%02x", $0) }.joined()
print("APNs token: \(token)")
// Sync to Courier
}
}

Again, if you use CourierDelegate, this is done automatically for you.

SwiftUI Apps

SwiftUI already uses scenes. You just need to bridge an AppDelegate to keep receiving push callbacks.

Copied!

@main
struct MyApp: App {
@UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
...
}

5. When Enforcement Happens — iOS 26 vs iOS 27 Timeline

iOS 26 — Warning Stage
Your legacy app still launches but logs:

Copied!

This process does not adopt the UIScene lifecycle.
This will become an assert in a future version.

Push registration still works, but you’re officially on borrowed time.

iOS 27 — Enforcement Stage
When you build with the iOS 27 SDK, UIKit enforces the assert.
No scene manifest = immediate crash on launch — before AppDelegate methods fire.

Summary Table

iOS VersionBehaviorMigration Status
≤ 25Legacy AppDelegate lifecycle worksOptional
26Console warningStrongly recommended
27 SDKLaunch assert (crash)Required

Bottom line: migrate now, not when Xcode 17 flips the SDK default.


6. Final Checklist & Takeaways

Quick Checklist

  • Add SceneDelegate to your app (UIKit).
  • Keep your AppDelegate for APNs callbacks. (Or use CourierDelegate to automatically sync push notification tokens)
  • Register for remote notifications once your first scene connects. (CourierDelegate does this automatically)
  • Confirm there are no UIScene warnings in Xcode.
  • Test push delivery on a real device.

Key Takeaway
Supporting the UIScene lifecycle isn’t just future-proofing — it’s required for your app to launch and receive push notifications once you adopt the iOS 27 SDK.
Add scene support, validate token registration, and your Courier push pipeline will stay reliable for iOS 27, 28, and beyond.

Similar resources

state management
GuideEngineeringUser Experience

Cross-Channel Notification State: Why Read Receipts Are Harder Than They Look

When a user opens your email, does your app know? For most products, the answer is no. Each channel tracks its own state. Email has read receipts. Push has delivery confirmation. In-app has its own unread count. They don't talk to each other. Users notice. This guide covers the three approaches to notification state management (channel-first, central-first, event-first), when to use each, and how to implement cross-channel sync without overengineering. Includes state diagrams and practical implementation patterns.

By Kyle Seyler

February 03, 2026

Building Notification Infrastructure with Claude Code and Cursor
GuideEngineering

Terminal-First Development vs. IDE: Building Notification Infrastructure with Claude Code and Cursor

AI coding tools split into two camps: terminal agents (Claude Code) and IDE-augmented editors (Cursor). This guide compares both approaches using Courier's CLI and MCP server as the test case. Covers installation, configuration, and practical workflows for building multi-channel notifications. Includes code examples for user management, bulk operations, and automation triggers. Also explores agent-to-agent communication patterns where AI systems need notification infrastructure to coordinate tasks and escalate to humans.

By Kyle Seyler

January 29, 2026

notification platform for developers
EngineeringNotifications Landscape

The Notification Platform Developers Choose

Most notification platforms built dashboards first and added developer tools later. Courier did the opposite. With a CLI that handles real workflows, MCP integration with setup management, typed SDKs in seven languages, and SOC 2 Type 2 certification, Courier is built for teams that ship. This isn't marketing copy: Twilio chose Courier to unify notifications across their 10M+ developer platform. LaunchDarkly uses Courier to power feature release workflows. When the companies that build developer infrastructure choose your notification platform, that says something about the technical foundation.

By Kyle Seyler

January 26, 2026

Multichannel Notifications Platform for SaaS

Products

Platform

Integrations

Customers

Blog

API Status

Subprocessors


© 2026 Courier. All rights reserved.