# iOS Release Checklist

## Support Matrix

- Minimum iOS: 17.0
- Swift package shell also builds on macOS 14 for local smoke coverage.
- Rust targets: iOS device and simulator targets still need TDLib validation.
- TDLib: `tdlib-rs` 1.2.0 with `download-tdlib`; iOS packaging is not validated yet.
- Bridge: UniFFI 0.31.1 generated Swift bindings.

## Required Before TestFlight

1. Install full Xcode, accept the license, and verify `scripts/check-ios-prereqs.sh`.
2. Build the fake-backed simulator shell with `scripts/build-ios-simulator-app.sh`.
3. Launch the fake-backed simulator shell with `scripts/run-ios-simulator-app.sh`.
4. Create the Xcode app project or wire the Swift package into an Xcode app target for signing/archive.
5. Add app icon, launch screen, bundle id, signing team, notification capability, and entitlements.
6. Build TDLib for simulator and device architectures.
7. Package Rust static libraries and generated UniFFI Swift/header/modulemap output into an XCFramework.
8. Run simulator smoke with fake bridge.
9. Run real-device smoke with real Telegram credentials.
10. Archive and upload to TestFlight.

## CI Gates

- `cargo fmt -- --check`
- `cargo check -p tele-core`
- `cargo clippy --workspace --all-targets --all-features -- -D warnings`
- `cargo test --workspace --all-features`
- `scripts/generate-ios-ffi-bindings.sh`
- `swiftc -typecheck` for generated Swift bindings
- `swift build --product TeleTuiIOSApp`
- `swift run TeleTuiIOSSmokeTests`
- `DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer scripts/build-ios-simulator-app.sh`
- `DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer scripts/smoke-ios-simulator-ui.sh`
- `DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer scripts/check-ios-tdlib-linking.sh` once TDLib iOS artifacts are available

`swift test` is not currently a CI gate on this host because the CLI Swift toolchain available to the package does not expose `XCTest` or `Testing`. The deterministic view-model coverage lives in the executable `TeleTuiIOSSmokeTests` target until an Xcode test target is introduced.

## Rollback

1. Disable the TestFlight build in App Store Connect.
2. Re-upload the previous known-good archive.
3. If the issue is TDLib/session related, revoke the affected build and keep existing accounts on the previous app version.
4. Preserve account Application Support directories; do not delete TDLib databases during rollback unless the issue is confirmed to be corrupted local state.