eminuxandCursor
adceb8f13f
Checklist operativa con file, chiavi stringa e bump versione per allineare l’app iOS alla release Android 2.0.3. Co-authored-by: Cursor <cursoragent@cursor.com>
185 lines
7.6 KiB
Markdown
185 lines
7.6 KiB
Markdown
# Gap Android → iOS: allineamento app nativa
|
||
|
||
Documento operativo per continuare su **Mac** lo sviluppo iOS e rilasciare un’app allineata a quanto già fatto (e rilasciato) su Android.
|
||
|
||
**Data:** 24 luglio 2026
|
||
**Riferimento Android rilasciato:** `2.0.3-native` (`versionCode` 24), API `https://www.matchlivetv.it`
|
||
**Stato iOS attuale:** marketing `2.0.0`, build `21` — i18n solo parziale
|
||
|
||
---
|
||
|
||
## Contesto
|
||
|
||
Dopo il rilascio web i18n (IT/EN/FR/DE/ES) e dell’APK Android di produzione, l’app Android ha:
|
||
|
||
- selettore lingua persistito
|
||
- Login + hub Partite localizzati in 5 lingue
|
||
- bump versione 2.0.3 / 24
|
||
|
||
Su iOS l’infrastruttura lingua esiste (`AppLanguage` + picker), ma **Matches e slogan restano in italiano** e la versione è indietro.
|
||
|
||
API produzione: entrambe le app puntano già a `https://www.matchlivetv.it` di default — **nessun gap di endpoint**.
|
||
|
||
---
|
||
|
||
## Stato a confronto
|
||
|
||
| Area | Android | iOS |
|
||
|------|---------|-----|
|
||
| Persistenza lingua | SharedPreferences `mltv_locale` + `AppLocale.wrap` + recreate | UserDefaults `mltv.appLanguage` + notification |
|
||
| Picker lingua | `LanguagePickerDialog` su Login + Matches | `LanguagePickerView` su Login + Matches |
|
||
| Login localizzato | Sì (5 lingue) | Sì (5 lingue via `L10n`) |
|
||
| Hub Partite localizzato | Sì (~20 stringhe hub) | **No** — testi IT hardcoded |
|
||
| Slogan wordmark | `R.string.app_slogan` | Chiave `app.slogan` in `L10n` **non usata** |
|
||
| Catalogo stringhe | `res/values*` (47 chiavi × 5) | Dizionario in `AppLanguage.swift` (~14 chiavi) |
|
||
| Logout UI | Icona | Testo «Esci» |
|
||
| Versione | `2.0.3-native` / 24 | `2.0.0` / 21 |
|
||
| RTMP ingest rewrite | `RtmpIngestUrl.kt` + test | `MediaUrl.swift` (ok in prod; semantica dev leggermente diversa) |
|
||
| Wizard / Broadcast | Ancora IT hardcoded | Ancora IT hardcoded (stesso debito) |
|
||
|
||
---
|
||
|
||
## File di riferimento
|
||
|
||
### Android (sorgente “già fatto”)
|
||
|
||
| Ruolo | Path |
|
||
|-------|------|
|
||
| Locale | `native/android/app/src/main/kotlin/.../core/AppLocale.kt` |
|
||
| Picker | `native/android/app/src/main/kotlin/.../ui/components/LanguagePickerDialog.kt` |
|
||
| Activity | `native/android/app/src/main/kotlin/.../MainActivity.kt` |
|
||
| Stringhe IT | `native/android/app/src/main/res/values/strings.xml` |
|
||
| Stringhe EN/FR/DE/ES | `native/android/app/src/main/res/values-{en,fr,de,es}/strings.xml` |
|
||
| Hub | `.../ui/matches/MatchesScreen.kt`, `MatchSheets.kt` |
|
||
| Login | `.../ui/login/LoginScreen.kt` |
|
||
| Versione | `native/android/app/build.gradle.kts` |
|
||
|
||
### iOS (da aggiornare)
|
||
|
||
| Ruolo | Path |
|
||
|-------|------|
|
||
| Lingua + L10n | `native/ios/MatchLiveTv/Core/AppLanguage.swift` |
|
||
| Login | `native/ios/MatchLiveTv/UI/Login/LoginScreen.swift` |
|
||
| Hub | `native/ios/MatchLiveTv/UI/Matches/MatchesScreen.swift` |
|
||
| Wordmark | `native/ios/MatchLiveTv/UI/Components/MatchLiveWordmark.swift` (verificare path esatto) |
|
||
| Versioni | `native/ios/generate_xcodeproj.py`, `MatchLiveTv.xcodeproj/project.pbxproj`, `Info.plist` |
|
||
| Build release | `scripts/build_ios_release.sh` |
|
||
| README | `native/ios/README.md` |
|
||
|
||
---
|
||
|
||
## Checklist allineamento iOS (ordine consigliato)
|
||
|
||
### 1. Completare stringhe hub (priorità alta)
|
||
|
||
In `AppLanguage.swift` (`L10n.table`), aggiungere chiavi allineate ad Android per **it/en/fr/de/es**. Mapping suggerito:
|
||
|
||
| Chiave iOS (`L10n`) | Android `strings.xml` | Note |
|
||
|---------------------|----------------------|------|
|
||
| `matches.hello` | `matches_hello` | formato `"Ciao, %@"` / `"Hi, %@"` |
|
||
| `matches.subtitle` | `matches_subtitle` | |
|
||
| `matches.schedule` | `matches_schedule` | |
|
||
| `matches.new` | `matches_new` | |
|
||
| `matches.empty_title` | `matches_empty_title` | |
|
||
| `matches.scheduled_title` | `matches_scheduled_title` | |
|
||
| `matches.ready_title` | `matches_ready_title` | |
|
||
| `matches.empty_hint` | `matches_empty_hint` | |
|
||
| `matches.active_team` | `matches_active_team` | `%@` |
|
||
| `matches.multi_team_hint` | `matches_multi_team_hint` | |
|
||
| `matches.no_other` | `matches_no_other` | |
|
||
| `matches.retry` | `matches_retry` | |
|
||
| `matches.load_error` | `matches_load_error` | |
|
||
| `matches.no_team_title` | `matches_no_team_title` | |
|
||
| `matches.no_team_body` | `matches_no_team_body` | |
|
||
| `matches.tap_change_team` | `matches_tap_change_team` | |
|
||
| `matches.team_for_live` | `matches_team_for_live` | |
|
||
| `matches.change` | `matches_change` | |
|
||
| `action.save` | `action_save` | se usato in sheet |
|
||
| `language.*` | già presenti | |
|
||
|
||
Copiare le traduzioni da `values-en|fr|de|es/strings.xml` (testo già validato su Android).
|
||
|
||
Poi in `MatchesScreen.swift`:
|
||
|
||
- sostituire ogni `Text("…")` / titolo sezione / empty state / alert con `L10n.t(...)`
|
||
- empty “nessuna squadra” → `matches.no_team_title` / `matches.no_team_body`
|
||
- assicurarsi che `.id(languageTick)` (o equivalente) ricarichi l’hub al cambio lingua
|
||
|
||
### 2. Slogan wordmark (priorità alta)
|
||
|
||
In `MatchLiveWordmark` (o componente equivalente):
|
||
|
||
- usare `L10n.t("app.slogan")` al posto della stringa italiana fissa
|
||
- verificare sul Login in EN/FR/DE/ES
|
||
|
||
### 3. Versione release (priorità media)
|
||
|
||
Allineare a Android (o policy store equivalente):
|
||
|
||
- `MARKETING_VERSION` → `2.0.3` (o `2.0.3-native` se accettato da App Store Connect)
|
||
- `CURRENT_PROJECT_VERSION` → `24` (o build successiva se 21/22/23 già usati su TestFlight)
|
||
|
||
Aggiornare **sia** `generate_xcodeproj.py` **sia** `Info.plist` (`CFBundleShortVersionString` / `CFBundleVersion`) prima di regenerare il progetto.
|
||
|
||
### 4. Logout icon (priorità bassa)
|
||
|
||
In top bar Matches: SF Symbol tipo `rectangle.portrait.and.arrow.right` + `accessibilityLabel` da `L10n.t("action.logout")`, come icona logout Android.
|
||
|
||
### 5. Opzionale — tooling stringhe
|
||
|
||
Migrare da dizionario Swift a `Localizable.xcstrings` (o `*.lproj`) per parità con Android `values-*` e revisione traduzioni in Xcode.
|
||
|
||
### 6. Fuori scope immediato (stesso debito Android)
|
||
|
||
Wizard 3 step, Broadcast overlay, dialoghi set/partita: ancora IT hardcoded su **entrambe** le piattaforme. Non bloccano l’allineamento Login/Matches/i18n di questa release.
|
||
|
||
---
|
||
|
||
## Verifica manuale su Mac (pre-release)
|
||
|
||
1. `cd native/ios && python3 generate_xcodeproj.py`
|
||
2. Build debug su simulatore; login con utenza di produzione (o staging).
|
||
3. Cambia lingua Login → English: label + errori + slogan in EN.
|
||
4. Entra in Matches: saluto, sezioni, empty state, CTA in EN (non italiano).
|
||
5. Kill app e riapri: lingua persistita.
|
||
6. Ripeti spot-check FR/DE/ES.
|
||
7. Release: dalla root repo
|
||
`./scripts/build_ios_release.sh`
|
||
(default API già `https://www.matchlivetv.it`; override con `API_BASE_URL=...` se serve).
|
||
|
||
Test automatici (da README iOS):
|
||
|
||
```bash
|
||
cd native/ios
|
||
python3 generate_xcodeproj.py
|
||
xcodebuild -project MatchLiveTv.xcodeproj -scheme MatchLiveTv \
|
||
-destination 'platform=iOS Simulator,name=iPhone 17' \
|
||
-derivedDataPath build/DerivedData \
|
||
ONLY_ACTIVE_ARCH=YES ARCHS=arm64 EXCLUDED_ARCHS=x86_64 \
|
||
test -only-testing:MatchLiveTvTests
|
||
```
|
||
|
||
---
|
||
|
||
## Note API / produzione
|
||
|
||
| | Android | iOS |
|
||
|--|---------|-----|
|
||
| Default | `-PAPI_BASE_URL` / BuildConfig | `API_BASE_URL` in build settings → Info.plist |
|
||
| Fallback | `https://www.matchlivetv.it` | idem in `AppConfig` |
|
||
| REST | `{base}/api/v1` | idem |
|
||
| Cable | `wss://…/cable` | idem |
|
||
|
||
Nessuna modifica server richiesta per allineare iOS: stesso backend già in produzione con i18n web.
|
||
|
||
---
|
||
|
||
## Sintesi priorità
|
||
|
||
1. **Alta** — Localizzare hub Matches (oggi cambio lingua incompleto).
|
||
2. **Alta** — Collegare slogan wordmark a `L10n`.
|
||
3. **Media** — Bump versione 2.0.3 / 24.
|
||
4. **Bassa** — Icona logout; migrazione a xcstrings; fine-tuning RTMP solo per dev.
|
||
|
||
Quando questi punti sono chiusi, l’app iOS è allineata alla release Android `2.0.3-native` per UX lingua e store versioning.
|