From c2b12b2568a6c51ce61610122f8025e4caf9f790 Mon Sep 17 00:00:00 2001 From: Kevin Lamenzo Date: Tue, 4 Aug 2026 03:49:41 +0000 Subject: [PATCH] docs: add UISceneDelegate migration warning to iOS platform views --- .../ios/platform-views.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/sites/docs/src/content/platform-integration/ios/platform-views.md b/sites/docs/src/content/platform-integration/ios/platform-views.md index 62e5a11017..922761fd00 100644 --- a/sites/docs/src/content/platform-integration/ios/platform-views.md +++ b/sites/docs/src/content/platform-integration/ios/platform-views.md @@ -224,6 +224,17 @@ struct MySwiftUIView: View { Finally, register the platform view. This can be done in an app or a plugin. +:::version-note +Starting from Flutter 3.41.0, +iOS apps use the `UIScene` lifecycle by default. +For apps using `UIScene`, +you must implement `FlutterImplicitEngineDelegate` +and register your platform views inside +`didInitializeImplicitFlutterEngine(_:)`. +For more information, +refer to the [UISceneDelegate adoption guide][]. +::: + For app registration, modify the App's `AppDelegate.swift`: @@ -347,6 +358,17 @@ and the platform view provides a reference to the Finally, register the platform view. This can be done in an app or a plugin. +:::version-note +Starting from Flutter 3.41.0, +iOS apps use the `UIScene` lifecycle by default. +For apps using `UIScene`, +you must implement `FlutterImplicitEngineDelegate` +and register your platform views inside +`didInitializeImplicitFlutterEngine:`. +For more information, +refer to the [UISceneDelegate adoption guide][]. +::: + For app registration, modify the App's `AppDelegate.m`: @@ -462,3 +484,4 @@ There are some limitations when composing iOS Platform Views. [`BackdropFilter`]: {{site.api}}/flutter/foundation/BackdropFilter.html [`defaultTargetPlatform`]: {{site.api}}/flutter/foundation/defaultTargetPlatform.html [design-doc]: {{site.main-url}}/go/ios-platformview-backdrop-filter-blur +[UISceneDelegate adoption guide]: /release/breaking-changes/uiscenedelegate