killingdruid/telegram-tui
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add iOS simulator launch scripts

Browse Source
This commit is contained in:
Mikhail Kilin
2026-05-20 22:26:53 +03:00
parent 6576a37198
commit 10f4c3a84b
7 changed files with 160 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
apps/ios/TeleTuiIOS/README.md
View File

@@ -15,15 +15,20 @@ cd apps/ios/TeleTuiIOS
swift run TeleTuiIOSSmokeTests
```
Simulator/device build is currently blocked until the Xcode license is accepted.
Xcode is installed at `/Applications/Xcode.app`, and `DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild -version` reports Xcode 26.5, but `xcrun simctl` fails with:
```text
You have not agreed to the Xcode license agreements. Please run 'sudo xcodebuild -license' from within a Terminal window to review and agree to the Xcode and Apple SDKs license.
```
After accepting the license, verify local iOS tooling with:
Verify local iOS tooling:
```bash
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer scripts/check-ios-prereqs.sh
```
Build the SwiftUI shell for iOS Simulator and package it as an installable `.app`:
```bash
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer scripts/build-ios-simulator-app.sh
```
Launch the fake-backed app in the first available iPhone simulator:
```bash
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer scripts/run-ios-simulator-app.sh
```

7
crates/tele-ios-ffi/README.md
View File

@@ -18,9 +18,8 @@ The script builds `target/release/libtele_ios_ffi.a` and writes Swift sources,
headers, a Swift typecheck-friendly `tele_ios_ffiFFI` module map, and an
XCFramework-compatible module map under `build/ios-ffi/`.
Known blocker:
Current linking status:
- Xcode is installed at `/Applications/Xcode.app`, and `DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild -version` reports Xcode 26.5.
- `xcrun simctl` currently fails because the Xcode license has not been accepted:
`You have not agreed to the Xcode license agreements. Please run 'sudo xcodebuild -license' from within a Terminal window to review and agree to the Xcode and Apple SDKs license.`
- Real TDLib iOS simulator/device linking therefore is not validated yet.
- The iOS 26.5 simulator runtime is installed and `scripts/check-ios-prereqs.sh` passes with available iPhone/iPad simulators.
- The current app shell uses the fake Swift bridge. Real TDLib iOS simulator/device linking is still pending until TDLib is built for `iphonesimulator` and `iphoneos` and wired into the UniFFI target.

11
docs/ios/hardening.md
View File

@@ -1,11 +1,12 @@
# iOS Hardening Notes
Phase 6 real-device validation is blocked on this machine until the Xcode license is accepted.
The local Xcode prerequisite gate now passes with Xcode 26.5 and the iOS 26.5 simulator runtime.
Current local blocker:
Validated commands:
```text
You have not agreed to the Xcode license agreements. Please run 'sudo xcodebuild -license' from within a Terminal window to review and agree to the Xcode and Apple SDKs license.
```bash
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer scripts/check-ios-prereqs.sh
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild -scheme TeleTuiIOSApp -destination 'generic/platform=iOS Simulator' build
```
Implemented hardening hooks:
@@ -14,7 +15,7 @@ Implemented hardening hooks:
- Account switches increment a session generation counter.
- Events are accepted only when both account id and generation match the active session, preventing stale events from a previous account from reaching view models.
Manual smoke still required after Xcode/TDLib device setup:
Manual smoke still required after real TDLib device setup:
1. Auth with real Telegram credentials.
2. Load chats, open multiple chats, send/edit/delete/reply/forward/react.

17
docs/ios/release-checklist.md
View File

@@ -11,13 +11,15 @@
## Required Before TestFlight
1. Install full Xcode, accept the license, and verify `scripts/check-ios-prereqs.sh`.
2. Create the Xcode app project or wire the Swift package into an Xcode app target.
3. Add app icon, launch screen, bundle id, signing team, notification capability, and entitlements.
4. Build TDLib for simulator and device architectures.
5. Package Rust static libraries and generated UniFFI Swift/header/modulemap output into an XCFramework.
6. Run simulator smoke with fake bridge.
7. Run real-device smoke with real Telegram credentials.
8. Archive and upload to TestFlight.
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
@@ -29,6 +31,7 @@
- `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`
## Rollback

87
scripts/build-ios-simulator-app.sh Executable file
View File

