gibandClaude Opus 5.5
27469dbc77
Automatic signing with an App Store Connect API key registers bundle IDs and profiles but cannot create or assign App Groups, so the archive failed. A keychain-access-groups entry needs no portal setup. The demo flag and last summary move into the same group; tests cover the round trip and the migration of a pre-complication token. Co-Authored-By: Claude Opus 5.5 <[email protected]>
93 lines
4.9 KiB
Markdown
93 lines
4.9 KiB
Markdown
# WristCode watch app
|
|
|
|
SwiftUI, watch only, Swift 6 with strict concurrency, and no dependencies. It talks to the gateway
|
|
over HTTPS + JSON as described in [docs/api.md](../docs/api.md); `WristCode/API/Models.swift`
|
|
mirrors [gateway/src/contract.ts](../gateway/src/contract.ts).
|
|
|
|
## Build and test
|
|
|
|
```sh
|
|
cd watch
|
|
xcodegen generate # the .xcodeproj is generated and gitignored
|
|
xcodebuild -scheme WristCode -destination 'platform=watchOS Simulator,name=Apple Watch Series 12 (46mm)' build
|
|
xcodebuild -scheme WristCode -destination 'platform=watchOS Simulator,name=Apple Watch Series 12 (46mm)' test
|
|
```
|
|
|
|
## TestFlight
|
|
|
|
The App Store only takes a watch-only app inside an empty iOS stub, so `project.yml` has two app
|
|
targets, the same pair Xcode's "Watch-only App" template makes:
|
|
|
|
| Target | Bundle ID | Job |
|
|
| --- | --- | --- |
|
|
| `WristCodeContainer` | `org.gbrown.wristcode` | iOS stub that owns the App Store Connect record and embeds the watch app |
|
|
| `WristCode` | `org.gbrown.wristcode.watchkitapp` | The watch app, and the APNs topic |
|
|
| `WristCodeWidget` | `org.gbrown.wristcode.watchkitapp.widget` | The complication, embedded in the watch app |
|
|
|
|
```sh
|
|
scripts/testflight.sh # archive, export and upload to App Store Connect
|
|
scripts/testflight.sh --no-upload # archive and export an .ipa to build/export-<n> only
|
|
```
|
|
|
|
The build number defaults to a `YYYYMMDDHHMM` timestamp (override it with `BUILD_NUMBER`). Signing is
|
|
automatic through the App Store Connect API key in `ASC_KEY_PATH`, `ASC_KEY_ID` and `ASC_ISSUER_ID`,
|
|
which default to the key in `~/.appstoreconnect/private_keys`. The entitlements file says
|
|
`aps-environment: development`; the App Store export re-signs it as `production`. Release builds
|
|
register their token with the gateway as `production`, Debug builds as `sandbox`.
|
|
|
|
## Demo mode
|
|
|
|
`DemoGateway` serves fixture data shaped like the docs/api.md examples, and it reacts to writes:
|
|
Allow moves a thread to working, a reply restarts a finished thread. The SwiftUI previews use it,
|
|
the pairing screen has a "Try the demo" button, and launch arguments open a screen directly:
|
|
|
|
```sh
|
|
xcrun simctl launch <udid> org.gbrown.wristcode.watchkitapp -demo # feed
|
|
xcrun simctl launch <udid> org.gbrown.wristcode.watchkitapp -demo -thread littleman/t-next # thread
|
|
xcrun simctl launch <udid> org.gbrown.wristcode.watchkitapp -demo -screen new # new thread
|
|
```
|
|
|
|
`screenshots/` holds the screens captured this way. The complication and the multi-select question
|
|
are rendered by `SnapshotTests` instead, which only run when given a directory:
|
|
|
|
```sh
|
|
TEST_RUNNER_WC_SCREENSHOT_DIR=$PWD/screenshots xcodebuild -scheme WristCode \
|
|
-destination 'platform=watchOS Simulator,name=Apple Watch Series 12 (46mm)' test \
|
|
-only-testing:WristCodeTests/SnapshotTests
|
|
```
|
|
|
|
In demo mode the complication shows the demo counts too.
|
|
|
|
## Complication
|
|
|
|
`WristCodeWidget` shows how many threads wait on you, from `GET /v1/summary`, in the circular,
|
|
rectangular, inline and corner families. Tapping it opens the app, at the longest-waiting thread when
|
|
there is one (`wristcode://thread/<hostId>/<threadId>`). WidgetKit refreshes it about every 15 minutes;
|
|
the app reloads it sooner when its feed counts change, when a push arrives in the foreground, and
|
|
after a notification action.
|
|
|
|
The app and the extension share the Keychain access group `<team>.org.gbrown.wristcode.shared`, which
|
|
holds the device token, gateway URL, demo flag and last summary. It is not an App Group because
|
|
automatic signing with an App Store Connect API key can register bundle IDs and profiles but cannot
|
|
create or assign App Groups; a Keychain group needs no portal setup. Builds before the complication
|
|
kept the token in the app's own Keychain group; `DeviceStore.migrateToSharedGroup()` moves it on
|
|
launch, so a paired watch stays paired.
|
|
|
|
To add it: long-press the watch face, Edit, swipe to Complications, pick a slot, then WristCode.
|
|
|
|
## Layout
|
|
|
|
| Path | Job |
|
|
| --- | --- |
|
|
| `WristCodeApp.swift` | App entry, root navigation, `WKApplicationDelegate` for APNs registration |
|
|
| `AppModel.swift` | Paired, demo or unpaired; navigation path; the feed; 401 sends you back to pairing |
|
|
| `API/GatewayClient.swift` | `GatewayAPI` protocol and the URLSession client |
|
|
| `API/Models.swift` | Codable mirror of the contract |
|
|
| `API/Route.swift` | Screens the app can open, and their `wristcode://` URLs |
|
|
| `Auth/DeviceStore.swift` | Device token and gateway URL in the shared Keychain group |
|
|
| `Shared/SharedState.swift` | Demo flag and last summary in the shared Keychain group, for the complication |
|
|
| `Demo/DemoGateway.swift` | In-memory gateway with fixtures |
|
|
| `Views/` | Pair, Feed, Thread, New thread, and the mock B theme |
|
|
| `Notifications/NotificationHandler.swift` | Categories `approval`, `finished`, `failed`, `input`, `host` and their actions |
|
|
| `../WristCodeWidget/` | The complication: timeline provider, and one view per family |
|