Repository navigation
research(ios): adopt the UIScene life cycle for iOS 27 SDK builds - #1265
Merged
Merged
Conversation
AnthonyRonning
force-pushed
the
research/ios-scene-lifecycle
branch
from
October 25, 2026 00:40
df76b74 to
7df88b2
Compare
AnthonyRonning
force-pushed
the
research/ios-scene-lifecycle
branch
from
October 29, 2026 03:12
7df88b2 to
ddd929b
Compare
AnthonyRonning
force-pushed
the
research/tauri-2.12
branch
from
October 29, 2026 03:12
95921de to
ca82731
Compare
AnthonyRonning
force-pushed
the
research/tauri-2.12
branch
from
October 29, 2026 18:31
ca82731 to
333ece2
Compare
AnthonyRonning
force-pushed
the
research/ios-scene-lifecycle
branch
from
October 29, 2026 18:31
ddd929b to
f15adfe
Compare
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>
AnthonyRonning
force-pushed
the
research/ios-scene-lifecycle
branch
from
October 30, 2026 04:56
f15adfe to
c03e9ad
Compare
Contributor
|
Maple development preview: https://3d0cdcb0.maple-ca8.pages.dev Commit: Uses development API, billing, flags and PCR configuration. Cloudflare Access applies. |
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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_BREAKPOINTin_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.plistaddsUIApplicationSceneManifestwith a single scene and tao'sTaoSceneDelegate. tauri-cli merges it into the generated iOS plist, so macOS's sharedInfo.pliststays untouched.UIApplicationSupportsMultipleScenesisfalse: tao 0.37 creates one WebView window, and an extra scene on iPad or the Duo's inner display would render black.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@_cdeclfunctions local visibility tauri-apps/tauri#16130).tauri-plugin-sign-in-with-apple1.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 theschema.jsonthat tauri-plugin 2.7 regenerates), then the one-word fix.Openedfor 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 reachestauri-plugin-deep-link. Backported onto 0.37.1; only the import context differs from upstreamdev.ios-pr.shandios-release.shfail when the built app'sInfo.plistdoesn't nameTaoSceneDelegateas its scene delegate (require_ios_scene_manifestin_common.sh). The release script checks the app before and after signing. If a tauri-cli change ever stops mergingInfo.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).test_ios_release_signing.pystubs it, like the other app checks.ci-okpasses in 7.5 min (run 40931638093). The iOS script changes selectresearch-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-offci:ioslabel provided the evidence (removed again). PR #1266 adds the iOS-only sources toresearch-ios's paths.plan.py lintand the CI script suite (542 tests) pass.cloud.opensecret.maple://…URL that cold-launches it reaches the deep-link plugin (getCurrent()returns it).deep-link-received.nullfor the cold-start URL, while the shipped, scene-less build received it.Still needs a real device: Sign in with Apple and StoreKit purchase/manage flows under the scene life cycle.
Notes
Merging
Merge after PR #1264 and before PR #1266, with a merge commit so the unmodified vendoring commit survives.
🤖 Generated with Claude Code