malikkaraoui/ios-setup

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

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.