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

Depurar en el simulador de iOS

Usa Codex y XcodeBuildMCP para controlar tu app en iOS Simulator, recopilar evidencia e iterar hasta encontrar una corrección.

Difficulty Avanzado
Time horizon 1 h

Usa Codex para encontrar el esquema de Xcode y el simulador correctos, iniciar la app, inspeccionar el árbol de la UI, tocar, escribir y deslizar, tomar capturas de pantalla y recopilar registros, conectar LLDB cuando sea necesario y convertir un informe de error impreciso en una pequeña corrección verificada.

Ideal para

  • Errores de UI que solo aparecen en Simulator al seguir una ruta específica de toques, desplazamientos o ingreso de datos en formularios
  • Cierres inesperados, bloqueos o problemas de navegación para los que Codex necesita registros, capturas de pantalla, el estado de la jerarquía de vistas y una traza de pila del depurador antes de editar el código
  • Equipos que quieren que Codex se encargue del ciclo de reproducción, corrección y verificación, en vez de pedirle a una persona que recorra manualmente cada estado haciendo clic

Contents

    ← Todos los casos de uso

    Depurar en el simulador de iOS

    Usa Codex y XcodeBuildMCP para controlar tu app en iOS Simulator, recopilar evidencia e iterar hasta encontrar una corrección.

    Usa Codex para encontrar el esquema de Xcode y el simulador correctos, iniciar la app, inspeccionar el árbol de la UI, tocar, escribir y deslizar, tomar capturas de pantalla y recopilar registros, conectar LLDB cuando sea necesario y convertir un informe de error impreciso en una pequeña corrección verificada.

    Avanzado
    1 h

    Usa Codex para encontrar el esquema de Xcode y el simulador correctos, iniciar la app, inspeccionar el árbol de la UI, tocar, escribir y deslizar, tomar capturas de pantalla y recopilar registros, conectar LLDB cuando sea necesario y convertir un informe de error impreciso en una pequeña corrección verificada.

    Avanzado
    1 h

    Ideal para

    • Errores de UI que solo aparecen en Simulator al seguir una ruta específica de toques, desplazamientos o ingreso de datos en formularios
    • Cierres inesperados, bloqueos o problemas de navegación para los que Codex necesita registros, capturas de pantalla, el estado de la jerarquía de vistas y una traza de pila del depurador antes de editar el código
    • Equipos que quieren que Codex se encargue del ciclo de reproducción, corrección y verificación, en vez de pedirle a una persona que recorra manualmente cada estado haciendo clic

    Habilidades y complementos

    • Usa el agente de depuración de iOS para compilar, iniciar, inspeccionar y controlar una app en un simulador con XcodeBuildMCP; luego, recopila registros, capturas de pantalla y trazas de pila mientras Codex acota el problema.
    Skill Why use it
    Build iOS Apps Usa el agente de depuración de iOS para compilar, iniciar, inspeccionar y controlar una app en un simulador con XcodeBuildMCP; luego, recopila registros, capturas de pantalla y trazas de pila mientras Codex acota el problema.

    Prompt inicial

    Usa el complemento Build iOS Apps y XcodeBuildMCP para reproducir este error directamente en Simulator, diagnosticar la causa raíz e implementar una pequeña corrección. Informe del error: [Describe the expected behavior, the actual bug, and any known screen or account setup.] Restricciones: - Primero, comprueba si ya hay un proyecto, un esquema y un simulador seleccionados. Si no es así, localiza en Xcode el proyecto o espacio de trabajo adecuado, elige el esquema de la app, selecciona un simulador y reutiliza esa configuración durante el resto de la sesión. - Compila e inicia la app en Simulator y, antes de interactuar con ella, confirma mediante una instantánea de la UI o una captura de pantalla que se muestre la pantalla correcta. - Sigue por tu cuenta la ruta exacta de reproducción tocando, escribiendo, desplazándote y deslizando en el simulador. Da preferencia a las etiquetas o los IDs de accesibilidad en vez de las coordenadas directas y vuelve a leer la jerarquía de la UI antes de la siguiente acción cuando cambie el diseño. - Recopila evidencia durante la depuración: capturas de pantalla del estado visual, registros del simulador correspondientes al momento del fallo y marcos de pila o variables de LLDB si el error parece provocar un cierre inesperado o un bloqueo. - Si aún no hay un simulador iniciado, inicia uno e indícame qué dispositivo y sistema operativo elegiste. Si se necesitan credenciales o un fixture especial, detente y pide únicamente ese dato faltante. - Haz el cambio de código más pequeño que corrija el error; luego, vuelve a ejecutar el flujo en el simulador e indícame exactamente cómo verificaste la corrección. Entrega: - los pasos de reproducción que ejecutó Codex - las capturas de pantalla, los registros o los detalles de la pila clave que explicaron el error - la corrección del código y por qué funciona - el simulador y el esquema usados para la verificación final
    Usa el complemento Build iOS Apps y XcodeBuildMCP para reproducir este error directamente en Simulator, diagnosticar la causa raíz e implementar una pequeña corrección. Informe del error: [Describe the expected behavior, the actual bug, and any known screen or account setup.] Restricciones: - Primero, comprueba si ya hay un proyecto, un esquema y un simulador seleccionados. Si no es así, localiza en Xcode el proyecto o espacio de trabajo adecuado, elige el esquema de la app, selecciona un simulador y reutiliza esa configuración durante el resto de la sesión. - Compila e inicia la app en Simulator y, antes de interactuar con ella, confirma mediante una instantánea de la UI o una captura de pantalla que se muestre la pantalla correcta. - Sigue por tu cuenta la ruta exacta de reproducción tocando, escribiendo, desplazándote y deslizando en el simulador. Da preferencia a las etiquetas o los IDs de accesibilidad en vez de las coordenadas directas y vuelve a leer la jerarquía de la UI antes de la siguiente acción cuando cambie el diseño. - Recopila evidencia durante la depuración: capturas de pantalla del estado visual, registros del simulador correspondientes al momento del fallo y marcos de pila o variables de LLDB si el error parece provocar un cierre inesperado o un bloqueo. - Si aún no hay un simulador iniciado, inicia uno e indícame qué dispositivo y sistema operativo elegiste. Si se necesitan credenciales o un fixture especial, detente y pide únicamente ese dato faltante. - Haz el cambio de código más pequeño que corrija el error; luego, vuelve a ejecutar el flujo en el simulador e indícame exactamente cómo verificaste la corrección. Entrega: - los pasos de reproducción que ejecutó Codex - las capturas de pantalla, los registros o los detalles de la pila clave que explicaron el error - la corrección del código y por qué funciona - el simulador y el esquema usados para la verificación final

    Deja todo el ciclo del simulador en manos de Codex

    Este caso de uso funciona mejor cuando Codex se encarga de todo el ciclo: elegir el destino correcto de la app, iniciar la app en Simulator, inspeccionar la pantalla actual, ejecutar los pasos de reproducción, recopilar registros y capturas de pantalla, inspeccionar una traza de pila si es necesario, aplicar un parche al código y volver a recorrer la misma ruta para demostrar que el error desapareció.

    Usa el complemento Build iOS Apps cuando quieras mantener ese ciclo en manos de agentes. Su flujo de trabajo de depuración de iOS se basa en XcodeBuildMCP, lo que permite que Codex interactúe con un simulador iniciado y recopile la misma evidencia que normalmente obtendría una persona de forma manual.

    Cuando XcodeBuildMCP está configurado con flujos de trabajo de automatización del simulador, automatización de la UI, depuración y registro, Codex puede encargarse de todo el ciclo de reproducción, depuración y verificación. Si Codex aún no ha seleccionado un proyecto, un esquema y un simulador, pídele que primero los identifique y que reutilice esa configuración durante el resto de la sesión.

    Aprovecha todo lo que XcodeBuildMCP puede hacer

    Estos son los grupos de capacidades prácticas que conviene pedirle a Codex que use:

    • Identificación del proyecto y el simulador: comprobar si Codex ya sabe qué destino de la app y qué simulador usar, localizar el proyecto o espacio de trabajo de Xcode, enumerar los esquemas, buscar o iniciar un simulador y mantener estable esa configuración para los pasos posteriores de compilación y ejecución.
    • Control de la compilación y el inicio: compilar el destino activo de la app, instalar e iniciar en el simulador la versión compilada, volver a iniciarla con captura de registros cuando sea necesario y determinar el ID del bundle de la app si Codex necesita inspeccionar registros de ejecución específicos de esa app.
    • Inspección e interacción con la UI: leer la jerarquía de accesibilidad que aparece en pantalla, tomar capturas de pantalla, tocar controles, escribir en campos, desplazarse por listas y deslizar desde los bordes o realizar otros gestos en el simulador.
    • Registros y estado del depurador: consultar en tiempo real los registros del simulador, conectar LLDB a la app en ejecución, establecer puntos de interrupción, inspeccionar marcos de pila y variables locales, y ejecutar comandos del depurador cuando sea necesario inspeccionar más a fondo un cierre inesperado o un bloqueo.

    El hábito clave es pedirle a Codex que inspeccione el árbol de vistas antes de tocar un elemento. XcodeBuildMCP expone la jerarquía de accesibilidad junto con las coordenadas, por lo que Codex puede preferir etiquetas estables o IDs de elementos en vez de adivinar posiciones en la pantalla.

    Convierte un error poco claro en un script reproducible

    La habilidad de depuración de iOS es más eficaz cuando tu prompt describe un error concreto y un resultado esperado, y luego permite que Codex controle la app y recopile evidencia de forma autónoma. Si se necesita un inicio de sesión, un deep link o un fixture de prueba, indícalo una sola vez y pídele a Codex que se detenga solo si la falta de ese dato impide continuar.

    Consejos prácticos

    Pide evidencia, no solo una corrección

    Pídele a Codex que indique exactamente qué simulador, esquema, capturas de pantalla, fragmentos de registros y detalles de la pila usó para explicar el error. Así, revisar el parche final resulta mucho más fácil que con un simple “Creo que esto debería corregirlo”.

    Prefiere las etiquetas de accesibilidad a las coordenadas

    Si Codex tiene que tocar un control mediante coordenadas porque no tiene una etiqueta estable ni un identificador de accesibilidad, pídele que lo señale explícitamente. Esto suele indicar que la corrección también debería incluir una pequeña mejora que facilite las pruebas de la UI.

    Limita cada ejecución a un solo error

    Un ciclo de depuración controlado mediante el simulador es potente, pero inspira más confianza cuando cada prompt se centra en un solo tipo de fallo. Pídele a Codex que complete un ciclo de reproducción, corrección y verificación antes de ampliar el alcance a problemas relacionados.

    Tech stack

    Need

    Automatización del simulador

    Default options

    XcodeBuildMCP

    Why it's needed

    El conjunto actual de herramientas abarca la configuración del simulador, la compilación y el inicio, las instantáneas de la UI, los toques, la escritura, los gestos, las capturas de pantalla, la captura de registros y la conexión del depurador.

    Need

    Flujo de trabajo del agente

    Why it's needed

    El agente de depuración de iOS del complemento proporciona a Codex un ciclo claro centrado en el simulador para reproducir un error, recopilar evidencia y validar la corrección después de cada cambio.

    Need

    Observabilidad de la app

    Default options

    Logger, OSLog, LLDB y capturas de pantalla de Simulator

    Why it's needed

    Codex puede usar los registros y el estado del depurador para explicar qué falló, y luego guardar capturas de pantalla que demuestren el estado exacto de la UI antes y después de la corrección.

    Need Default options Why it's needed
    Automatización del simulador XcodeBuildMCP El conjunto actual de herramientas abarca la configuración del simulador, la compilación y el inicio, las instantáneas de la UI, los toques, la escritura, los gestos, las capturas de pantalla, la captura de registros y la conexión del depurador.
    Flujo de trabajo del agente Complemento Build iOS Apps El agente de depuración de iOS del complemento proporciona a Codex un ciclo claro centrado en el simulador para reproducir un error, recopilar evidencia y validar la corrección después de cada cambio.
    Observabilidad de la app Logger , OSLog , LLDB y capturas de pantalla de Simulator Codex puede usar los registros y el estado del depurador para explicar qué falló, y luego guardar capturas de pantalla que demuestren el estado exacto de la UI antes y después de la corrección.

    Casos de uso relacionados