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
Theme
Codex

Codex use case

Depura una app en el simulador de iOS

Usa Codex y XcodeBuildMCP para interactuar con tu app en el simulador de iOS, recopilar evidencia y probar cambios hasta corregir el error.

Difficulty Advanced
Time horizon 1h

Usa Codex para identificar el esquema de Xcode y el simulador adecuados, iniciar la app e inspeccionar el árbol de la interfaz. Codex puede tocar elementos, escribir texto, deslizar el dedo, guardar capturas de pantalla y registros, y conectar LLDB cuando sea necesario. Así puede partir de un informe de error impreciso, corregir el problema con un pequeño cambio y verificar el resultado.

Best for

  • Errores de interfaz que solo aparecen en Simulator después de tocar un elemento específico, desplazarse de cierta manera o seguir una secuencia concreta al completar un formulario
  • Cierres inesperados, bloqueos o fallas de navegación que requieren que Codex consulte los registros, las capturas de pantalla, el estado de la jerarquía de vistas y la traza de pila del depurador antes de editar el código
  • Equipos que quieren que Codex se encargue de reproducir el error, corregirlo y verificar la solución sin pedirle a alguien que recorra manualmente cada estado de la interfaz

Contents

    ← All use cases

    Depura una app en el simulador de iOS

    Usa Codex y XcodeBuildMCP para interactuar con tu app en el simulador de iOS, recopilar evidencia y probar cambios hasta corregir el error.

    Usa Codex para identificar el esquema de Xcode y el simulador adecuados, iniciar la app e inspeccionar el árbol de la interfaz. Codex puede tocar elementos, escribir texto, deslizar el dedo, guardar capturas de pantalla y registros, y conectar LLDB cuando sea necesario. Así puede partir de un informe de error impreciso, corregir el problema con un pequeño cambio y verificar el resultado.

    Advanced
    1h

    Usa Codex para identificar el esquema de Xcode y el simulador adecuados, iniciar la app e inspeccionar el árbol de la interfaz. Codex puede tocar elementos, escribir texto, deslizar el dedo, guardar capturas de pantalla y registros, y conectar LLDB cuando sea necesario. Así puede partir de un informe de error impreciso, corregir el problema con un pequeño cambio y verificar el resultado.

    Advanced
    1h

    Best for

    • Errores de interfaz que solo aparecen en Simulator después de tocar un elemento específico, desplazarse de cierta manera o seguir una secuencia concreta al completar un formulario
    • Cierres inesperados, bloqueos o fallas de navegación que requieren que Codex consulte los registros, las capturas de pantalla, el estado de la jerarquía de vistas y la traza de pila del depurador antes de editar el código
    • Equipos que quieren que Codex se encargue de reproducir el error, corregirlo y verificar la solución sin pedirle a alguien que recorra manualmente cada estado de la interfaz

    Skills & Plugins

    • Usa el agente de depuración de iOS con XcodeBuildMCP para compilar, iniciar e inspeccionar una app e interactuar con ella en un simulador. Luego recopila registros, capturas de pantalla y trazas de pila mientras Codex delimita las posibles causas del error.
    Skill Why use it
    Build iOS Apps Usa el agente de depuración de iOS con XcodeBuildMCP para compilar, iniciar e inspeccionar una app e interactuar con ella en un simulador. Luego recopila registros, capturas de pantalla y trazas de pila mientras Codex delimita las posibles causas del error.

    Starter prompt

    Usa el complemento Build iOS Apps y XcodeBuildMCP para reproducir este error directamente en Simulator, identificar su causa raíz y corregirlo con un pequeño cambio. Informe del error: [Describe el comportamiento esperado, el error observado y cualquier detalle que conozcas sobre la configuración de la pantalla o de la cuenta.] Restricciones: - Primero, comprueba si ya hay un proyecto, un esquema y un simulador seleccionados. Si falta alguno, identifica el proyecto o espacio de trabajo de Xcode adecuado, selecciona el esquema de la app, elige un simulador y usa esa configuración durante el resto de la sesión. - Compila e inicia la app en Simulator. Antes de interactuar con ella, confirma con una instantánea de la interfaz o una captura de pantalla que se muestra la pantalla correcta. - Sigue por tu cuenta los pasos exactos para reproducir el error en el simulador: toca los elementos, escribe, desplázate por la pantalla y desliza el dedo según corresponda. Da prioridad a las etiquetas o los identificadores de accesibilidad frente a las coordenadas. Si cambia la disposición de los elementos, vuelve a consultar la jerarquía de la interfaz antes de la siguiente acción. - Recopila evidencia durante la depuración: guarda capturas de pantalla que muestren el estado de la interfaz y registros del simulador de los momentos previos y posteriores a la falla. Si la app parece cerrarse inesperadamente o dejar de responder, captura también los marcos de pila o las variables que muestra LLDB. - Si el simulador aún no está en ejecución, inicia uno y dime qué dispositivo y sistema operativo elegiste. Si necesitas credenciales o un fixture especial, detente y pídeme solo lo que falte. - Haz el cambio de código más pequeño que corrija el error. Luego repite los pasos en el simulador y dime exactamente cómo verificaste la corrección. Incluye lo siguiente: - los pasos que ejecutó Codex para reproducir el error - las capturas de pantalla, los registros o los detalles de la pila que permitieron explicar el error - el cambio en el código y por qué funciona - el simulador y el esquema que usaste para la verificación final
    Usa el complemento Build iOS Apps y XcodeBuildMCP para reproducir este error directamente en Simulator, identificar su causa raíz y corregirlo con un pequeño cambio. Informe del error: [Describe el comportamiento esperado, el error observado y cualquier detalle que conozcas sobre la configuración de la pantalla o de la cuenta.] Restricciones: - Primero, comprueba si ya hay un proyecto, un esquema y un simulador seleccionados. Si falta alguno, identifica el proyecto o espacio de trabajo de Xcode adecuado, selecciona el esquema de la app, elige un simulador y usa esa configuración durante el resto de la sesión. - Compila e inicia la app en Simulator. Antes de interactuar con ella, confirma con una instantánea de la interfaz o una captura de pantalla que se muestra la pantalla correcta. - Sigue por tu cuenta los pasos exactos para reproducir el error en el simulador: toca los elementos, escribe, desplázate por la pantalla y desliza el dedo según corresponda. Da prioridad a las etiquetas o los identificadores de accesibilidad frente a las coordenadas. Si cambia la disposición de los elementos, vuelve a consultar la jerarquía de la interfaz antes de la siguiente acción. - Recopila evidencia durante la depuración: guarda capturas de pantalla que muestren el estado de la interfaz y registros del simulador de los momentos previos y posteriores a la falla. Si la app parece cerrarse inesperadamente o dejar de responder, captura también los marcos de pila o las variables que muestra LLDB. - Si el simulador aún no está en ejecución, inicia uno y dime qué dispositivo y sistema operativo elegiste. Si necesitas credenciales o un fixture especial, detente y pídeme solo lo que falte. - Haz el cambio de código más pequeño que corrija el error. Luego repite los pasos en el simulador y dime exactamente cómo verificaste la corrección. Incluye lo siguiente: - los pasos que ejecutó Codex para reproducir el error - las capturas de pantalla, los registros o los detalles de la pila que permitieron explicar el error - el cambio en el código y por qué funciona - el simulador y el esquema que usaste para la verificación final

    Deja que Codex se encargue de todo el ciclo en el simulador

    Este caso de uso funciona mejor cuando Codex se encarga de todo el proceso: elige el target correcto de la app, inicia la app en Simulator, inspecciona la pantalla actual, sigue los pasos para reproducir el error, recopila registros y capturas de pantalla, examina la traza de la pila si hace falta, corrige el código y repite los mismos pasos para comprobar que el error ya no ocurre.

    Usa el complemento Build iOS Apps si quieres que Codex lleve a cabo ese ciclo de forma autónoma. El flujo de depuración de iOS del complemento se basa en XcodeBuildMCP, que permite a Codex interactuar con un simulador en ejecución y recopilar las mismas evidencias que una persona normalmente reuniría a mano.

    Si XcodeBuildMCP está configurado con flujos de trabajo para automatizar el simulador y la interfaz, depurar la app y capturar registros, Codex puede encargarse de todo el ciclo de reproducción, depuración y verificación. Si Codex aún no ha elegido un proyecto, un esquema y un simulador, pídele que los identifique primero y que use esa misma configuración durante el resto de la sesión.

    Aprovecha las funciones de XcodeBuildMCP

    Puedes pedirle a Codex que realice las siguientes tareas:

    • Identificación del proyecto y del simulador: comprobar si ya sabe qué target de la app y qué simulador usar, localizar el proyecto o el espacio de trabajo de Xcode, enumerar los esquemas, buscar o iniciar un simulador y conservar esa configuración para las siguientes compilaciones y ejecuciones.
    • Compilación e inicio: compilar el target activo de la app, instalar y ejecutar la versión compilada para el simulador, volver a iniciar la app con la captura de registros activada cuando sea necesario y obtener el identificador del bundle de la app si necesita examinar sus registros de ejecución.
    • Inspección de la interfaz e interacción con ella: consultar la jerarquía de accesibilidad de la pantalla, tomar capturas de pantalla, tocar controles, escribir en campos, desplazarse por listas y realizar gestos en el simulador, como deslizar el dedo desde un borde.
    • Registros y estado del depurador: consultar los registros del simulador en tiempo real, conectar LLDB a la app en ejecución, establecer puntos de interrupción, examinar los marcos de pila y las variables locales y ejecutar comandos del depurador cuando sea necesario investigar más a fondo un cierre inesperado o un bloqueo.

    Acostúmbrate a pedirle a Codex que inspeccione el árbol de vistas antes de tocar un control. XcodeBuildMCP proporciona tanto la jerarquía de accesibilidad como las coordenadas, de modo que Codex puede dar preferencia a etiquetas estables o identificadores de elementos sin tener que adivinar en qué punto de la pantalla debe tocar.

    Convierte un reporte de error impreciso en una secuencia de pasos reproducible

    La habilidad de depuración de iOS funciona mejor cuando describes un error concreto y un resultado esperado en el prompt y luego dejas que Codex maneje la app y recopile evidencias de forma autónoma. Si se necesita iniciar sesión, usar un enlace profundo o contar con un entorno de prueba preparado de antemano, indícalo una sola vez y pídele a Codex que se detenga únicamente si la falta de ese requisito le impide avanzar.

    Consejos prácticos

    Pide evidencias además de la corrección

    Pídele a Codex que indique exactamente qué simulador y qué esquema usó y que te muestre las capturas de pantalla, los fragmentos de los registros y los detalles de la pila en los que basó su explicación del error. Con esa información es mucho más fácil revisar el parche final que con un simple “Creo que esto debería corregir el error”.

    Da prioridad a las etiquetas de accesibilidad frente a las coordenadas

    Si Codex tiene que usar coordenadas para tocar un control porque este carece de una etiqueta estable o un identificador de accesibilidad, pídele que lo señale. Esto suele indicar que la corrección también debería incluir un pequeño ajuste para facilitar las pruebas de la interfaz.

    Aborda un solo error por ejecución

    La depuración con un simulador ofrece muchas posibilidades, pero es más fácil confiar en el proceso cuando cada prompt se centra en una sola forma en que puede fallar la app. Pídele a Codex que termine de reproducir el error, corregirlo y verificar la corrección antes de pasar a otros problemas relacionados.

    Tech stack

    Need

    Automatización del simulador

    Default options

    XcodeBuildMCP

    Why it's needed

    Las herramientas actuales permiten configurar el simulador, compilar e iniciar la app, obtener instantáneas de la interfaz, simular toques, escritura y gestos, guardar capturas de pantalla y registros, y conectar el depurador.

    Need

    Flujo de trabajo del agente

    Why it's needed

    El agente de depuración de iOS del complemento guía a Codex para que reproduzca el error primero en el simulador, recopile evidencia y verifique 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 muestren el estado exacto de la interfaz antes y después de la corrección.

    Need Default options Why it's needed
    Automatización del simulador XcodeBuildMCP Las herramientas actuales permiten configurar el simulador, compilar e iniciar la app, obtener instantáneas de la interfaz, simular toques, escritura y gestos, guardar capturas de pantalla y registros, y conectar el depurador.
    Flujo de trabajo del agente Complemento Build iOS Apps El agente de depuración de iOS del complemento guía a Codex para que reproduzca el error primero en el simulador, recopile evidencia y verifique 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 muestren el estado exacto de la interfaz antes y después de la corrección.

    Related use cases