@@ -0,0 +1,87 @@
#!/usr/bin/env bash
set -euo pipefail
repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
package_dir="${repo_root}/apps/ios/TeleTuiIOS"
if [[ -z "${DEVELOPER_DIR:-}" && -d /Applications/Xcode.app/Contents/Developer ]]; then
export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
fi
configuration="${IOS_CONFIGURATION:-Debug}"
derived_data="${IOS_DERIVED_DATA:-/private/tmp/tele-tui-ios-derived-data}"
destination="${IOS_DESTINATION:-generic/platform=iOS Simulator}"
bundle_id="${IOS_BUNDLE_ID:-dev.teletui.TeleTuiIOSApp}"
pushd "${package_dir}" >/dev/null
xcodebuild \
-scheme TeleTuiIOSApp \
-destination "${destination}" \
-configuration "${configuration}" \
-derivedDataPath "${derived_data}" \
build
popd >/dev/null
product_dir="${derived_data}/Build/Products/${configuration}-iphonesimulator"
binary_path="${product_dir}/TeleTuiIOSApp"
app_path="${product_dir}/TeleTuiIOSApp.app"
if [[ ! -x "${binary_path}" ]]; then
printf 'Expected simulator executable was not produced: %s\n' "${binary_path}" >&2
exit 1
fi
rm -rf "${app_path}"
mkdir -p "${app_path}"
cp "${binary_path}" "${app_path}/TeleTuiIOSApp"
cp "${package_dir}/Resources/PrivacyInfo.xcprivacy" "${app_path}/PrivacyInfo.xcprivacy"
printf 'APPL????' > "${app_path}/PkgInfo"
cat > "${app_path}/Info.plist" <<PLIST
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleDisplayName</key>
<string>TeleTui</string>
<key>CFBundleExecutable</key>
<string>TeleTuiIOSApp</string>
<key>CFBundleIdentifier</key>
<string>${bundle_id}</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>TeleTuiIOSApp</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>0.1.0</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>LSRequiresIPhoneOS</key>
<true/>
<key>UIApplicationSupportsIndirectInputEvents</key>
<true/>
<key>UILaunchScreen</key>
<dict/>
<key>UIDeviceFamily</key>
<array>
<integer>1</integer>
<integer>2</integer>
</array>
<key>UISupportedInterfaceOrientations</key>
<array>
<string>UIInterfaceOrientationPortrait</string>
<string>UIInterfaceOrientationLandscapeLeft</string>
<string>UIInterfaceOrientationLandscapeRight</string>
</array>
</dict>
</plist>
PLIST
codesign --force --sign - --timestamp=none "${app_path}/TeleTuiIOSApp" >/dev/null
codesign --force --sign - --timestamp=none "${app_path}" >/dev/null
printf 'Packaged simulator app: %s\n' "${app_path}"

6
scripts/check-ios-prereqs.sh
View File

@@ -10,4 +10,10 @@ xcodebuild -version
xcrun simctl list devices available
swift --version
if ! xcrun simctl list devices available | grep -Eq 'iPhone|iPad'; then
printf 'No available iOS simulator devices found. Install the iOS platform from Xcode Settings > Components or run:\n' >&2
printf ' DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild -downloadPlatform iOS\n' >&2
exit 1
fi
printf 'iOS prerequisites are available.\n'

35
scripts/run-ios-simulator-app.sh Executable file
View File

@@ -0,0 +1,35 @@
#!/usr/bin/env bash
set -euo pipefail
repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
if [[ -z "${DEVELOPER_DIR:-}" && -d /Applications/Xcode.app/Contents/Developer ]]; then
export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
fi
configuration="${IOS_CONFIGURATION:-Debug}"
derived_data="${IOS_DERIVED_DATA:-/private/tmp/tele-tui-ios-derived-data}"
bundle_id="${IOS_BUNDLE_ID:-dev.teletui.TeleTuiIOSApp}"
app_path="${derived_data}/Build/Products/${configuration}-iphonesimulator/TeleTuiIOSApp.app"
"${repo_root}/scripts/build-ios-simulator-app.sh"
simulator_udid="${IOS_SIMULATOR_UDID:-}"
if [[ -z "${simulator_udid}" ]]; then
simulator_udid="$(xcrun simctl list devices available | awk -F '[()]' '/iPhone/ { print $2; exit }')"
fi
if [[ -z "${simulator_udid}" ]]; then
printf 'No available iPhone simulator found. Run scripts/check-ios-prereqs.sh for details.\n' >&2
exit 1
fi
if ! xcrun simctl list devices "${simulator_udid}" | grep -q 'Booted'; then
xcrun simctl boot "${simulator_udid}"
fi
xcrun simctl bootstatus "${simulator_udid}" -b
xcrun simctl install "${simulator_udid}" "${app_path}"
xcrun simctl launch "${simulator_udid}" "${bundle_id}"
printf 'Launched %s on simulator %s.\n' "${bundle_id}" "${simulator_udid}"