SwiftUI-APIs aktualisieren
Systematisch die Apple-Entwicklerdokumentation über den Sosumi MCP durchsuchen, veraltete SwiftUI-APIs und ihre modernen Ersetzungen identifizieren und swiftui-expert-skill/references/latest-apis.md aktualisieren.
Voraussetzungen
- Sosumi MCP muss aktiviert und verfügbar sein (bietet
searchAppleDocumentation,fetchAppleDocumentation,fetchAppleVideoTranscript,fetchExternalDocumentation) - Schreibzugriff auf dieses Repository (oder einen Fork)
Arbeitsablauf
1. Aktuelle Abdeckung verstehen
Lesen Sie swiftui-expert-skill/references/latest-apis.md, um zu verstehen:
- Welche Übergänge von veraltet zu modern bereits dokumentiert sind
- Die verwendeten Versionsabschnitte (iOS 15+, 16+, 17+, 18+, 26+)
- Die Kurzreferenztabelle am Ende
2. Scan-Manifest laden
Lesen Sie references/scan-manifest.md (relativ zu diesem Skill). Es enthält die kategorisierte Liste der API-Bereiche, Dokumentationspfade, Suchanfragen und WWDC-Videopfade, die durchsucht werden sollen.
3. Apple-Dokumentation durchsuchen
Führen Sie für jede Kategorie im Manifest Folgendes durch:
- Rufen Sie
searchAppleDocumentationmit den aufgeführten Suchanfragen auf, um relevante Seiten zu entdecken. - Rufen Sie
fetchAppleDocumentationmit spezifischen Dokumentationspfaden auf, um vollständige API-Details zu erhalten. - Suchen Sie nach Veraltet-Hinweisen, "Deprecated"-Labels und "Verwenden Sie stattdessen ..."-Anleitungen.
- Notieren Sie die iOS-Version, in der die moderne Ersetzung verfügbar wurde.
- Rufen Sie optional
fetchAppleVideoTranscriptfür WWDC-Sessions auf, die API-Änderungen ankündigen.
Gruppieren Sie zusammenhängende Suchanfragen aus Effizienzgründen. Konzentrieren Sie sich darauf, neue Veraltungen zu finden, die noch nicht in latest-apis.md enthalten sind.
4. Vergleichen und Änderungen identifizieren
Vergleichen Sie die Ergebnisse mit bestehenden Einträgen. Kategorisieren Sie die Ergebnisse:
- Neue Veraltungen: APIs, die noch nicht in
latest-apis.mddokumentiert sind - Korrekturen: Bestehende Einträge, die aktualisiert werden müssen (falsche Version, bessere Ersetzung verfügbar)
- Neue Versionsabschnitte: Wenn eine neue iOS-Version Veraltungen einführt, fügen Sie einen neuen Abschnitt hinzu
5. latest-apis.md aktualisieren
Halten Sie sich genau an das etablierte Format. Jeder Eintrag muss Folgendes enthalten:
Abschnittsplatzierung -- platzieren Sie ihn unter dem richtigen Versionsabschnitt:
- "Immer verwenden (iOS 15+)" für länger veraltete APIs
- "Bei Zielsetzung iOS 16+" / "17+" / "18+" / "26+" für versionsgebundene Änderungen
Eintragsformat:
**Verwenden Sie immer `modernAPI()` anstelle von `deprecatedAPI()`.**
\```swift
// Modern
View()
.modernAPI()
// Veraltet
View()
.deprecatedAPI()
\```
Kurzreferenztabelle -- fügen Sie am Ende der Datei eine Zeile hinzu:
| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |
Behalten Sie die Quellenangabe am Anfang der Datei bei:
Basierend auf einem Vergleich der Apple-Dokumentation unter Verwendung des Sosumi MCP haben wir die neuesten empfohlenen APIs zur Verwendung gefunden.
6. Pull Request öffnen
- Erstellen Sie einen Branch von
mainmit dem Namenupdate/latest-apis-YYYY-MM(aktuelles Jahr und Monat verwenden). - Übertragen Sie Änderungen an
swiftui-expert-skill/references/latest-apis.md. - Öffnen Sie einen PR über
gh pr createmit:- Titel: "Update latest SwiftUI APIs (Monat Jahr)"
- Inhalt: Zusammenfassung der neuen/geänderten Einträge, Quellenangabe zum Sosumi MCP
Sosumi MCP Tool-Referenz
| Tool | Parameter | Rückgabe |
|---|---|---|
searchAppleDocumentation | query (Zeichenkette) | JSON mit results[] mit title, url, description, breadcrumbs, tags, type |
fetchAppleDocumentation | path (Zeichenkette, z.B. /documentation/swiftui/view/foregroundstyle(_:)) | Markdown-Dokumentationsinhalt |
fetchAppleVideoTranscript | path (Zeichenkette, z.B. /videos/play/wwdc2025/10133) | Markdown-Transkript |
fetchExternalDocumentation | url (Zeichenkette, vollständige https-URL) | Markdown-Dokumentationsinhalt |
Tipps
- Beginnen Sie breit mit
searchAppleDocumentation-Suchanfragen und gehen Sie dann mitfetchAppleDocumentationzu spezifischen Pfaden über. - Apples Dokumentation zu Veraltungen zeigt in der Regel "Deprecated" auf der Seite und verlinkt zur Ersetzung.
- WWDC "What's new in SwiftUI"-Sessions sind die beste Quelle für neu eingeführte Ersetzungen.
- Wenn Sie sich bezüglich der genauen iOS-Version für eine Veraltung unsicher sind, überprüfen Sie diesen im Abschnitt "Verfügbarkeit" in der abgerufenen Dokumentation.
- Wenn eine API veraltet ist, aber keine direkte Ersetzung existiert, notieren Sie dies, anstatt eine falsche Alternative vorzuschlagen.