Skip to content

Provide guided logs when app crashes due to UIScene on iOS 27 #187758

Description

@vashworth

Run flutter run on an app that hasn't migrated to UIScene using iOS 27 device. You'll get a log like this.

We should provided guided feedback and point to our docs to migrate.

2026-06-09 17:21:45.971278-0500 Flutter Gallery[1198:212480] failure in void _UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption(void)_block_invoke (UIApplication_RuntimeIssues.m:106) : Application failed to launch: UIScene life cycle is required for apps built with this SDK. See Technote TN3187 for more information on migration.
Process 1198 resuming
Process 1198 stopped
* thread #1, queue = 'com.apple.main-thread', stop reason = EXC_BREAKPOINT (code=1, subcode=0x18a7c1ce4)
       frame #0: 0x000000018a7c1ce4 UIKitCore`___UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption_block_invoke + 700
UIKitCore`___UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption_block_invoke:
->  0x18a7c1ce4 <+700>: brk    #0
    0x18a7c1ce8 <+704>: brk    #0x1

UIKitCore`_UIApplicationConfigurationRuntimeIssuesLog:
    0x18a7c1cec <+0>:   adrp   x8, 399471
    0x18a7c1cf0 <+4>:   ldr    x8, [x8, #0x1b0]
Target 0: (Flutter Gallery) stopped.

Activity

  1. added
    platform-iosiOS applications specifically
    toolAffects the "flutter" command-line tool. See also t: labels.
    t: xcode"xcodebuild" on iOS and general Xcode project management
    team-iosOwned by iOS platform team
    on Jun 9, 2026
  2. changed the title [-]Provide guided logs when app crashes due to UIScene[/-] [+]Provide guided logs when app crashes due to UIScene on iOS 27[/+] on Jun 9, 2026
  3. vashworth commented on Jun 9, 2026

    @vashworth
    ContributorAuthor

    Simulators crash instantly and don't provide logs from what I can tell

  4. added
    P1High-priority issues at the top of the work list
    triaged-iosTriaged by iOS platform team
    on Jun 11, 2026
  5. vashworth commented on Jun 26, 2026

    @vashworth
    ContributorAuthor

    For simulators:

    The predicate is going to need to be updated so that it does not exclude this log

    [        ] failure in void _UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption(void)_block_invoke (UIApplication_RuntimeIssues.m:106) : Application failed to launch: UIScene life cycle is required for apps built with this SDK. See Technote TN3187 for more information on migration.
    

    final String predicate = andP(<String>[
    'eventType = logEvent',
    if (appName != null) 'processImagePath ENDSWITH "$appName"',
    // Either from Flutter or Swift (maybe assertion or fatal error) or from the app itself.
    orP(<String>[
    'senderImagePath ENDSWITH "/Flutter"',
    'senderImagePath ENDSWITH "/libswiftCore.dylib"',
    'processImageUUID == senderImageUUID',
    'eventMessage CONTAINS "`UIScene` lifecycle will soon be required"',
    'eventMessage CONTAINS "This process does not adopt UIScene lifecycle."',
    ]),
    // Filter out some messages that clearly aren't related to Flutter.
    notP('eventMessage CONTAINS ": could not find icon for representation -> com.apple."'),
    notP('eventMessage BEGINSWITH "assertion failed: "'),
    notP('eventMessage CONTAINS " libxpc.dylib "'),
    ]);

  6. github-actions commented on Jul 14, 2026

    @github-actions

    This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

  7. locked as resolved and limited conversation to collaborators on Jul 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

P1High-priority issues at the top of the work listplatform-iosiOS applications specificallyt: xcode"xcodebuild" on iOS and general Xcode project managementteam-iosOwned by iOS platform teamtoolAffects the "flutter" command-line tool. See also t: labels.triaged-iosTriaged by iOS platform team

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions