ce-test-xcode

Acerca de ce-test-xcode

Ce-test-xcode compila, instala y prueba aplicaciones de iOS en el simulador utilizando el servidor XcodeBuildMCP, capturando capturas de pantalla y registros, y verificando el comportamiento de la aplicación. Toma un argumento opcional para el nombre del esquema, o "current" para utilizar el esquema predeterminado o el último utilizado. Los requisitos previos incluyen Xcode con las herramientas de línea de comandos, un servidor MCP XcodeBuildMCP conectado, un proyecto o espacio de trabajo de Xcode válido y al menos un simulador de iOS disponible. La invocación del modelo está desactivada, por lo que se ejecuta como un comando explícito.

El flujo de trabajo primero verifica que XcodeBuildMCP esté conectado llamando a su herramienta list_simulators, y se detiene con las instrucciones de instalación si no lo está. Luego descubre proyectos y esquemas (discover_projs, list_schemes), inicia un simulador preferido como iPhone 15 Pro por UUID, y compila la aplicación con build_ios_sim_app, informando errores específicos en caso de fallo. Si tiene éxito, instala y lanza la aplicación (install_app_on_simulator, launch_app_on_simulator) y comienza la captura de registros. Para cada pantalla clave, toma una captura de pantalla descriptiva, revisa la representación y el contenido, y verifica los registros en busca de bloqueos, excepciones, mensajes de nivel de error y solicitudes de red fallidas.

La habilidad documenta una limitación conocida de la plataforma: los toques simulados no pueden activar reconocedores de gestos en vistas de texto de SwiftUI con enlaces AttributedString en línea, por lo que solicita un toque manual u ofrece xcrun simctl openurl como alternativa. Pausa para la verificación humana en flujos que requieren interacción con el dispositivo, incluido Iniciar sesión con Apple, notificaciones push, compras dentro de la aplicación, cámara y fotos, y ubicación, utilizando la herramienta de pregunta de bloqueo de la plataforma como AskUserQuestion. En caso de fallo de prueba, documenta el error con una captura de pantalla y registros, y pregunta si corregirlo ahora o omitirlo. Cierra con una tabla de resumen de pruebas estructurada y un paso de limpieza que detiene la captura de registros y opcionalmente apaga el simulador. También se integra con el flujo de trabajo ce-code-review, que puede generar un agente para ejecutar esta habilidad en solicitudes de extracción (PR) que tocan código de iOS.

Preguntas frecuentes

¿Qué servidor MCP requiere esta habilidad?

Requiere que el servidor MCP XcodeBuildMCP esté conectado. El flujo de trabajo confirma la disponibilidad llamando a su herramienta list_simulators y no continuará hasta que XcodeBuildMCP funcione, proporcionando instrucciones de instalación con Homebrew y npx si falta.

¿Cómo elijo qué esquema probar?

Pasa el nombre del esquema como argumento, o pasa "current" para utilizar el esquema predeterminado o el último utilizado. La habilidad descubre proyectos y esquemas con discover_projs y list_schemes, y utiliza el argumento proporcionado si se da uno.

¿Por qué no funcionan los toques en los enlaces de texto de SwiftUI en el simulador?

Los toques simulados no activan reconocedores de gestos en vistas de texto de SwiftUI con enlaces AttributedString en línea porque esos enlaces no se exponen como elementos separados en el árbol de accesibilidad. La habilidad te solicita tocar manualmente, y puede utilizar xcrun simctl openurl para abrir una URL de destino conocida directamente como alternativa.

¿Cuándo pausa para la entrada humana?

Pausa para flujos que requieren interacción real con el dispositivo, como Iniciar sesión con Apple, notificaciones push, compras dentro de la aplicación, cámara y fotos, y ubicación, preguntando a través de la herramienta de pregunta de bloqueo de la plataforma y nunca omitiendo silenciosamente la verificación.

¿Qué hace después de que falla una prueba?

Documenta el fallo con una captura de pantalla del estado de error, registros de consola capturados y notas de reproducción, y luego pregunta si corregirlo ahora (depurar, proponer una corrección, volver a compilar y volver a probar) o omitirlo y continuar probando otras pantallas.