SPB Git

Repository Public License

testflight.md 4.6 KB 89 lines markdown

1<!--2ORIX Audio3File: docs/release/testflight.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->78# TestFlight Procedure910This describes how a build is produced and sent. **It is a procedure, not a record**: whether an archive, validation or upload has happened, and with what result, is stated only in `RELEASE-REPORT.md`.1112## Preconditions13141. All three test suites pass (`Scripts/test.sh core`, `app`, `ui`).152. `Scripts/l10n.py --check` reports no untranslated string.163. The quality gates in [checklist.md](checklist.md) are reviewed, and every unmet gate is written down.174. The developer account has been checked (team, agreements, certificates, the bundle identifier and its capabilities) — see `docs/release/apple-developer-verification.md`.185. An App Store Connect record exists for `ai.spboucher.orix.audio`.196. **The owner has explicitly authorised the upload.** An upload is outward-facing and is never done on assumption.2021> **Status, 2026-11-20.** The owner authorised the first upload: build 1.0.0 (1) was validated, uploaded and processed (`VALID`), and is in internal testing (group "Test"). It was uploaded before any device test, on the owner's decision; installing it from TestFlight is how that test gets done. External testing and App Review were not requested.2223## Identifiers and capabilities2425| Item | Value |26|---|---|27| Team | `3YM54G49SN` |28| App | `ai.spboucher.orix.audio` |29| Extension | `ai.spboucher.orix.audio.widgets` |30| Background mode | `audio` (an Info.plist key, not an entitlement) |31| Live Activities | `NSSupportsLiveActivities` in Info.plist; no push capability is used |32| Entitlements requiring approval | none |3334Automatic signing with `-allowProvisioningUpdates` registers the two identifiers and creates the profiles when an App Store Connect API key with sufficient rights is supplied.3536## Build number3738`MARKETING_VERSION` and `CURRENT_PROJECT_VERSION` are set in `project.yml`. App Store Connect rejects a build number it has already seen for a version: increase `CURRENT_PROJECT_VERSION` before every upload, and keep the extension's version in step (it uses the same settings).3940## Steps4142```bash43xcodegen generate4445# 1. Archive (Release, generic iOS device)46xcodebuild archive -project ORIXAudio.xcodeproj -scheme ORIXAudio -configuration Release \47  -destination "generic/platform=iOS" -archivePath build/ORIXAudio.xcarchive \48  -allowProvisioningUpdates \49  -authenticationKeyPath "$ASC_KEY_PATH" -authenticationKeyID "$ASC_KEY_ID" -authenticationKeyIssuerID "$ASC_ISSUER_ID"5051# 2. Export a distribution-signed IPA. The options plist (method app-store-connect, automatic signing, team 3YM54G49SN)52#    is written by the release step; it is not assumed to exist in the repository.53xcodebuild -exportArchive -archivePath build/ORIXAudio.xcarchive -exportOptionsPlist Scripts/ExportOptions.plist \54  -exportPath dist -allowProvisioningUpdates \55  -authenticationKeyPath "$ASC_KEY_PATH" -authenticationKeyID "$ASC_KEY_ID" -authenticationKeyIssuerID "$ASC_ISSUER_ID"5657# 3. Validate — uploads nothing58xcrun altool --validate-app -f dist/*.ipa -t ios --apiKey "$ASC_KEY_ID" --apiIssuer "$ASC_ISSUER_ID"5960# 4. Upload — only after the owner's authorisation61xcrun altool --upload-app -f dist/*.ipa -t ios --apiKey "$ASC_KEY_ID" --apiIssuer "$ASC_ISSUER_ID"62```6364The API key identifiers and path come from the environment or a file outside the repository. `.gitignore` excludes `*.p8`, certificates, profiles and environment files.6566## What to check in the archive6768- `CFBundleShortVersionString` and `CFBundleVersion` are the intended ones, in the app and in the extension.69- The Release build contains no debug hooks: `DebugHooks.swift` and the file-input path are compiled only with the `DEBUG` condition.70- `UIBackgroundModes` contains `audio`; the three usage descriptions are present; `ITSAppUsesNonExemptEncryption` is `false`.71- `PrivacyInfo.xcprivacy` is in the bundle.72- The icon set contains the default, dark and tinted variants.7374## After an upload7576Statuses mean different things and are reported separately:7778| Status | Meaning |79|---|---|80| Uploaded | the tool accepted the file |81| Processing | App Store Connect is processing the build |82| Processed / Valid | the build can be assigned to testers |83| Available to internal testers | assigned to an internal group; no review needed |84| Available to external testers | after Beta App Review approves the build |8586Export compliance is answered by the Info.plist key. External testing needs the beta description, feedback e-mail and "What to Test" text from [app-store.md](app-store.md).8788Public release on the App Store is a separate decision and needs separate authorisation.89
Files main
Menu

Theme