(Draft) Update iOS snippets to reflect UISceneDelegate adoption by johnpryan · Pull Request #13305 · flutter/website

johnpryan · 2026-04-24T16:40:42Z

Description of what this PR is changing or adding, and why:

This updates iOS code snippets to conform to the UIScene lifecycle migration.

Update platform-channels.md to use didInitializeImplicitFlutterEngine.
Update platform-views.md to use didInitializeImplicitFlutterEngine and add protocol conformance.
Update add-flutter-screen.md to include configurationForConnecting in AppDelegate.

Issues fixed by this PR (if any):

Fixes #13087
Fixes #13086
Fixes #13274

PRs or commits this PR depends on (if any):

None.

Presubmit checklist

If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
[ x This PR uses semantic line breaks
of 80 characters or fewer.

flutter-website-bot · 2026-04-24T16:47:09Z

Visit the preview URL for this PR (updated for commit 2f577be):

https://flutter-docs-prod--pr13305-migrate-docs-to-uiscene-2pylkymb.web.app

sfshaza2

This looks great, @johnpryan! I know it's a draft, but I will approve. Let me know if it needs further attention.

gemini-code-assist

Code Review

This pull request updates iOS documentation to reflect UIScene support as the default and transitions platform integration examples to use didInitializeImplicitFlutterEngine:. Feedback includes correcting a version typo, updating documentation links to UISceneDelegate methods, adopting idiomatic Swift naming conventions, and fixing a missing header import in an Objective-C snippet.

gemini-code-assist · 2026-04-28T16:39:00Z

+As of Flutter 3.41, `UIScene` support is the default for iOS apps.
+When using `FlutterAppDelegate`, you should also ensure that your app
+uses `FlutterSceneDelegate` (or a subclass) to receive scene lifecycle
+events, such as [`openURL`][] and [`continueUserActivity`][].


The links for openURL and continueUserActivity point to UIApplicationDelegate methods. Since this section specifically discusses UIScene lifecycle events, it would be more accurate to link to the corresponding UISceneDelegate methods: scene(_:openURLContexts:) and scene(_:continue:).

Gemini is correct. The UIScene methods are:

https://developer.apple.com/documentation/uikit/uiscenedelegate/scene(_:continue:)
https://developer.apple.com/documentation/uikit/uiscenedelegate/scene(_:openurlcontexts:)

gemini-code-assist · 2026-04-28T16:39:01Z

@@ -163,7 +163,7 @@ Finally, register the platform view.
 This can be done in an app or a plugin.

 For app registration,
-modify the App's `AppDelegate.swift`:
+implement the `didInitializeImplicitFlutterEngine:` method in the App's `AppDelegate.swift`:


In the Swift section, it is more idiomatic to use Swift method naming conventions instead of the Objective-C selector style.

Suggested change

implement the `didInitializeImplicitFlutterEngine:` method in the App's `AppDelegate.swift`:

implement the `didInitializeImplicitFlutterEngine(_:)` method in the App's `AppDelegate.swift`:

gemini-code-assist · 2026-04-28T16:39:01Z

@@ -608,7 +608,7 @@ Add support for Swift in the standard template setup that uses Objective-C:
 1. Open the file `AppDelegate.swift` located under **Runner > Runner**
   in the Project navigator.

-Override the `application:didFinishLaunchingWithOptions:` function and create
+Implement the `didInitializeImplicitFlutterEngine:` method and create


In the Swift section, it is more idiomatic to use Swift method naming conventions instead of the Objective-C selector style.

Suggested change

Implement the `didInitializeImplicitFlutterEngine:` method and create

Implement the `didInitializeImplicitFlutterEngine(_:)` method and create

gemini-code-assist · 2026-04-28T16:39:01Z

 #import <Flutter/Flutter.h>
 #import "GeneratedPluginRegistrant.h"

+@interface AppDelegate () <FlutterImplicitEngineDelegate>
+@end


The Objective-C snippet for AppDelegate.m is missing the import for AppDelegate.h. This will cause a compilation error as the compiler won't recognize the AppDelegate class when declaring the category.

Suggested change

#import <Flutter/Flutter.h>

#import "GeneratedPluginRegistrant.h"

@interface AppDelegate () <FlutterImplicitEngineDelegate>

@end

#import "AppDelegate.h"

#import <Flutter/Flutter.h>

#import "GeneratedPluginRegistrant.h"

@interface AppDelegate () <FlutterImplicitEngineDelegate>

@end

vashworth · 2026-04-29T02:14:39Z

+    )
+    configuration.delegateClass = FlutterSceneDelegate.self
+    return configuration
+  }


Hmm, I'm not sure where this is from, but I don't think this is what we want to recommend.

