ios-setup

name	ios-setup
description	Configure le workflow iOS/tvOS optimal : VS Code + Claude Code + Xcode minimal + Makefile. Génère la structure, le Makefile V4, les tasks VS Code, le CLAUDE.md projet. Déclenché automatiquement si Xcode ou Swift est mentionné.
figure	Maître d'atelier
triggers	xcode, ios, tvos, swift, swiftui, app store, testflight, simulateur

iOS Setup

L'atelier s'ouvre sur un nouveau chantier. Pas une app ordinaire — une app Apple. Les règles changent. Les outils aussi. Le Maître d'atelier sort le plan spécial.

Setup complet du workflow iOS/tvOS dans l'atelier.

Quand se déclencher

• Mention de Xcode, iOS, tvOS, Swift, SwiftUI, App Store, TestFlight
• Projet mobile en cours de setup
• /ios-setup explicite

Le principe

Xcode est incontournable chez Apple. Mais il ne doit pas être le centre.

80-95% du dev → VS Code + Claude Code
5-20% → Xcode (signing, device, LLDB, archive)

Le Makefile est le pont. make run remplace "ouvrir Xcode, sélectionner le scheme, cliquer Run".

Procédure

Étape 1 — Vérifier les pré-requis

xcodebuild -version   # Xcode 15+ recommandé
swift --version
gem install xcpretty
brew install jq

Si Xcode absent → "Télécharger Xcode depuis l'App Store avant de continuer. C'est le seul prérequis non négociable."

Étape 2 — Générer la structure projet

MyApp/
├── MyApp.xcodeproj
├── MyApp/
│   ├── App/          (MyAppApp.swift, ContentView.swift)
│   ├── Views/
│   ├── ViewModels/
│   ├── Models/
│   ├── Services/
│   ├── Components/
│   └── Resources/
├── MyAppTests/
├── Packages/CoreKit/
├── Scripts/
├── .vscode/          (tasks.json, settings.json)
├── Makefile
└── CLAUDE.md

Étape 3 — Demander les informations projet

Avant de générer le Makefile, récupérer :

1. Nom du projet (ex: MyApp)
2. Bundle ID iOS (ex: com.example.myapp)
3. Bundle ID tvOS si applicable
4. Scheme iOS (souvent = nom du projet)
5. Scheme tvOS si applicable
6. Simulateur cible iOS (défaut: iPhone 15 Pro)
7. Simulateur cible tvOS (défaut: Apple TV 4K (3rd generation))

Étape 4 — Générer le Makefile V4

Avec les infos récupérées, générer le Makefile complet incluant :

• make run → build + boot simulator + install + launch
• make tvrun → idem tvOS
• make test → tests unitaires
• make doctor → diagnostic setup
• make devices → liste devices
• make device DEVICE_ID=<udid> → device réel
• make archive → archive App Store
• make clean → nettoyage
• make logs → logs build
• make help → aide

Étape 5 — Générer les tasks VS Code

Fichier .vscode/tasks.json avec :

• ⌘⇧B → Run iOS Simulator
• Run tvOS Simulator
• Run Tests
• Doctor / Clean / List Devices

Étape 6 — Générer le CLAUDE.md projet iOS

## Projet iOS
- Nom : [nom]
- Plateformes : iOS 17+ / tvOS 17+
- Langage : Swift 5.9+
- UI : SwiftUI
- Architecture : MVVM + Services + local Swift Packages
- Scheme iOS : [scheme]  Bundle : [bundle_id]
- Simulateur : iPhone 15 Pro
- Règles : async/await, une Preview par View, logique → CoreKit
- Ne pas modifier : .xcodeproj interne, signing, Info.plist

Étape 7 — Générer le .gitignore iOS

# Xcode
*.xcuserstate
xcuserdata/
DerivedData/
*.xcscmblueprint

# Build
.build/

# macOS
.DS_Store

Étape 8 — Vérification finale

make doctor
make help

Si tout est vert → "L'atelier iOS est prêt. make run pour lancer."

Règles

• Jamais forcer l'ouverture de Xcode si une commande CLI suffit
• Toujours demander bundle ID avant de générer le Makefile (sans lui, simctl launch échoue)
• Si Swift Package Manager est utilisé : documenter les packages dans §0
• Tests SwiftUI : XCTest + .testable import
• §5 prime : ne pas inventer de flags xcodebuild non vérifiés

Bonnes pratiques systématiques — à inclure dans toute app iOS

Ces patterns sont incontournables. Les proposer systématiquement dès le setup initial.

1. Dark Mode automatique

