ce-test-xcode

À propos de ce-test-xcode

Ce-test-xcode construit, installe et teste des applications iOS sur le simulateur en utilisant le serveur XcodeBuildMCP, capturant des captures d'écran et des journaux, et vérifiant le comportement de l'application. Il prend un argument optionnel pour le nom d'un schéma, ou « current » pour utiliser le schéma par défaut ou le dernier utilisé. Les prérequis incluent Xcode avec les outils en ligne de commande, un serveur MCP XcodeBuildMCP connecté, un projet ou espace de travail Xcode valide, et au moins un simulateur iOS disponible. L'invocation de modèle est désactivée, de sorte qu'il s'exécute en tant que commande explicite.

Le flux de travail vérifie d'abord que XcodeBuildMCP est connecté en appelant son outil list_simulators, et s'arrête avec des instructions d'installation s'il ne l'est pas. Il découvre ensuite les projets et les schémas (discover_projs, list_schemes), démarre un simulateur préféré tel que l'iPhone 15 Pro par UUID, et construit l'application avec build_ios_sim_app, signalant des erreurs spécifiques en cas d'échec. En cas de succès, il installe et lance l'application (install_app_on_simulator, launch_app_on_simulator) et commence la capture des journaux. Pour chaque écran clé, il prend une capture d'écran descriptive, examine le rendu et le contenu, et vérifie les journaux pour les plantages, exceptions, messages de niveau erreur et requêtes réseau échouées.

La compétence documente une limitation connue de la plateforme : les taps simulés ne peuvent pas déclencher des gestionnaires de gestes sur les vues SwiftUI Text avec des liens AttributedString intégrés, elle invite donc à effectuer un tap manuel ou propose xcrun simctl openurl comme solution de repli. Elle met en pause la vérification humaine pour les flux nécessitant une interaction avec l'appareil, y compris Se connecter avec Apple, les notifications push, les achats intégrés, la caméra et les photos, ainsi que la localisation, en utilisant l'outil de question bloquante de la plateforme tel que AskUserQuestion. En cas d'échec du test, elle documente l'erreur avec une capture d'écran et des journaux, et demande s'il faut corriger maintenant ou ignorer. Elle se termine par un tableau récapitulatif structuré des tests et une étape de nettoyage qui arrête la capture des journaux et éteint éventuellement le simulateur. Elle s'intègre également au flux de travail ce-code-review, qui peut lancer un agent pour exécuter cette compétence sur les PR touchant au code iOS.

FAQ

Quel serveur MCP cette compétence nécessite-t-elle ?

Elle nécessite que le serveur MCP XcodeBuildMCP soit connecté. Le flux de travail confirme la disponibilité en appelant son outil list_simulators et ne progresse pas tant que XcodeBuildMCP n'est pas opérationnel, fournissant des instructions d'installation via Homebrew et npx s'il est manquant.

Comment choisir le schéma à tester ?

Transmettez le nom du schéma en tant qu'argument, ou transmettez « current » pour utiliser le schéma par défaut ou le dernier utilisé. La compétence découvre les projets et les schémas avec discover_projs et list_schemes, et utilise l'argument fourni s'il est présent.

Pourquoi les taps sur les liens de texte SwiftUI ne fonctionnent-ils pas dans le simulateur ?

Les taps simulés ne déclenchent pas les gestionnaires de gestes sur les vues SwiftUI Text avec des liens AttributedString intégrés, car ces liens ne sont pas exposés en tant qu'éléments distincts dans l'arbre d'accessibilité. La compétence vous invite à tapoter manuellement, et peut utiliser xcrun simctl openurl pour ouvrir une URL cible connue directement comme solution de repli.

Quand met-elle en pause pour une saisie humaine ?

Elle met en pause les flux nécessitant une interaction réelle avec l'appareil, tels que Se connecter avec Apple, les notifications push, les achats intégrés, la caméra et les photos, ainsi que la localisation, en posant une question via l'outil de question bloquante de la plateforme et en ne jamais ignorer silencieusement la vérification.

Que fait-elle après un échec de test ?

Elle documente l'échec avec une capture d'écran de l'état d'erreur, des journaux de console capturés et des notes de reproduction, puis demande s'il faut corriger maintenant (déboguer, proposer une correction, reconstruire et retester) ou ignorer et continuer à tester les autres écrans.