Atualizar APIs do SwiftUI

Quando Usar

Use esta habilidade quando precisar verificar a documentação do SwiftUI da Apple em busca de APIs obsoletas e atualizar a Habilidade de Especialista em SwiftUI com substituições modernas. Use quando for solicitado a "atualizar as APIs mais recentes", "atualizar APIs obsoletas do SwiftUI", "verificar novas depreciações do SwiftUI", "verificar alterações de API" ou após um novo iOS/Xcode...

Verifique sistematicamente a documentação do desenvolvedor da Apple através do Sosumi MCP, identifique APIs obsoletas do SwiftUI 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 na parte inferior

2. Carregar o manifesto de verificação

Leia references/scan-manifest.md (relativo a esta habilidade). Ele contém a lista categorizada de áreas de API, caminhos de documentação, consultas de pesquisa e caminhos de vídeo do WWDC para verificar.

3. Verificar a documentação da Apple

Para cada categoria no manifesto:

1. Chame searchAppleDocumentation com as consultas listadas para descobrir páginas relevantes.
2. Chame fetchAppleDocumentation com caminhos de documentação específicos para obter detalhes completos da API.
3. Procure por avisos de depreciação, rótulos "Obsoleto" e orientações "Use ... em vez disso".
4. Anote a versão do iOS onde a substituição moderna se tornou disponível.
5. Opcionalmente, chame fetchAppleVideoTranscript para sessões do WWDC que anunciam alterações de API.

Agrupe pesquisas relacionadas para eficiência. Concentre-se em encontrar depreciações novas que ainda não estão em latest-apis.md.

4. Comparar e identificar alterações

Compare os achados 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 de atualização (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 o formato estabelecido exatamente. Cada entrada deve incluir:

Posicionamento da seção -- coloque sob o segmento de versão correto:

• "Sempre Use (iOS 15+)" para APIs obsoletas há muito tempo
• "Ao ter como alvo iOS 16+" / "17+" / "18+" / "26+" para alterações com restrição de versão

Formato da entrada:

**Always use `modernAPI()` instead of `deprecatedAPI()`.**

\```swift
// Moderno
View()
    .modernAPI()

// Obsoleto
View()
    .deprecatedAPI()
\```

Tabela de Consulta Rápida -- adicione uma linha na parte inferior 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

1. Crie um branch a partir de main chamado update/latest-apis-YYYY-MM (use o ano e mês atuais).
2. Commite as alterações em swiftui-expert-skill/references/latest-apis.md.
3. Abra um PR via gh pr create com:
   • Título: "Atualizar APIs mais recentes do SwiftUI (Mês Ano)"
   • Corpo: Resumo das entradas novas/alteradas, atribuição ao Sosumi MCP

Referência da Ferramenta Sosumi MCP

Dicas

• Comece de forma ampla com consultas searchAppleDocumentation, depois aprofunde em caminhos específicos com fetchAppleDocumentation.
• A documentação de depreciação da Apple geralmente diz "Obsoleto" na página e vincula à substituição.
• As sessões do WWDC "Novidades no SwiftUI" são a melhor fonte para substituições recém-introduzidas.
• Ao ter dúvidas sobre a versão exata do iOS para uma depreciação, verifique a seção "Disponibilidade" na documentação obtida.

…