For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal
Codex

Codex use case

Adopta Liquid Glass

Usa Codex para migrar una app existente de SwiftUI a Liquid Glass con las API de iOS 26 y Xcode 26.

Difficulty Avanzado
Time horizon 1 h

Usa Codex y el complemento Build iOS Apps para auditar la IU existente de iPhone y iPad, reemplazar las pilas personalizadas de desenfoque o materiales por implementaciones nativas de Liquid Glass y migrar de forma segura mediante verificaciones de disponibilidad de iOS 26 y validación en el simulador.

Ideal para

  • Apps existentes de SwiftUI que necesitan un plan práctico para migrar a Liquid Glass en iOS 26, no un planteamiento impreciso de rediseño
  • Equipos que quieren que Codex audite tarjetas personalizadas, hojas modales, barras de pestañas, barras de herramientas y botones de acción, y luego implemente la migración por partes
  • Apps que aún admiten versiones anteriores de iOS y necesitan alternativas con `#available(iOS 26, *)` en vez de un rediseño visual irreversible

Contents

    ← Todos los casos de uso

    Adopta Liquid Glass

    Usa Codex para migrar una app existente de SwiftUI a Liquid Glass con las API de iOS 26 y Xcode 26.

    Usa Codex y el complemento Build iOS Apps para auditar la IU existente de iPhone y iPad, reemplazar las pilas personalizadas de desenfoque o materiales por implementaciones nativas de Liquid Glass y migrar de forma segura mediante verificaciones de disponibilidad de iOS 26 y validación en el simulador.

    Avanzado
    1 h

    Usa Codex y el complemento Build iOS Apps para auditar la IU existente de iPhone y iPad, reemplazar las pilas personalizadas de desenfoque o materiales por implementaciones nativas de Liquid Glass y migrar de forma segura mediante verificaciones de disponibilidad de iOS 26 y validación en el simulador.

    Avanzado
    1 h

    Ideal para

    • Apps existentes de SwiftUI que necesitan un plan práctico para migrar a Liquid Glass en iOS 26, no un planteamiento impreciso de rediseño
    • Equipos que quieren que Codex audite tarjetas personalizadas, hojas modales, barras de pestañas, barras de herramientas y botones de acción, y luego implemente la migración por partes
    • Apps que aún admiten versiones anteriores de iOS y necesitan alternativas con `#available(iOS 26, *)` en vez de un rediseño visual irreversible

    Habilidades y complementos

    • Usa las habilidades de Liquid Glass para SwiftUI, de patrones de IU de SwiftUI y de depuración del simulador para modernizar las pantallas de iOS, adoptar efectos nativos de Liquid Glass y verificar el resultado en simuladores de iOS 26.
    Skill Why use it
    Build iOS Apps Usa las habilidades de Liquid Glass para SwiftUI, de patrones de IU de SwiftUI y de depuración del simulador para modernizar las pantallas de iOS, adoptar efectos nativos de Liquid Glass y verificar el resultado en simuladores de iOS 26.

    Prompt inicial

    Usa el complemento Build iOS Apps y su habilidad de Liquid Glass para SwiftUI a fin de migrar a Liquid Glass un flujo muy utilizado de esta app. Restricciones: - Trata esta tarea como una migración a iOS 26 y Xcode 26, pero conserva mediante `#available(iOS 26, *)` una alternativa sin Liquid Glass para destinos de implementación anteriores. - Primero audita el flujo. Señala los fondos personalizados, las pilas de desenfoque, los chips, los botones, las hojas modales y las barras de herramientas que deberían adoptar Liquid Glass de forma nativa, e indica qué superficies deberían conservarse como contenido simple. - Prioriza los controles del sistema y las API nativas, como `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)` y `.buttonStyle(.glassProminent)`, en lugar de los desenfoques personalizados. Usa `glassEffectID` con `@Namespace` solo cuando una verdadera transición fluida entre formas mejore el flujo. - Aplica `glassEffect` después de los modificadores de diseño y visuales, mantén la coherencia de las formas y usa `.interactive()` únicamente en los controles que realmente respondan al tacto. - Usa XcodeBuildMCP para compilar y ejecutar la app en un simulador de iOS 26; toma capturas de pantalla del flujo migrado e indica exactamente qué esquema, simulador y verificaciones usaste. Entrega: - un plan conciso para migrar el flujo - la parte de la migración a Liquid Glass que implementaste - el comportamiento alternativo para dispositivos con versiones anteriores a iOS 26 - los pasos de validación en el simulador y las capturas de pantalla que usaste
    Usa el complemento Build iOS Apps y su habilidad de Liquid Glass para SwiftUI a fin de migrar a Liquid Glass un flujo muy utilizado de esta app. Restricciones: - Trata esta tarea como una migración a iOS 26 y Xcode 26, pero conserva mediante `#available(iOS 26, *)` una alternativa sin Liquid Glass para destinos de implementación anteriores. - Primero audita el flujo. Señala los fondos personalizados, las pilas de desenfoque, los chips, los botones, las hojas modales y las barras de herramientas que deberían adoptar Liquid Glass de forma nativa, e indica qué superficies deberían conservarse como contenido simple. - Prioriza los controles del sistema y las API nativas, como `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)` y `.buttonStyle(.glassProminent)`, en lugar de los desenfoques personalizados. Usa `glassEffectID` con `@Namespace` solo cuando una verdadera transición fluida entre formas mejore el flujo. - Aplica `glassEffect` después de los modificadores de diseño y visuales, mantén la coherencia de las formas y usa `.interactive()` únicamente en los controles que realmente respondan al tacto. - Usa XcodeBuildMCP para compilar y ejecutar la app en un simulador de iOS 26; toma capturas de pantalla del flujo migrado e indica exactamente qué esquema, simulador y verificaciones usaste. Entrega: - un plan conciso para migrar el flujo - la parte de la migración a Liquid Glass que implementaste - el comportamiento alternativo para dispositivos con versiones anteriores a iOS 26 - los pasos de validación en el simulador y las capturas de pantalla que usaste

    Partir de iOS 26 como base

    Aborda primero Liquid Glass como un proyecto de migración a iOS 26 y Xcode 26. Vuelve a compilar la app con el SDK de iOS 26, revisa qué obtienes automáticamente de los controles estándar de SwiftUI y, solo entonces, pídele a Codex que rediseñe las partes personalizadas que todavía se vean demasiado planas, pesadas o desconectadas de la interfaz del sistema.

    Si la app aún admite versiones anteriores de iOS, deja clara esa restricción desde el principio. La habilidad de Liquid Glass para SwiftUI del complemento Build iOS Apps debe condicionar el uso de las nuevas API exclusivas de Liquid Glass con #available(iOS 26, *) y conservar una alternativa que siga viéndose bien en dispositivos anteriores.

    Aprovechar el complemento para iOS

    Usa el complemento Build iOS Apps cuando quieras que Codex combine cambios en la IU de SwiftUI con una verificación en el simulador. Para trabajar con Liquid Glass, conviene pedirle a Codex que audite un flujo, migre un conjunto pequeño de superficies, ejecute la versión resultante en un simulador de iOS 26 y tome capturas de pantalla antes de ampliar el alcance.

    Ese complemento incluye una habilidad de Liquid Glass para SwiftUI con un conjunto sencillo de valores predeterminados que conviene incorporar a tu prompt:

    • Prioriza las API nativas glassEffect y GlassEffectContainer, los estilos de botones de Liquid Glass y las transiciones de glassEffectID, en lugar de las vistas de desenfoque personalizadas.
    • Aplica .glassEffect(...) después de los modificadores de diseño y visuales para que el material se ajuste a la forma final que realmente quieres.
    • Agrupa los elementos relacionados de Liquid Glass dentro de GlassEffectContainer cuando aparezcan juntas varias superficies.
    • Usa .interactive() solo en botones, chips y controles que realmente respondan al tacto.
    • Mantén uniformes la forma de las esquinas, los tintes y el espaciado en toda la funcionalidad, en lugar de mezclar tratamientos puntuales de Liquid Glass.
    • Conserva una alternativa sin Liquid Glass para destinos de implementación anteriores a iOS 26.

    Para obtener más información sobre cómo instalar complementos y habilidades, consulta nuestra documentación sobre complementos y habilidades.

    Ver las sesiones de la WWDC

    Estas sesiones de WWDC25 son un buen material de referencia antes de pedirle a Codex que refactorice un flujo real de producción:

    Pedir un plan de migración y luego una parte acotada

    Las migraciones a Liquid Glass dan mejores resultados cuando Codex separa “¿dónde debería aparecer Liquid Glass?” de “escribe todo el código ahora”. Primero pide una auditoría rápida y luego deja que el agente implemente una parte independiente con verificación en el simulador.

    Consejos prácticos

    No apliques Liquid Glass a todo

    Liquid Glass debería crear una capa de controles bien definida sobre el contenido, no convertir cada tarjeta en un panel brillante. Pide a Codex que elimine los fondos decorativos que entran en conflicto con los materiales del sistema, conserve el contenido sin efectos donde la legibilidad sea más importante y reserve los tintes para dar énfasis semántico o destacar acciones principales.

    Comienza con un flujo muy utilizado

    La pantalla raíz de una pestaña, una pantalla de detalles, una hoja modal, una interfaz de búsqueda o un flujo de incorporación suele ser un mejor primer objetivo de migración que una migración integral de toda la app. Esto facilita la revisión y deja claro qué decisiones sobre Liquid Glass deberían convertirse en patrones reutilizables de componentes.

    Revisar detenidamente el comportamiento alternativo

    Si el destino de implementación de tu app es una versión anterior a iOS 26, pide a Codex que muestre la implementación alternativa junto a la versión de Liquid Glass. Este paso de revisión permite detectar regresiones accidentales en la disponibilidad de las API y evita publicar una migración que solo funciona en el simulador más reciente.

    Tech stack

    Need

    API de IU de Liquid Glass

    Default options

    SwiftUI con glassEffect, GlassEffectContainer y estilos de botones de Liquid Glass

    Why it's needed

    Estas son las API nativas a las que la habilidad debe recurrir primero, para que Codex elimine las capas de desenfoque personalizadas en lugar de reinventar el sistema de materiales.

    Need

    Base de la plataforma

    Default options

    iOS 26 y Xcode 26

    Why it's needed

    Liquid Glass se incluye en el SDK de iOS 26. Codex debe compilar con Xcode 26 y agregar alternativas explícitas para admitir versiones anteriores del sistema operativo.

    Need

    Validación en el simulador

    Default options

    XcodeBuildMCP

    Why it's needed

    Durante una migración visual, es importante compilar e iniciar la app, tomar capturas de pantalla e inspeccionar los registros, especialmente al revisar varios estados y tamaños de dispositivo.

    Need Default options Why it's needed
    API de IU de Liquid Glass SwiftUI con glassEffect , GlassEffectContainer y estilos de botones de Liquid Glass Estas son las API nativas a las que la habilidad debe recurrir primero, para que Codex elimine las capas de desenfoque personalizadas en lugar de reinventar el sistema de materiales.
    Base de la plataforma iOS 26 y Xcode 26 Liquid Glass se incluye en el SDK de iOS 26. Codex debe compilar con Xcode 26 y agregar alternativas explícitas para admitir versiones anteriores del sistema operativo.
    Validación en el simulador XcodeBuildMCP Durante una migración visual, es importante compilar e iniciar la app, tomar capturas de pantalla e inspeccionar los registros, especialmente al revisar varios estados y tamaños de dispositivo.

    Casos de uso relacionados