Repository Public
1<!--2SP Notes iOS3File: docs/DISTRIBUTION.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Distribution89## What exists on this Mac (inspected 2026-11-18, no secret displayed)1011| Item | Value |12|---|---|13| Xcode | 27.2 (27B52), iOS SDK 27.2, simulators iOS 26.5 |14| Team | `3YM54G49SN` |15| Keychain identities | Apple Development (×2); Developer ID Application (macOS only — **not used here**); Apple Distribution managed by Xcode (automatic signing) |16| App Store Connect API key | `~/.appstoreconnect/private_keys/AuthKey_L379BDKR69.p8` (reused, never copied into the repository) |17| App identifiers (created 2026-11-18 through the API) | `ai.spboucher.spnotes.ios` (Associated Domains, App Groups), `…ios.widgets` (App Groups), `…ios.share` (App Groups) |18| App Group | `group.ai.spboucher.spnotes.ios` (shared database, attachments, share hand-off) |19| Associated domain | `webcredentials:note.spboucher.ai`; the server's association file lists the app (in production since 2026-11-18, served by Apple's CDN) |20| App Store Connect record | **SP Notes**, app `6836504456`, SKU `spnotes-ios-001`, primary language fr-CA (created through the owner's Safari session: the public API cannot create an app record) |21| Notarisation | does not apply to an App Store / TestFlight distribution of an iOS app |2223## Signing particularity2425App Groups cannot be provisioned with an App Store Connect API key (the provisioning service answers "Authentication failed"). The26**archive** is therefore signed with the Apple ID account configured in Xcode (`-allowProvisioningUpdates` alone); the API key is used27for the export and the upload. `Scripts/release.sh` does this.2829## Commands3031 Scripts/build.sh generate | debug | release | test | uitest | core32 Scripts/test-live.sh # offline scenario against the development server (never production)33 Scripts/release.sh archive | export | upload | all3435For a new version: increment `CURRENT_PROJECT_VERSION` (and `MARKETING_VERSION` when needed) in `project.yml`, run the tests, then36`Scripts/release.sh all && Scripts/release.sh upload`.3738## Before an App Store submission (not done; TestFlight internal testing needs none of this)3940Screenshots (the UI tests produce them in `build/shots*`), description, keywords, support and privacy-policy URLs, the privacy41questionnaire (consistent with `PrivacyInfo.xcprivacy`: user content, photos — linked to the account, for app functionality, no42tracking), age rating, and a demonstration account for review (the service has a single owner: without a test account Apple's review43cannot sign in).4445## Done on 2026-11-1846471. App Store Connect record created: **SP Notes**, app `6836504456`.482. Release archive 1.0.0 (1), IPA exported (`dist/export/SP Notes.ipa`, 13 MB), signature verified (`codesign --verify --deep --strict`, Apple Distribution).493. Upload accepted (Delivery UUID `aef1245f-7ffe-4912-9cd6-fd45a47d5b35`); build processed: `VALID`, internal state `IN_BETA_TESTING`.504. Internal TestFlight group « Test » (access to all builds), the account holder invited.51