M49 iOS Device Validation

Status

Plan: M49_IOS_DEVICE_VALIDATION
Status: DEFERRED
Activated: 2026-09-06
Baseline: 1c2ed4a (M48_UI_LAYER_CLEANUP closure)
Owner request: make the current playable MVP installable on a real iPhone for visual and touch validation.
Deferred on 2026-09-06 by the owner while the responsive UI element slice is prioritized. M49-C remains uninstalled and can resume after M50 handoff.

Objective

Prepare a Godot iOS export path and an Xcode project that can be installed on the owner's device. This plan covers local debug/device validation only; it does not authorize TestFlight, App Store submission or release packaging.

Player-visible stopping point

The project has an iOS export preset with a unique owner-approved Bundle ID, Apple Team ID and landscape orientation.
Godot exports an Xcode project without changing gameplay, UI, Save/Receipt, content or static-master assets.
Xcode can build and install a debug app on the owner's connected iPhone after the owner trusts the developer certificate.
A short device checklist covers touch targets, safe area, rotation, text scale and the Market → Readiness → Battle Result loop.

Required owner inputs

Apple Developer Team ID (10-character value).
Desired unique Bundle ID, for example com.yourdomain.aetherboundguild.
iPhone connected to the Mac with Developer Mode enabled and the owner signed into Xcode, if automatic signing is selected.

Ordered steps

M49-A — Export contract and preflight (`COMPLETE`)

Freeze the local-device-only scope and required owner inputs.
Confirm macOS/Xcode/Godot prerequisites and absence of an existing iOS preset.

Closure: M49-A closes at source c6cd45b. macOS points to Xcode 26.1.1, Godot 4.6.1 is installed, and the local keychain contains a valid Apple Development identity for Team X75CUV458P plus an Xcode-managed wildcard development profile. No iOS preset existed at baseline.

M49-B — iOS export preset (`COMPLETE`)

Add the owner-provided Team ID, Bundle ID and landscape settings to the Godot iOS preset.
Keep generated Xcode output outside Git.

Closure: M49-B closes at the current source after the preset and project settings were verified. The preset exports a project-only Xcode project with automatic signing, arm64, iOS 14.0 and landscape-left/right orientation. The arm64 device configuration builds successfully with the local Apple Development identity. Details are recorded in docs/runtime/M49_IOS_EXPORT_PREFLIGHT.md.

M49-C — Local Xcode device install (`IN_PROGRESS`)

Export the Xcode project, open it in Xcode and build to the connected device.
Resolve only signing/device setup issues; do not upload or distribute.

Current state: the Xcode project and signed arm64 app build are ready, but the known iPhone entries are currently unavailable to devicectl. Installation and launch remain pending a connected, unlocked, trusted device with Developer Mode enabled.

M49-D — Device visual/touch handoff

Run the first-cycle checklist on device and record viewport/safe-area issues.
Update the checkpoint and hand off the repeatable install command.

Acceptance checks

iOS preset is present and has non-placeholder Team ID/Bundle ID values.
Xcode debug build installs and launches on the owner's device.
Landscape orientation, touch targets and the three representative UI pages are verified on device.
No TestFlight/App Store or release-ready claim is made.

Frozen scope

No gameplay, economy, content, routing, Save/Receipt or art changes.
No TestFlight upload, App Store record creation or distribution signing.
Keep generated Xcode projects, Archives and provisioning files outside Git.

Commit boundaries

M49-A: plan/checkpoint/ledger activation.
M49-B: iOS export preset.
M49-C: local Xcode install evidence.
M49-D: device handoff.

3.9 KiB Raw Blame History