For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Codex

Codex use case

Adote o Liquid Glass

Use o Codex para migrar um aplicativo SwiftUI existente para o Liquid Glass com as APIs do iOS 26 e o Xcode 26.

Difficulty Avançado
Time horizon 1 h

Use o Codex e o plug-in Build iOS Apps para auditar a UI existente do iPhone e do iPad, substituir pilhas personalizadas de desfoque ou materiais pelo Liquid Glass nativo e manter a migração segura com verificações de disponibilidade do iOS 26 e validação no simulador.

Ideal para

  • Aplicativos SwiftUI existentes que precisam de um plano prático de migração para o Liquid Glass no iOS 26, não de instruções vagas para reformular o visual
  • Equipes que querem que o Codex audite cartões personalizados, sheets, barras de abas, barras de ferramentas e botões de ação e depois implemente a migração etapa por etapa
  • Apps que ainda oferecem suporte a versões anteriores do iOS e precisam usar `#available(iOS 26, *)` como fallback, em vez de fazer uma reformulação visual irreversível

Contents

    ← Todos os casos de uso

    Adote o Liquid Glass

    Use o Codex para migrar um aplicativo SwiftUI existente para o Liquid Glass com as APIs do iOS 26 e o Xcode 26.

    Use o Codex e o plug-in Build iOS Apps para auditar a UI existente do iPhone e do iPad, substituir pilhas personalizadas de desfoque ou materiais pelo Liquid Glass nativo e manter a migração segura com verificações de disponibilidade do iOS 26 e validação no simulador.

    Avançado
    1 h

    Use o Codex e o plug-in Build iOS Apps para auditar a UI existente do iPhone e do iPad, substituir pilhas personalizadas de desfoque ou materiais pelo Liquid Glass nativo e manter a migração segura com verificações de disponibilidade do iOS 26 e validação no simulador.

    Avançado
    1 h

    Ideal para

    • Aplicativos SwiftUI existentes que precisam de um plano prático de migração para o Liquid Glass no iOS 26, não de instruções vagas para reformular o visual
    • Equipes que querem que o Codex audite cartões personalizados, sheets, barras de abas, barras de ferramentas e botões de ação e depois implemente a migração etapa por etapa
    • Apps que ainda oferecem suporte a versões anteriores do iOS e precisam usar `#available(iOS 26, *)` como fallback, em vez de fazer uma reformulação visual irreversível

    Habilidades e Plug-ins

    • Use as habilidades de Liquid Glass no SwiftUI, de padrões de UI do SwiftUI e de depuração no simulador para modernizar telas do iOS, adotar efeitos de vidro nativos e verificar o resultado em simuladores do iOS 26.
    Skill Why use it
    Build iOS Apps Use as habilidades de Liquid Glass no SwiftUI, de padrões de UI do SwiftUI e de depuração no simulador para modernizar telas do iOS, adotar efeitos de vidro nativos e verificar o resultado em simuladores do iOS 26.

    Prompt inicial

    Use o plug-in Build iOS Apps e a habilidade Liquid Glass para SwiftUI que ele inclui para migrar um fluxo muito acessado deste aplicativo para o Liquid Glass. Restrições: - Trate isto como uma migração para iOS 26 + Xcode 26, mas preserve um fallback sem efeito de vidro para destinos de implantação em versões anteriores usando `#available(iOS 26, *)`. - Primeiro, audite o fluxo. Indique quais planos de fundo personalizados, pilhas de desfoque, chips, botões, sheets e barras de ferramentas devem adotar o Liquid Glass nativo e quais superfícies devem permanecer como conteúdo simples. - Prefira controles do sistema e APIs nativas como `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)` e `.buttonStyle(.glassProminent)` a desfoques personalizados. Use `glassEffectID` com `@Namespace` somente quando uma transição de morphing realmente melhorar o fluxo. - Aplique `glassEffect` depois dos modificadores de layout e visuais, mantenha as formas consistentes e use `.interactive()` apenas em controles que realmente respondam ao toque. - Use XcodeBuildMCP para compilar e executar o aplicativo em um simulador do iOS 26, capture telas do fluxo migrado e informe exatamente o esquema, o simulador e as verificações que você usou. Entregue: - um plano conciso de migração do fluxo - a parte do fluxo implementada com Liquid Glass - o comportamento de fallback para dispositivos com versões anteriores ao iOS 26 - as etapas de validação no simulador e as capturas de tela usadas
    Use o plug-in Build iOS Apps e a habilidade Liquid Glass para SwiftUI que ele inclui para migrar um fluxo muito acessado deste aplicativo para o Liquid Glass. Restrições: - Trate isto como uma migração para iOS 26 + Xcode 26, mas preserve um fallback sem efeito de vidro para destinos de implantação em versões anteriores usando `#available(iOS 26, *)`. - Primeiro, audite o fluxo. Indique quais planos de fundo personalizados, pilhas de desfoque, chips, botões, sheets e barras de ferramentas devem adotar o Liquid Glass nativo e quais superfícies devem permanecer como conteúdo simples. - Prefira controles do sistema e APIs nativas como `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)` e `.buttonStyle(.glassProminent)` a desfoques personalizados. Use `glassEffectID` com `@Namespace` somente quando uma transição de morphing realmente melhorar o fluxo. - Aplique `glassEffect` depois dos modificadores de layout e visuais, mantenha as formas consistentes e use `.interactive()` apenas em controles que realmente respondam ao toque. - Use XcodeBuildMCP para compilar e executar o aplicativo em um simulador do iOS 26, capture telas do fluxo migrado e informe exatamente o esquema, o simulador e as verificações que você usou. Entregue: - um plano conciso de migração do fluxo - a parte do fluxo implementada com Liquid Glass - o comportamento de fallback para dispositivos com versões anteriores ao iOS 26 - as etapas de validação no simulador e as capturas de tela usadas

    Comece com o iOS 26 como base

    Primeiro, trate a adoção do Liquid Glass como um projeto de migração para iOS 26 e Xcode 26. Compile novamente o aplicativo com o SDK do iOS 26, verifique o que os controles padrão do SwiftUI fornecem automaticamente e só então peça ao Codex que reformule as partes personalizadas que ainda pareçam planas demais, carregadas demais ou desconectadas demais dos elementos da interface do sistema.

    Se o aplicativo ainda oferecer suporte a versões anteriores do iOS, deixe essa restrição explícita desde o início. A habilidade de Liquid Glass no SwiftUI do plug-in Build iOS Apps deve usar #available(iOS 26, *) para condicionar o uso das novas APIs exclusivas do Liquid Glass e manter um caminho de fallback que continue legível em dispositivos mais antigos.

    Aproveite o plug-in para iOS

    Use o plug-in Build iOS Apps quando quiser que o Codex combine alterações na UI do SwiftUI com validação no simulador. Para trabalhar com o Liquid Glass, peça ao Codex que audite um fluxo, migre um pequeno conjunto de superfícies, execute o resultado em um simulador do iOS 26 e capture telas antes de ampliar o escopo.

    Esse plug-in inclui uma habilidade de Liquid Glass no SwiftUI com algumas diretrizes padrão simples que vale a pena incluir no prompt:

    • Prefira APIs nativas como glassEffect e GlassEffectContainer, além de estilos de botão com efeito de vidro e transições com glassEffectID, a views personalizadas com desfoque.
    • Aplique .glassEffect(...) depois dos modificadores de layout e visuais, para que o material envolva a forma final desejada.
    • Agrupe os elementos de vidro relacionados em GlassEffectContainer quando várias superfícies aparecerem juntas.
    • Use .interactive() apenas em botões, chips e controles que realmente respondem ao toque.
    • Mantenha os formatos dos cantos, as cores e o espaçamento consistentes em toda a funcionalidade, em vez de misturar aplicações pontuais do efeito de vidro.
    • Preserve um fallback sem efeito de vidro para destinos de implantação anteriores ao iOS 26.

    Para saber mais sobre a instalação de plug-ins e habilidades, consulte nossa documentação sobre plug-ins e habilidades.

    Assista às sessões da WWDC

    Estas sessões da WWDC25 são boas referências antes de você pedir ao Codex que refatore um fluxo real de produção:

    Peça primeiro um plano de migração e depois uma etapa

    As migrações para o Liquid Glass funcionam melhor quando o Codex trata separadamente "onde o efeito de vidro deve aparecer?" e "escreva todo o código agora". Primeiro, peça uma auditoria rápida; depois, deixe o agente implementar uma etapa autocontida com validação no simulador.

    Dicas práticas

    Não aplique o efeito de vidro a tudo

    O Liquid Glass deve criar uma camada de controles bem definida sobre o conteúdo, não transformar cada cartão em um painel brilhante. Peça ao Codex que remova planos de fundo decorativos que entram em conflito com os materiais do sistema, preserve o conteúdo simples onde a legibilidade é mais importante e reserve as tonalidades para dar ênfase semântica ou destacar ações principais.

    Comece por um fluxo muito acessado

    Uma tela raiz de aba, uma tela de detalhes, uma sheet, uma tela de pesquisa ou um fluxo de onboarding costuma ser um alvo inicial de migração melhor do que uma reformulação completa de todo o aplicativo. Isso facilita a revisão e deixa claro quais decisões do Liquid Glass devem se tornar padrões de componentes reutilizáveis.

    Revise cuidadosamente o comportamento de fallback

    Se o destino de implantação for anterior ao iOS 26, peça ao Codex que mostre a implementação de fallback ao lado da versão com Liquid Glass. Essa etapa de revisão detecta regressões acidentais relacionadas à disponibilidade de APIs e evita lançar uma migração que só funciona no simulador mais recente.

    Tech stack

    Need

    APIs de UI do Liquid Glass

    Default options

    SwiftUI com glassEffect, GlassEffectContainer e estilos de botão com efeito de vidro

    Why it's needed

    Essas são as APIs nativas que a habilidade deve priorizar, para que o Codex remova camadas de desfoque personalizadas em vez de reinventar o sistema de materiais.

    Need

    Base da plataforma

    Default options

    iOS 26 e Xcode 26

    Why it's needed

    O Liquid Glass está disponível no SDK do iOS 26. O Codex deve compilar com o Xcode 26 e adicionar fallbacks explícitos para oferecer suporte a versões anteriores do sistema operacional.

    Need

    Validação no simulador

    Default options

    XcodeBuildMCP

    Why it's needed

    Durante uma migração visual, é importante compilar, iniciar, capturar telas e inspecionar logs, especialmente ao revisar vários estados e tamanhos de dispositivo.

    Need Default options Why it's needed
    APIs de UI do Liquid Glass SwiftUI com glassEffect , GlassEffectContainer e estilos de botão com efeito de vidro Essas são as APIs nativas que a habilidade deve priorizar, para que o Codex remova camadas de desfoque personalizadas em vez de reinventar o sistema de materiais.
    Base da plataforma iOS 26 e Xcode 26 O Liquid Glass está disponível no SDK do iOS 26. O Codex deve compilar com o Xcode 26 e adicionar fallbacks explícitos para oferecer suporte a versões anteriores do sistema operacional.
    Validação no simulador XcodeBuildMCP Durante uma migração visual, é importante compilar, iniciar, capturar telas e inspecionar logs, especialmente ao revisar vários estados e tamanhos de dispositivo.

    Casos de uso relacionados