Atualizar APIs SwiftUI
Escaneie sistematicamente a documentação do desenvolvedor Apple via o Sosumi MCP, identifique APIs SwiftUI obsoletas e suas substituições modernas, e atualize swiftui-expert-skill/references/latest-apis.md.
Pré-requisitos
- Sosumi MCP deve estar habilitado e disponível (fornece
searchAppleDocumentation,fetchAppleDocumentation,fetchAppleVideoTranscript,fetchExternalDocumentation) - Acesso de escrita a este repositório (ou um fork)
Fluxo de Trabalho
1. Entender a cobertura atual
Leia swiftui-expert-skill/references/latest-apis.md para entender:
- Quais transições de obsoleto para moderno já estão documentadas
- Os segmentos de versão em uso (iOS 15+, 16+, 17+, 18+, 26+)
- A Tabela de Consulta Rápida no final
2. Carregar o manifesto de varredura
Leia references/scan-manifest.md (relativo a esta skill). Ele contém a lista categorizada de áreas de API, caminhos de documentação, consultas de busca e caminhos de vídeos WWDC a serem varridos.
3. Escanear a documentação da Apple
Para cada categoria no manifesto:
- Chame
searchAppleDocumentationcom as consultas listadas para descobrir páginas relevantes. - Chame
fetchAppleDocumentationcom caminhos de documentação específicos para obter detalhes completos da API. - Procure por avisos de depreciação, rótulos "Deprecated" e orientação "Use ... instead".
- Anote a versão do iOS onde a substituição moderna se tornou disponível.
- Opcionalmente, chame
fetchAppleVideoTranscriptpara sessões WWDC que anunciam mudanças de API.
Agrupe buscas relacionadas para eficiência. Foco em encontrar novas depreciações ainda não presentes em latest-apis.md.
4. Comparar e identificar mudanças
Compare os resultados com as entradas existentes. Categorize os resultados:
- Novas depreciações: APIs ainda não documentadas em
latest-apis.md - Correções: Entradas existentes que precisam ser atualizadas (versão errada, substituição melhor disponível)
- Novos segmentos de versão: Se uma nova versão do iOS introduzir depreciações, adicione uma nova seção
5. Atualizar latest-apis.md
Siga exatamente o formato estabelecido. Cada entrada deve incluir:
Posicionamento na seção -- coloque sob o segmento de versão correto:
- "Sempre Use (iOS 15+)" para APIs obsoletas há muito tempo
- "Ao Segmentar iOS 16+" / "17+" / "18+" / "26+" para mudanças limitadas por versão
Formato da entrada:
**Sempre use `modernAPI()` em vez de `deprecatedAPI()`.**
\```swift
// Moderno
View()
.modernAPI()
// Obsoleto
View()
.deprecatedAPI()
\```
Tabela de Consulta Rápida -- adicione uma linha ao final do arquivo:
| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |
Mantenha a linha de atribuição no topo do arquivo:
Baseado em uma comparação da documentação da Apple usando o Sosumi MCP, encontramos as APIs recomendadas mais recentes para usar.
6. Abrir um pull request
- Crie um branch a partir de
mainchamadoupdate/latest-apis-YYYY-MM(use o ano e mês atuais). - Faça commit das alterações em
swiftui-expert-skill/references/latest-apis.md. - Abra um PR via
gh pr createcom:- Título: "Atualizar APIs SwiftUI mais recentes (Mês Ano)"
- Corpo: Resumo das entradas novas/alteradas, atribuição ao Sosumi MCP
Referência da Ferramenta Sosumi MCP
| Ferramenta | Parâmetros | Retorna |
|---|---|---|
searchAppleDocumentation | query (string) | JSON com results[] contendo title, url, description, breadcrumbs, tags, type |
fetchAppleDocumentation | path (string, ex.: /documentation/swiftui/view/foregroundstyle(_:)) | Conteúdo da documentação em Markdown |
fetchAppleVideoTranscript | path (string, ex.: /videos/play/wwdc2025/10133) | Transcrição em Markdown |
fetchExternalDocumentation | url (string, URL https completa) | Conteúdo da documentação em Markdown |
Dicas
- Comece amplo com consultas
searchAppleDocumentation, depois aprofunde em caminhos específicos comfetchAppleDocumentation. - As documentações de depreciação da Apple normalmente dizem "Deprecated" na página e fornecem link para a substituição.
- As sessões WWDC "What's new in SwiftUI" são a melhor fonte para substituições recém-introduzidas.
- Quando estiver em dúvida sobre a versão exata do iOS para uma depreciação, verifique consultando a seção "Availability" na documentação obtida.
- Se uma API estiver obsoleta mas não houver substituição direta, anote isso em vez de sugerir uma alternativa incorreta.