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
Theme
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 Advanced
Time horizon 1h

Use o Codex e o plugin Build iOS Apps para revisar a interface atual do aplicativo no iPhone e no iPad e substituir camadas personalizadas de desfoque ou de materiais pelo Liquid Glass nativo. Para migrar com segurança, verifique a disponibilidade das APIs do iOS 26 e valide as mudanças no simulador.

Best for

  • Aplicativos SwiftUI existentes que precisam de um plano prático para adotar o Liquid Glass no iOS 26 e para os quais uma proposta genérica de reformulação da interface seria insuficiente
  • Equipes que querem usar o Codex para revisar cartões, painéis modais, barras de abas, barras de ferramentas e botões de ação personalizados e depois implementar a migração por etapas
  • Aplicativos que ainda oferecem suporte a versões anteriores do iOS e precisam usar `#available(iOS 26, *)` para preservar uma alternativa visual compatível ao reformular a interface

Contents

    ← All use cases

    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 plugin Build iOS Apps para revisar a interface atual do aplicativo no iPhone e no iPad e substituir camadas personalizadas de desfoque ou de materiais pelo Liquid Glass nativo. Para migrar com segurança, verifique a disponibilidade das APIs do iOS 26 e valide as mudanças no simulador.

    Advanced
    1h

    Use o Codex e o plugin Build iOS Apps para revisar a interface atual do aplicativo no iPhone e no iPad e substituir camadas personalizadas de desfoque ou de materiais pelo Liquid Glass nativo. Para migrar com segurança, verifique a disponibilidade das APIs do iOS 26 e valide as mudanças no simulador.

    Advanced
    1h

    Best for

    • Aplicativos SwiftUI existentes que precisam de um plano prático para adotar o Liquid Glass no iOS 26 e para os quais uma proposta genérica de reformulação da interface seria insuficiente
    • Equipes que querem usar o Codex para revisar cartões, painéis modais, barras de abas, barras de ferramentas e botões de ação personalizados e depois implementar a migração por etapas
    • Aplicativos que ainda oferecem suporte a versões anteriores do iOS e precisam usar `#available(iOS 26, *)` para preservar uma alternativa visual compatível ao reformular a interface

    Skills & Plugins

    • Use as habilidades de Liquid Glass no SwiftUI, de padrões de interface do SwiftUI e de depuração no simulador para modernizar as telas do aplicativo, 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 interface do SwiftUI e de depuração no simulador para modernizar as telas do aplicativo, adotar efeitos de vidro nativos e verificar o resultado em simuladores do iOS 26.

    Starter prompt

    Use o plugin Build iOS Apps e sua habilidade SwiftUI Liquid Glass para migrar um dos fluxos mais usados deste aplicativo para o Liquid Glass. Restrições: - Faça a migração para o iOS 26 com o Xcode 26. Use `#available(iOS 26, *)` para manter uma alternativa sem efeito de vidro nas versões anteriores do iOS compatíveis com o aplicativo. - Revise o fluxo antes de fazer alterações. Identifique quais fundos personalizados, camadas de desfoque, chips, botões, painéis modais e barras de ferramentas devem usar o Liquid Glass nativo. Indique também quais áreas devem exibir apenas o conteúdo, sem esse efeito. - Dê preferência aos controles do sistema e a APIs nativas como `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)` e `.buttonStyle(.glassProminent)` em vez de usar desfoques personalizados. Use `glassEffectID` com `@Namespace` apenas quando uma transição em que um elemento se transforma em outro melhorar o fluxo. - Aplique `glassEffect` depois dos modificadores de layout e de aparência, mantenha as formas consistentes e use `.interactive()` apenas em controles que respondem ao toque. - Use o XcodeBuildMCP para compilar o aplicativo e executá-lo em um simulador do iOS 26. Faça capturas de tela do fluxo migrado, identifique o esquema e o simulador usados e informe exatamente quais verificações realizou. Entregue: - um plano de migração conciso para o fluxo - o trecho do aplicativo já migrado para o Liquid Glass - uma descrição de como o fluxo funciona sem o efeito de vidro em dispositivos com versões anteriores ao iOS 26 - as etapas de validação no simulador e as capturas de tela usadas
    Use o plugin Build iOS Apps e sua habilidade SwiftUI Liquid Glass para migrar um dos fluxos mais usados deste aplicativo para o Liquid Glass. Restrições: - Faça a migração para o iOS 26 com o Xcode 26. Use `#available(iOS 26, *)` para manter uma alternativa sem efeito de vidro nas versões anteriores do iOS compatíveis com o aplicativo. - Revise o fluxo antes de fazer alterações. Identifique quais fundos personalizados, camadas de desfoque, chips, botões, painéis modais e barras de ferramentas devem usar o Liquid Glass nativo. Indique também quais áreas devem exibir apenas o conteúdo, sem esse efeito. - Dê preferência aos controles do sistema e a APIs nativas como `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)` e `.buttonStyle(.glassProminent)` em vez de usar desfoques personalizados. Use `glassEffectID` com `@Namespace` apenas quando uma transição em que um elemento se transforma em outro melhorar o fluxo. - Aplique `glassEffect` depois dos modificadores de layout e de aparência, mantenha as formas consistentes e use `.interactive()` apenas em controles que respondem ao toque. - Use o XcodeBuildMCP para compilar o aplicativo e executá-lo em um simulador do iOS 26. Faça capturas de tela do fluxo migrado, identifique o esquema e o simulador usados e informe exatamente quais verificações realizou. Entregue: - um plano de migração conciso para o fluxo - o trecho do aplicativo já migrado para o Liquid Glass - uma descrição de como o fluxo funciona sem o efeito de vidro em dispositivos com versões anteriores ao iOS 26 - as etapas de validação no simulador e as capturas de tela usadas

    Use o iOS 26 como ponto de partida

    Comece a adoção do Liquid Glass pela migração para o iOS 26 e o Xcode 26. Recompile o aplicativo com o SDK do iOS 26 e confira quais mudanças os controles padrão do SwiftUI já incorporam automaticamente. Só então peça ao Codex que redesenhe os elementos personalizados que ainda parecem planos demais, pesados demais ou pouco integrados à interface do sistema.

    Se o aplicativo ainda oferece suporte a versões anteriores do iOS, deixe esse requisito claro desde o início. A habilidade de Liquid Glass para SwiftUI do plugin Build iOS Apps deve usar #available(iOS 26, *) para restringir o uso das novas APIs exclusivas do efeito de vidro e manter uma alternativa que preserve a legibilidade em dispositivos mais antigos.

    Use o plugin para iOS

    Use o plugin Build iOS Apps quando quiser que o Codex altere a interface em SwiftUI e verifique o resultado no simulador. Ao adotar o Liquid Glass, peça ao Codex que analise um fluxo, migre algumas superfícies, execute o aplicativo em um simulador de iOS 26 e faça capturas de tela antes de ampliar o escopo.

    O plugin inclui uma habilidade de Liquid Glass para SwiftUI. Vale incluir no prompt as orientações que ela segue por padrão:

    • Prefira recursos nativos como glassEffect, GlassEffectContainer, estilos de botão com efeito de vidro e transições com glassEffectID em vez de criar visualizações personalizadas com desfoque.
    • Aplique .glassEffect(...) depois dos modificadores de layout e de aparência para que o material acompanhe a forma final desejada.
    • Agrupe os elementos de vidro relacionados em um GlassEffectContainer quando várias superfícies aparecerem juntas.
    • Use .interactive() apenas em botões, chips e controles que respondem ao toque.
    • Mantenha o formato dos cantos, a tonalidade e o espaçamento consistentes em toda a funcionalidade. Evite aplicar um efeito de vidro diferente a cada elemento.
    • Mantenha uma alternativa sem efeito de vidro para versões anteriores ao iOS 26.

    Para saber mais sobre a instalação de plugins e habilidades, consulte a documentação de plugins e habilidades.

    Assista às sessões da WWDC

    Estas sessões da WWDC25 são boas referências para consultar antes de pedir ao Codex que refatore um fluxo já em produção:

    Peça um plano de migração e depois a implementação de uma parte

    A migração para o Liquid Glass funciona melhor quando o Codex trata separadamente a pergunta “onde usar o efeito de vidro?” e o pedido “escreva todo o código agora”. Peça primeiro uma análise rápida. Depois, deixe o agente implementar uma parte independente da migração e verificar o resultado no simulador.

    Dicas práticas

    Use o efeito de vidro com moderação

    O Liquid Glass deve distinguir a camada de controles do conteúdo abaixo dela, sem transformar cada cartão em um painel brilhante. Peça ao Codex que remova fundos decorativos que destoem dos materiais do sistema, mantenha o conteúdo simples onde a legibilidade for prioridade e reserve o uso de cores para transmitir significado ou destacar ações principais.

    Comece por um fluxo de uso frequente

    A tela inicial de uma aba, uma tela de detalhes, uma folha modal, uma interface de busca ou um fluxo de primeiros passos costuma ser um ponto de partida melhor do que migrar o aplicativo inteiro de uma vez. Isso facilita a revisão e ajuda a identificar quais decisões sobre o uso do Liquid Glass podem servir de padrão para componentes reutilizáveis.

    Revise o comportamento nas versões anteriores

    Se a versão mínima do iOS compatível com o aplicativo for anterior à 26, peça ao Codex que mostre a implementação alternativa lado a lado com a versão que usa Liquid Glass. Essa revisão ajuda a detectar o uso acidental de APIs indisponíveis nas versões anteriores e evita que você publique uma migração que só funciona no simulador mais recente.

    Tech stack

    Need

    APIs de interface do Liquid Glass

    Default options

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

    Why it's needed

    A habilidade deve priorizar essas APIs nativas para que o Codex remova as camadas de desfoque personalizadas sem precisar recriar o sistema de materiais.

    Need

    Versões de referência

    Default options

    iOS 26 e Xcode 26

    Why it's needed

    O Liquid Glass está disponível a partir do SDK do iOS 26. O Codex deve compilar o aplicativo com o Xcode 26 e implementar alternativas explícitas para dar suporte a versões anteriores do iOS.

    Need

    Validação no simulador

    Default options

    XcodeBuildMCP

    Why it's needed

    Durante uma migração visual, é importante compilar e abrir o aplicativo, fazer capturas de tela e examinar os logs, especialmente ao verificar como a interface se apresenta em diferentes estados e tamanhos de tela.

    Need Default options Why it's needed
    APIs de interface do Liquid Glass SwiftUI com glassEffect , GlassEffectContainer e estilos de botão com efeito de vidro A habilidade deve priorizar essas APIs nativas para que o Codex remova as camadas de desfoque personalizadas sem precisar recriar o sistema de materiais.
    Versões de referência iOS 26 e Xcode 26 O Liquid Glass está disponível a partir do SDK do iOS 26. O Codex deve compilar o aplicativo com o Xcode 26 e implementar alternativas explícitas para dar suporte a versões anteriores do iOS.
    Validação no simulador XcodeBuildMCP Durante uma migração visual, é importante compilar e abrir o aplicativo, fazer capturas de tela e examinar os logs, especialmente ao verificar como a interface se apresenta em diferentes estados e tamanhos de tela.

    Related use cases