Skip to content

[ios]update uiscene adoption#13560

Open
hellohuanlin wants to merge 6 commits into
flutter:mainfrom
hellohuanlin:update_uiscene_doc
Open

[ios]update uiscene adoption#13560
hellohuanlin wants to merge 6 commits into
flutter:mainfrom
hellohuanlin:update_uiscene_doc

Conversation

@hellohuanlin

@hellohuanlin hellohuanlin commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

This PR polishes UIScene adoption doc. Including:

  1. Add documentation for didFinishLaunching requirement
  2. Update multi-scene support
  3. Some smaller update such as removing performFetchWithCompletionHandler

Issues fixed by this PR (if any):

One of the issues fixed is:
Fixed flutter/flutter#186976

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

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).
  • This PR uses semantic line breaks
    of 80 characters or fewer.

@flutter-website-bot

flutter-website-bot commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit 95a5828):

https://flutter-docs-prod--docs-pr13560-update-uiscene-doc-e5et10kn.web.app

@flutter-website-bot

flutter-website-bot commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated flutter.dev site (updated for commit 95a5828):

https://flutter-dev-230821--www-pr13560-update-uiscene-doc-dd1n4tr6.web.app

@bjhardware2024-gif

This comment was marked as off-topic.

@hellohuanlin
hellohuanlin marked this pull request as ready for review July 14, 2026 21:26
@hellohuanlin
hellohuanlin requested review from a team and sfshaza2 as code owners July 14, 2026 21:26

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the documentation for UIScene adoption in Flutter iOS apps, clarifying that multiple scenes are not yet fully supported and adding guidance on registering background tasks before app launch finishes. The review feedback identifies a compilation error in the Swift code snippet due to a typo in a parameter name, as well as an inconsistency between the text explanation and the code comments regarding which AppDelegate launch method should be used.

Comment thread sites/docs/src/content/release/breaking-changes/uiscenedelegate.md Outdated
Comment thread sites/docs/src/content/release/breaking-changes/uiscenedelegate.md Outdated
@hellohuanlin
hellohuanlin requested a review from vashworth July 14, 2026 21:27
> and they’re ready to use before HealthKit delivers the updates.

For example, to support `BGTaskScheduler`:
<Tabs key="ios-language-switcher">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tabs do not show. Something must be wrong with the spacing or something.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Turns out that it needs an extra blank line

</Tab>
</Tabs>

1. Optional: Migrate other deprecated APIs to support

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you remove the optional from this? Let's encourage people to do it

Suggested change
1. Optional: Migrate other deprecated APIs to support
1. Migrate other deprecated APIs to support

Comment thread sites/docs/src/content/release/breaking-changes/uiscenedelegate.md Outdated
Comment thread sites/docs/src/content/release/breaking-changes/uiscenedelegate.md Outdated
Comment on lines 898 to 899

@vashworth vashworth Jul 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe change to

"Migrate other deprecated APIs to properly access the viewController, screen, or window."

@hellohuanlin

Copy link
Copy Markdown
Contributor Author

Hmmm It looks like I don't have merge permission.

@Sfshaza if you can help take a look too that'd be great! Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[UIScene] BGAppRefreshTask isn't "scene delegate equivalent" of performFetchWithCompletionHandler

4 participants