Ne jamais hardcoder de couleurs. Toujours utiliser les semantic colors Apple ou des Color assets avec variants Light/Dark.

// ✅ Correct
Text("Titre").foregroundStyle(.primary)
Rectangle().fill(Color("Surface")) // asset avec variant Dark

// ❌ Interdit
Text("Titre").foregroundColor(.black)

Dans Info.plist : ne pas forcer UIUserInterfaceStyle → laisser le système décider. Dans .xcassets : créer les couleurs en tant qu'Asset Catalog avec appearance Any/Dark.

2. Internationalisation (i18n)

Dès le premier écran — pas "on verra plus tard". Créer Localizable.strings (FR + EN minimum).

MyApp/Resources/
├── fr.lproj/Localizable.strings
└── en.lproj/Localizable.strings

// Usage
Text(String(localized: "onboarding.title"))
// ou macro Swift 5.9+
Text("Bienvenue", comment: "Titre écran d'accueil")

Ajouter dans CLAUDE.md projet : - Langues : FR (défaut), EN — Localizable.strings obligatoire

3. Demande de notation App Store

Déclencher au bon moment (après une action positive réussie, pas au lancement).

import StoreKit

// Dans un ViewModel, après action positive
func requestReviewIfAppropriate() {
    guard successfulActionsCount >= 3 else { return }
    if let scene = UIApplication.shared.connectedScenes
        .first(where: { $0.activationState == .foregroundActive }) as? UIWindowScene {
        SKStoreReviewController.requestReview(in: scene)
    }
}

Règle : jamais au lancement, jamais après un échec, max 3 fois par an (Apple limite de toute façon).

4. Share Sheet — partager l'app

Permettre de partager l'app avec ses proches depuis les Réglages ou un bouton dédié.

struct ShareAppButton: View {
    let appStoreURL = URL(string: "https://apps.apple.com/app/idXXXXXXXXX")!

    var body: some View {
        ShareLink(item: appStoreURL, subject: Text("Découvre cette app"),
                  message: Text("Je pense que ça pourrait t'intéresser !")) {
            Label("Partager l'app", systemImage: "square.and.arrow.up")
        }
    }
}

5. Écran Réglages / À propos

Toujours créer une vue SettingsView avec au minimum :

struct SettingsView: View {
    var appVersion: String {
        let v = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "?"
        let b = Bundle.main.infoDictionary?["CFBundleVersion"] as? String ?? "?"
        return "v\(v) (\(b))"
    }

    var body: some View {
        List {
            // Apparence
            Section("Apparence") {
                // Dark mode : géré par le système — informer l'utilisateur
                Text("Le thème suit les réglages de votre iPhone")
                    .font(.caption).foregroundStyle(.secondary)
            }

            // Langue
            Section("Langue") {
                Button("Changer la langue") {
                    UIApplication.shared.open(URL(string: UIApplication.openSettingsURLString)!)
                }
            }

            // Partage & avis
            Section {
                ShareLink(item: URL(string: "https://apps.apple.com/app/idXXXXXXXXX")!) {
                    Label("Partager l'app", systemImage: "square.and.arrow.up")
                }
                Link(destination: URL(string: "https://apps.apple.com/app/idXXXXXXXXX?action=write-review")!) {
                    Label("Laisser un avis", systemImage: "star")
                }
            }

            // Infos légales
            Section("Informations") {
                LabeledContent("Version", value: appVersion)
                Link("Politique de confidentialité",
                     destination: URL(string: "https://example.com/privacy")!)
                Link("Conditions d'utilisation",
                     destination: URL(string: "https://example.com/terms")!)
            }
        }
        .navigationTitle("Réglages")
    }
}

6. Checklist avant chaque soumission App Store

• Dark mode testé sur tous les écrans (simulateur → Appearance Dark)
• Toutes les strings dans Localizable.strings (no hardcoded text)
• SKStoreReviewController déclenché au bon moment (pas au launch)
• ShareLink vers l'App Store présent
• SettingsView avec version, privacy, avis, partage
• CFBundleShortVersionString et CFBundleVersion incrémentés
• Screenshots préparés pour toutes les tailles requises
• Privacy manifest (PrivacyInfo.xcprivacy) si APIs sensibles

Prompts utiles à proposer après setup

# Refactor SwiftUI
Refactor this SwiftUI screen into smaller reusable components.
Keep previews. Preserve current behavior.

# MVVM
Reorganize this feature into MVVM.
Move side effects to Services, keep the View simple.

# Tests
Generate unit tests for this service. Cover success + failure cases.

# Performance
Review this SwiftUI view for unnecessary re-renders.