¿Qué hace Actualizar APIs de SwiftUI?
Escanea sistemáticamente la documentación para desarrolladores de Apple a través del MCP Sosumi, identifica APIs de SwiftUI obsoletas y sus reemplazos modernos, y actualiza el archivo swiftui-expert-skill/references/latest-apis.md.
Prerrequisitos
- MCP Sosumi debe estar habilitado y disponible (proporciona
searchAppleDocumentation,fetchAppleDocumentation,fetchAppleVideoTranscript,fetchExternalDocumentation) - Acceso de escritura a este repositorio (o un fork)
Flujo de trabajo
1. Comprender la cobertura actual
Lee el archivo swiftui-expert-skill/references/latest-apis.md para entender:
- Qué transiciones de obsoleto a moderno ya están documentadas
- Los segmentos de versión en uso (iOS 15+, 16+, 17+, 18+, 26+)
- La tabla de consulta rápida al final
2. Cargar el manifiesto de escaneo
Lee el archivo references/scan-manifest.md (relativo a este skill). Contiene la lista categorizada de áreas de API, rutas de documentación, consultas de búsqueda y rutas de videos WWDC a escanear.
3. Escanear la documentación de Apple
Para cada categoría en el manifiesto:
- Llama a
searchAppleDocumentationcon las consultas listadas para descubrir páginas relevantes. - Llama a
fetchAppleDocumentationcon rutas de documentación específicas para obtener detalles completos de la API. - Busca avisos de obsolescencia, etiquetas "Deprecated" y guías de "Usar ... en su lugar".
- Anota la versión de iOS donde el reemplazo moderno estuvo disponible.
- Opcionalmente, llama a
fetchAppleVideoTranscriptpara sesiones WWDC que anuncian cambios de API.
Agrupa búsquedas relacionadas para mayor eficiencia. Concéntrate en encontrar nuevas obsolescencias que aún no estén en latest-apis.md.
4. Comparar e identificar cambios
Compara los hallazgos con las entradas existentes. Categoriza los resultados:
- Nuevas obsolescencias: APIs aún no documentadas en
latest-apis.md - Correcciones: Entradas existentes que necesitan actualización (versión incorrecta, mejor reemplazo disponible)
- Nuevos segmentos de versión: Si una nueva versión de iOS introduce obsolescencias, agrega una nueva sección
5. Actualizar latest-apis.md
Sigue exactamente el formato establecido. Cada entrada debe incluir:
Ubicación en la sección – colócala bajo el segmento de versión correcto:
- "Always Use (iOS 15+)" para APIs obsoletas desde hace mucho tiempo
- "When Targeting iOS 16+" / "17+" / "18+" / "26+" para cambios condicionados por versión
Formato de entrada:
**Always use `modernAPI()` instead of `deprecatedAPI()`.**
\```swift
// Modern
View()
.modernAPI()
// Deprecated
View()
.deprecatedAPI()
\```
Tabla de consulta rápida – agrega una fila al final del archivo:
| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |
Mantén la línea de atribución al inicio del archivo:
Basado en una comparación de la documentación de Apple usando el MCP Sosumi, encontramos las APIs recomendadas más recientes para usar.
6. Abrir un pull request
- Crea una rama desde
mainllamadaupdate/latest-apis-YYYY-MM(usa el año y mes actuales). - Confirma los cambios en
swiftui-expert-skill/references/latest-apis.md. - Abre un PR mediante
gh pr createcon:- Título: "Actualizar las APIs más recientes de SwiftUI (Mes Año)"
- Cuerpo: Resumen de las entradas nuevas/modificadas, atribución al MCP Sosumi
Referencia de herramientas del MCP Sosumi
| Herramienta | Parámetros | Retorna |
|---|---|---|
searchAppleDocumentation | query (cadena) | JSON con results[] que contiene title, url, description, breadcrumbs, tags, type |
fetchAppleDocumentation | path (cadena, ej. /documentation/swiftui/view/foregroundstyle(_:)) | Contenido de documentación en Markdown |
fetchAppleVideoTranscript | path (cadena, ej. /videos/play/wwdc2025/10133) | Transcripción en Markdown |
fetchExternalDocumentation | url (cadena, URL https completa) | Contenido de documentación en Markdown |
Consejos
- Empieza de forma amplia con consultas
searchAppleDocumentation, luego profundiza en rutas específicas confetchAppleDocumentation. - La documentación de obsolescencia de Apple típicamente dice "Deprecated" en la página y enlaza al reemplazo.
- Las sesiones "What's new in SwiftUI" de WWDC son la mejor fuente para reemplazos recién introducidos.
- Cuando no estés seguro sobre la versión exacta de iOS para una obsolescencia, verifícala consultando la sección "Availability" en la documentación obtenida.
- Si una API está obsoleta pero no existe un reemplazo directo, anótalo en lugar de sugerir una alternativa incorrecta.