Skip to content

research(ios): adopt the UIScene life cycle for iOS 27 SDK builds - #1265

Merged
AnthonyRonning merged 6 commits into
masterfrom
research/ios-scene-lifecycle
Oct 30, 2026
Merged

AnthonyRonning merged 6 commits into
masterfrom
research/ios-scene-lifecycle

Conversation

@AnthonyRonning

@AnthonyRonning AnthonyRonning commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor

Why

Apps built with the iOS 27 SDK must adopt UIKit's scene-based life cycle, or UIKit aborts them at launch before any app code runs (EXC_BREAKPOINT in _UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption). Reproduced with today's Research build stamped as iOS 27.1 SDK on the iPhone Duo simulator. App Store Connect requires the iOS 27 SDK from April 2027, and the iPhone Duo only runs apps full screen when they are built with the iOS 27.1 SDK. So this has to land before the Xcode 27.1 bump in the next PR.

What

  • src-tauri/Info.ios.plist adds UIApplicationSceneManifest with a single scene and tao's TaoSceneDelegate. tauri-cli merges it into the generated iOS plist, so macOS's shared Info.plist stays untouched. UIApplicationSupportsMultipleScenes is false: tao 0.37 creates one WebView window, and an extra scene on iPad or the Duo's inner display would render black.
  • Swift plugin entry points become public, which Xcode 27 release builds need to link (Tauri 2.12.3 made the same change for its own Swift package, [bug] [ios] Release build fails to link on Xcode 27: SwiftPM's default build system gives non-public @_cdecl functions local visibility tauri-apps/tauri#16130).
    • The in-tree IAP plugin.
    • tauri-plugin-sign-in-with-apple 1.0.2, which has had no release since 2024. Three commits: the crates.io tarball unmodified (minus .cargo_vcs_info.json, its lockfile and generated output), the wiring that builds it in place (the [patch.crates-io] entry, ignore rules for build output, and the schema.json that tauri-plugin 2.7 regenerates), then the one-word fix.
  • The vendored tao carries fix(ios): emit Opened for URLs delivered on cold start tauri-apps/tao#1376. In the scene life cycle, a URL that cold-launches the app arrives in the scene connection options, which tao 0.37 ignores. Without it, an OAuth callback that relaunches Maple never reaches tauri-plugin-deep-link. Backported onto 0.37.1; only the import context differs from upstream dev.
  • Build check: ios-pr.sh and ios-release.sh fail when the built app's Info.plist doesn't name TaoSceneDelegate as its scene delegate (require_ios_scene_manifest in _common.sh). The release script checks the app before and after signing. If a tauri-cli change ever stops merging Info.ios.plist, CI fails instead of shipping an app that aborts at launch on the iOS 27 SDK.

Validation

Built with today's Xcode 26.5 pin through scripts/ci/ios-pr.sh. The bundle carries the merged manifest (UISceneDelegateClassName = TaoSceneDelegate).

  • Scene check: passes on the stack's debug app and fails on a copy with the manifest removed. test_ios_release_signing.py stubs it, like the other app checks.
  • CI: ci-ok passes in 7.5 min (run 40931638093). The iOS script changes select research-ios, which built the app with Xcode 26.5 and passed the scene check in 5.7 min. Before the scene check, none of this PR's files selected that lane, so a one-off ci:ios label provided the evidence (removed again). PR #1266 adds the iOS-only sources to research-ios's paths.
  • Locally: plan.py lint and the CI script suite (542 tests) pass.
  • iPhone 17 Pro on iOS 26.5, and iPhone Duo on iOS 27.1 (compatibility mode): the app launches.
    • A cloud.opensecret.maple://… URL that cold-launches it reaches the deep-link plugin (getCurrent() returns it).
    • A URL sent while it runs fires deep-link-received.
  • Before the tao backport: the same scene-mode build returned null for the cold-start URL, while the shipped, scene-less build received it.
  • Xcode 27.1 build of the full stack: the same checks pass on the Duo, iOS 26.5 and iOS 27.0. Details in PR #1266.

Still needs a real device: Sign in with Apple and StoreKit purchase/manage flows under the scene life cycle.

Notes

  • Rebased on master after the CI rewrite. The CI review added the scene check and split the plugin vendoring so the first commit matches the published crate.
  • iOS 26 SDK builds behave the same with the manifest (validated above), so this is safe on the current Xcode 26.5 CI.
  • The upstream deep-link fix is still an open PR. Drop the backport when Tauri ships a tao release that contains it.

Merging

Merge after PR #1264 and before PR #1266, with a merge commit so the unmodified vendoring commit survives.

🤖 Generated with Claude Code

@AnthonyRonning AnthonyRonning changed the title research/ios scene lifecycle research(ios): adopt the UIScene life cycle for iOS 27 SDK builds Oct 25, 2026
@AnthonyRonning
AnthonyRonning force-pushed the research/ios-scene-lifecycle branch from df76b74 to 7df88b2 Compare October 25, 2026 00:40
@AnthonyRonning AnthonyRonning added the ci:ios Run the iOS build on this PR label Oct 29, 2026
@AnthonyRonning
AnthonyRonning force-pushed the research/ios-scene-lifecycle branch from 7df88b2 to ddd929b Compare October 29, 2026 03:12
@AnthonyRonning AnthonyRonning removed the ci:ios Run the iOS build on this PR label Oct 29, 2026
@AnthonyRonning
AnthonyRonning force-pushed the research/ios-scene-lifecycle branch from ddd929b to f15adfe Compare October 29, 2026 18:31
@AnthonyRonning
AnthonyRonning removed this pull request from stack #1267 October 30, 2026 04:53
Base automatically changed from research/tauri-2.12 to master October 30, 2026 04:53
AnthonyRonning and others added 6 commits October 30, 2026 04:53
Apps built with the iOS 27 SDK must adopt the scene-based life cycle or
UIKit aborts at launch (_UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption).
tauri-cli merges src-tauri/Info.ios.plist into the generated iOS plist, so
the manifest stays out of the shared Info.plist that macOS also uses.

One scene only: tao 0.37 creates a single WebView window, and any extra
scene iPad or iPhone Duo opened would have no WebView and render black.
The delegate is tao's TaoSceneDelegate. iOS 26 SDK builds behave the same
with the manifest, so this lands before the Xcode 27.1 bump.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The crates.io release as published (sha256
e9402eb8a70fdff5127fccc1f1666ebb06b5efc10e0eb656d8a70c798e26142e), so the
next commits show Maple's changes as plain diffs. Left out:
.cargo_vcs_info.json, as for the vendored tao, plus the author's Gradle
cache (android/.gradle), the build-generated permissions/autogenerated and
the plugin's pnpm-lock.yaml, which this app's build never reads.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Point Cargo at the in-tree copy, and keep what building it writes out of git:
the plugin's .gitignore gains the iOS and Android build outputs, and
permissions/schemas/schema.json is the one tauri-plugin 2.7's build script
regenerates (descriptions in markdown), so builds leave the tree clean.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Xcode 27 release builds need @_cdecl plugin entry points to be public for
the Rust bindings to link; Tauri 2.12.3 did the same for its own Swift
package (tauri-apps/tauri#16130). Covers the in-tree IAP plugin and the
vendored Sign in with Apple plugin.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
With the scene life cycle, UIKit hands a launch URL to the connecting scene's
connection options and never calls scene:openURLContexts: for it. tao 0.37
ignores those options, so a deep link that starts Maple (for example an OAuth
callback after iOS killed the app) never reached tauri-plugin-deep-link.

Backports tauri-apps/tao#1376 onto the vendored tao 0.37.1 (only the import
context differs from upstream dev).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The launch-abort fix relies on tauri-cli merging Info.ios.plist into the
app at build time; the committed gen/apple Info.plist has no manifest, and
no CI job launches the app. A tauri-cli or config regression would ship an
iOS 27 SDK build that aborts in
_UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption with every
check green. ios-pr.sh checks the simulator app after the build, and
ios-release.sh both the archived and the exported app.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Maple development preview: https://3d0cdcb0.maple-ca8.pages.dev

Commit: c03e9adee0974ef8d5406ac70534cb2841cfdd36

Uses development API, billing, flags and PCR configuration. Cloudflare Access applies.

@AnthonyRonning
AnthonyRonning marked this pull request as ready for review October 30, 2026 05:03
@AnthonyRonning
AnthonyRonning merged commit c9cefbf into master Oct 30, 2026
25 checks passed
@AnthonyRonning
AnthonyRonning deleted the research/ios-scene-lifecycle branch October 30, 2026 05:03

This branch was successfully deployed

1 active deployment
pages-pr-1265 — c03e9ade Deployed Oct 30, 2026 by github-actions[bot]
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.

1 participant