Que fait Mise à jour des API SwiftUI ?
Analyse systématiquement la documentation développeur Apple via le MCP Sosumi, identifie les API SwiftUI dépréciées et leurs remplacements modernes, et met à jour swiftui-expert-skill/references/latest-apis.md.
Prérequis
- MCP Sosumi doit être activé et disponible (fournit
searchAppleDocumentation,fetchAppleDocumentation,fetchAppleVideoTranscript,fetchExternalDocumentation) - Accès en écriture à ce dépôt (ou un fork)
Workflow
1. Comprendre le périmètre actuel
Lisez swiftui-expert-skill/references/latest-apis.md pour comprendre :
- Quelles transitions déprécié-vers-moderne sont déjà documentées
- Les segments de version utilisés (iOS 15+, 16+, 17+, 18+, 26+)
- Le tableau de référence rapide en bas
2. Charger le manifeste de scan
Lisez references/scan-manifest.md (relatif à cette compétence). Il contient la liste catégorisée des zones d'API, des chemins de documentation, des requêtes de recherche et des chemins de vidéos WWDC à scanner.
3. Scanner la documentation Apple
Pour chaque catégorie du manifeste :
- Appelez
searchAppleDocumentationavec les requêtes listées pour découvrir les pages pertinentes. - Appelez
fetchAppleDocumentationavec les chemins de documentation spécifiques pour obtenir tous les détails de l'API. - Recherchez les avis de dépréciation, les libellés "Deprecated" et les indications "Use ... instead".
- Notez la version iOS où le remplacement moderne est devenu disponible.
- Si nécessaire, appelez
fetchAppleVideoTranscriptpour les sessions WWDC qui annoncent des changements d'API.
Regroupez les recherches connexes pour plus d'efficacité. Concentrez-vous sur la recherche de nouvelles dépréciations pas encore présentes dans latest-apis.md.
4. Comparer et identifier les changements
Comparez les résultats avec les entrées existantes. Catégorisez les résultats :
- Nouvelles dépréciations : API non encore documentées dans
latest-apis.md - Corrections : Entrées existantes à mettre à jour (mauvaise version, meilleur remplacement disponible)
- Nouveaux segments de version : Si une nouvelle version iOS introduit des dépréciations, ajoutez une nouvelle section
5. Mettre à jour latest-apis.md
Suivez exactement le format établi. Chaque entrée doit inclure :
Placement dans la section — placez sous le segment de version correct :
- "Toujours utiliser (iOS 15+)" pour les API dépréciées depuis longtemps
- "Lors du ciblage iOS 16+" / "17+" / "18+" / "26+" pour les changements liés à la version
Format d'entrée :
**Utilisez toujours `modernAPI()` à la place de `deprecatedAPI()`.**
\```swift
// Moderne
View()
.modernAPI()
// Déprécié
View()
.deprecatedAPI()
\```
Tableau de référence rapide — ajoutez une ligne en bas du fichier :
| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |
Conservez la ligne d'attribution en haut du fichier :
Basé sur une comparaison de la documentation Apple utilisant le MCP Sosumi, nous avons trouvé les API recommandées les plus récentes à utiliser.
6. Ouvrir une pull request
- Créez une branche à partir de
mainnomméeupdate/latest-apis-YYYY-MM(utilisez l'année et le mois en cours). - Committez les modifications dans
swiftui-expert-skill/references/latest-apis.md. - Ouvrez une PR via
gh pr createavec :- Titre : "Mise à jour des dernières API SwiftUI (Mois Année)"
- Corps : Résumé des entrées nouvelles/modifiées, attribution au MCP Sosumi
Référence des outils MCP Sosumi
| Outil | Paramètres | Retourne |
|---|---|---|
searchAppleDocumentation | query (string) | JSON avec results[] contenant title, url, description, breadcrumbs, tags, type |
fetchAppleDocumentation | path (string, ex. /documentation/swiftui/view/foregroundstyle(_:)) | Contenu de documentation Markdown |
fetchAppleVideoTranscript | path (string, ex. /videos/play/wwdc2025/10133) | Transcription Markdown |
fetchExternalDocumentation | url (string, URL https complète) | Contenu de documentation Markdown |
Conseils
- Commencez large avec des requêtes
searchAppleDocumentation, puis creusez dans les chemins spécifiques avecfetchAppleDocumentation. - Les documents de dépréciation Apple indiquent généralement "Deprecated" sur la page et fournissent un lien vers le remplacement.
- Les sessions WWDC "What's new in SwiftUI" sont la meilleure source pour les remplacements récemment introduits.
- En cas de doute sur la version iOS exacte d'une dépréciation, vérifiez en consultant la section "Availability" dans la documentation récupérée.
- Si une API est dépréciée mais qu'aucun remplacement direct n'existe, notez-le plutôt que de suggérer une alternative incorrecte.