Add-to-App users need to update their SceneDelegate (or create one and add to Info.plist if they don't already have one) to subclass the FlutterSceneDelegate and if they can't, then to use the FlutterSceneLifeCycleProvider

See UIScene docs:
https://docs.flutter.dev/release/breaking-changes/uiscenedelegate#migration-guide-for-adding-flutter-to-existing-app-add-to-app
https://docs.flutter.dev/release/breaking-changes/uiscenedelegate#migrate-info-plist
https://docs.flutter.dev/release/breaking-changes/uiscenedelegate#migrate-info-plist

vashworth · 2026-04-29T02:27:33Z

+As of Flutter 3.41, `UIScene` support is the default for iOS apps.
+When using `FlutterAppDelegate`, you should also ensure that your app
+uses `FlutterSceneDelegate` (or a subclass) to receive scene lifecycle
+events, such as [`openURL`][] and [`continueUserActivity`][].


Gemini is correct. The UIScene methods are:

https://developer.apple.com/documentation/uikit/uiscenedelegate/scene(_:continue:)
https://developer.apple.com/documentation/uikit/uiscenedelegate/scene(_:openurlcontexts:)

- Update platform-channels.md to use didInitializeImplicitFlutterEngine. - Update platform-views.md to use didInitializeImplicitFlutterEngine and add protocol conformance. - Update add-flutter-screen.md to include configurationForConnecting in AppDelegate. Fixes flutter#13087 Fixes flutter#13086 Fixes flutter#13274

parlough · 2026-05-18T18:20:15Z

/gemini review

gemini-code-assist

Code Review

This pull request updates the iOS documentation to reflect that UIScene support is now the default as of Flutter 3.41. The changes include adding UISceneConfiguration setup to AppDelegate examples and transitioning platform channel and platform view registration to the didInitializeImplicitFlutterEngine method. Review feedback focuses on correcting indentation in Swift code snippets and adopting Swift-idiomatic method signatures in the documentation text.

gemini-code-assist · 2026-05-18T18:22:10Z

+    let configuration = UISceneConfiguration(
+      name: nil,
+      sessionRole: connectingSceneSession.role
+    )
+    configuration.delegateClass = FlutterSceneDelegate.self
+    return configuration


The indentation of the method body is inconsistent with the rest of this Swift snippet. The previous method in this class uses a 4-space indent (6 spaces from the margin), while this new block uses a 2-space indent (4 spaces from the margin).

Suggested change

let configuration = UISceneConfiguration(

name: nil,

sessionRole: connectingSceneSession.role

)

configuration.delegateClass = FlutterSceneDelegate.self

return configuration

let configuration = UISceneConfiguration(

name: nil,

sessionRole: connectingSceneSession.role

)

configuration.delegateClass = FlutterSceneDelegate.self

return configuration;

gemini-code-assist · 2026-05-18T18:22:10Z


 For app registration,
-modify the App's `AppDelegate.swift`:
+implement the `didInitializeImplicitFlutterEngine:` method in the App's `AppDelegate.swift`:


For Swift, it is more idiomatic to refer to the method using the Swift signature didInitializeImplicitFlutterEngine(_:) rather than the Objective-C colon notation.

Suggested change

implement the `didInitializeImplicitFlutterEngine:` method in the App's `AppDelegate.swift`:

implement the `didInitializeImplicitFlutterEngine(_:)` method in the App's `AppDelegate.swift`:

gemini-code-assist · 2026-05-18T18:22:10Z

   in the Project navigator.

-Override the `application:didFinishLaunchingWithOptions:` function and create
+Implement the `didInitializeImplicitFlutterEngine:` method and create


For Swift, it is more idiomatic to refer to the method using the Swift signature didInitializeImplicitFlutterEngine(_:) rather than the Objective-C colon notation.

Suggested change

Implement the `didInitializeImplicitFlutterEngine:` method and create

Implement the `didInitializeImplicitFlutterEngine(_:)` method and create

sfshaza2 approved these changes Apr 28, 2026

View reviewed changes

johnpryan requested a review from vashworth April 28, 2026 16:02

johnpryan marked this pull request as ready for review April 28, 2026 16:36

johnpryan requested a review from a team as a code owner April 28, 2026 16:36

gemini-code-assist Bot reviewed Apr 28, 2026

View reviewed changes

vashworth reviewed Apr 29, 2026

View reviewed changes

johnpryan added 2 commits May 5, 2026 13:45

fix SceneDelegate example API methods

7bdc9a8

johnpryan force-pushed the migrate-docs-to-uiscene branch from f33ea89 to 7bdc9a8 Compare May 5, 2026 21:11

Merge branch 'main' into migrate-docs-to-uiscene

2f577be

parlough requested a review from vashworth May 18, 2026 18:20

gemini-code-assist Bot reviewed May 18, 2026

View reviewed changes

	implement the `didInitializeImplicitFlutterEngine:` method in the App's `AppDelegate.swift`:
	implement the `didInitializeImplicitFlutterEngine(_:)` method in the App's `AppDelegate.swift`:

Conversation

johnpryan commented Apr 24, 2026

Presubmit checklist

Uh oh!

flutter-website-bot commented Apr 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sfshaza2 left a comment

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

gemini-code-assist Bot Apr 28, 2026

Choose a reason for hiding this comment

Uh oh!

vashworth Apr 29, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

gemini-code-assist Bot Apr 28, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Apr 28, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot Apr 28, 2026

Choose a reason for hiding this comment

Uh oh!

vashworth Apr 29, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

vashworth Apr 29, 2026

Choose a reason for hiding this comment

Uh oh!

parlough commented May 18, 2026

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist Bot May 18, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot May 18, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist Bot May 18, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

flutter-website-bot commented Apr 24, 2026 •

edited

Loading