Ejecutar pruebas en su pipeline

Una prueba, cualquier pipeline

gtr-cli, el ejecutor de línea de comandos, ejecuta una prueba exactamente igual que el botón Ejecutar prueba: las mismas comprobaciones, el mismo informe, el mismo historial.Añade lo que necesita un pipeline: un código de salida, archivos de resultados que su herramienta de CI entiende, y todas las evidencias de un fallo en una sola carpeta.

jobs:  gui-tests:    runs-on: [self-hosted, windows]    steps:      - run: gtr-cli run tests --format github --junit results.xml

Preparar la máquina de compilación

Una prueba de GUI se reproduce en una pantalla real, así que la máquina que la ejecuta necesita una.

Cree la clave en su página de cuenta, en Claves de máquina, y ejecute esto una vez en el agente, con la cuenta de Windows que usa el pipeline:

gtr-cli login --key GTS-XXXX-XXXX-XXXX-XXXX

gtr-cli whoami indica si el agente tiene la sesión iniciada y hasta cuándo.Sin sesión, una ejecución no empieza: muestra una línea que empieza por COULD NOT RUN y termina con el código de salida 3.

Agentes de compilación: claves de máquina

Su primer comando

En un terminal de la máquina de compilación, ejecute todas las pruebas de una carpeta:

gtr-cli run tests --countdown 0 --junit results\junit.xml --artifacts results\artifacts

--countdown 0 empieza de inmediato (no hay nadie ante la pantalla), --junit escribe el archivo de resultados que lee su herramienta de CI, y --artifacts reúne los vídeos, los informes y las imágenes de los fallos en una sola carpeta.

gtr-cli check tests

Lo que recibe su pipeline

Las ejecuciones también quedan en la carpeta de resultados de cada prueba, así que el Historial de GUI Test Runner-Recorder muestra las ejecuciones del pipeline junto a las suyas.

Ejemplos listos para usar

jobs:
  gui-tests:
    runs-on: [self-hosted, windows]
    steps:
      - uses: actions/checkout@v4
      - run: gtr-cli run tests --countdown 0 --format github --junit results\junit.xml --summary results\summary.md --artifacts results\artifacts
      - uses: actions/upload-artifact@v4
        if: always()
        with:
          name: gui-test-results
          path: results

Componer un comando sin escribirlo

En cualquiera de las dos aplicaciones, Línea de comandos y CI/CD (en el menú Archivo de GUI Test Studio, en el menú Prueba de GUI Test Runner-Recorder) compone el comando por usted: marque las opciones que quiera, copie el resultado, o copie el fragmento ya preparado para su herramienta de CI con sus rutas reales.Su pestaña Referencia explica cada opción.

Ampliar

Opciones que usará

gtr-cli help

Notificar los fallos a Jira

Una prueba fallida puede convertirse por sí sola en una incidencia de Jira: los pasos para reproducir, las imágenes esperada y encontrada con lo que cambió resaltado, el informe de defecto en PDF y las evidencias.El mismo defecto visto de nuevo, en otra compilación, navegador o dispositivo, añade un comentario a su incidencia abierta en lugar de crear una segunda.

gtr-cli run tests --countdown 0 --jira on-failure --jira-project SCRUM --jira-labels ui-regression

La conexión procede del entorno, así que el token nunca aparece en una línea de comandos ni en un registro de compilación: JIRA_BASE_URL (su sitio de Jira), JIRA_USER_EMAIL y JIRA_API_TOKEN.En su herramienta de CI, guarde el token como un secreto o un parámetro de contraseña.En un equipo en el que GUI Test Runner-Recorder está conectado a Jira, se usa en su lugar la conexión guardada.

El flujo completo, con una incidencia real y un build real: Conectar Jira al informe de confianza.

Aplicaciones web en una máquina de compilación

Una prueba grabada en una aplicación web abre su navegador por sí misma, en modo kiosco a pantalla completa, y lo cierra al final.En una máquina de compilación eso requiere el tamaño de pantalla y la escala de la grabación, un escritorio con sesión iniciada y desbloqueado, y una ejecución que termine por su propio límite de tiempo.Abrir aplicación web explica qué ocurre en caso contrario y qué hacer.

Las mismas notas están en la propia herramienta:

gtr-cli help web-apps

Todos los navegadores y dispositivos, en el pipeline

Una prueba web hecha para varios navegadores y dispositivos los ejecuta todos con --branch all, cada uno con su propia entrada en el archivo JUnit y su propio historial.Los teléfonos, las tabletas y las demás ramas sin ventana se ejecutan en paralelo, así que no necesitan una pantalla propia.gtr-cli info muestra el nombre de cada una, y gtr-cli generate hace las que aún faltan.Consulte Cada navegador y cada dispositivo a partir de una sola grabación.

gtr-cli generate tests --branch missing
gtr-cli run tests --branch all --countdown 0 --junit results\junit.xml

Compartir pruebas sin su grabación

Un archivo de prueba contiene su grabación, que usted necesita para editar pero no para ejecutar.Archivo, Exportar como prueba ligera de ejecutor (.GTR) en GUI Test Studio escribe la misma prueba sin ella: un archivo mucho más pequeño para una máquina de compilación o para un compañero que solo ejecuta pruebas. gtr-cli y GUI Test Runner-Recorder ejecutan los archivos .GTR como cualquier prueba.

Cuándo usar una prueba de ejecutor

Úsela allí donde una prueba solo se ejecuta: una máquina de compilación, el ordenador de un tester, un conjunto de pruebas que tiene que viajar o guardarse con su código.La ejecución de una prueba de ejecutor da el mismo resultado y el mismo informe que su prueba.

Conserve la prueba original

Una prueba de ejecutor no se puede editar: GUI Test Studio no la abre.Conserve el .GTS como original, edítelo ahí y exporte de nuevo después de un cambio.GUI Test Runner-Recorder también puede exportar una, desde su menú Prueba o con el botón de exportar de la página de la prueba.

Una prueba web con varios navegadores y dispositivos

La exportación pregunta qué incluir.Todos los navegadores y dispositivos pone todas las ramas generadas en un solo archivo, listo para --branch all.Solo la grabación, o solo la rama que se muestra, crea una prueba de ejecutor solo de esa.Una prueba de ejecutor solo se puede ejecutar: los navegadores y dispositivos nuevos se hacen a partir del .GTS.

Guardar las pruebas con su código

Las pruebas son archivos corrientes: guárdelas en su repositorio junto al código que prueban, y cada rama llevará las pruebas que le corresponden.