Cómo descargar e instalar PEPINO en Windows

⚡ Resumen inteligente

Cucumber instalación en Windows necesita cuatro piezas en orden: Ruby con su kit de desarrollo, el Cucumber La gema en sí, un editor como RubyMine y una biblioteca de controladores de navegador. Cada uno se instala en minutos.

  • 🔘 Ruby primero: Cucumber es una gema de Ruby, por lo que el instalador Ruby+Devkit de RubyInstaller debe estar instalado antes que cualquier otra cosa.
  • ☑️ Una orden: El comando gem install cucumber descarga la gema y sus dependencias directamente desde RubyGems en la línea de comandos.
  • Verificar inmediatamente: Al ejecutar cucumber –version se confirma que la gema se ha resuelto y que el ejecutable se encuentra en la variable de entorno PATH del sistema.
  • 🧪 Editor opcional: RubyMine ofrece resaltado de sintaxis y navegación paso a paso, pero cualquier editor que guarde texto plano ejecutará un archivo de características.
  • 🛠️ Controlador del navegador: Watir envuelve Selenium y controla el navegador; el nombre moderno de la gema es watir, no el antiguo watir-webdriver.
  • 📊 Disposición fija: Los archivos de características se encuentran en features, las definiciones de pasos en features/step_definitions, o Cucumber no puede coincidir con un paso.

Descarga e instala Cucumber on Windows con Ruby, RubyMine y Watir

Cucumber La instalación puede parecer tediosa, pero es relativamente fácil una vez que las piezas se toman en el orden correcto. Aquí está la hoja de ruta de los componentes que deben instalarse para hacer Cucumber extra.

Requisitos previos para la instalación Cucumber on Windows

Cucumber Se distribuye como una gema de Ruby, por lo que nada funciona hasta que Ruby esté presente. Confirme lo siguiente antes de descargar nada:

  • Windows 10 o posterior, 64 bits. RubyInstaller ya no recomienda la compilación de 32 bits a menos que dependa de DLLs nativas de 32 bits u objetos COM.
  • Derechos de administrador. El instalador escribe en la carpeta Archivos de programa y modifica la variable de entorno PATH.
  • Una conexión a internet. Ambos comandos de instalación de gemas que aparecen a continuación obtienen paquetes de RubyGems.
  • Aproximadamente 1 GB de espacio libre en disco para Ruby más el kit de desarrollo MSYS2, y aún más si añades RubyMine.
  • Un navegador para automatizar. Watir controladores Chrome, Edge o Firefox atravesar Selenium, por lo que debe instalarse al menos uno.

Hay dos comandos que conviene recordar para más adelante: rubí -v imprime la versión Ruby y gema -v Imprime la versión de RubyGems. Si alguna de las dos opciones falla, significa que la variable PATH no se actualizó y que se debe volver a ejecutar el instalador en lugar de depurarlo.

Instalar Ruby y DevKit

Empiece con el paquete Ruby+Devkit, que incluye la cadena de herramientas del compilador que necesitan las gemas con extensiones en C.

Paso 1) Vaya a https://rubyinstaller.org/downloads/ y seleccione un instalador. La página de descarga se muestra a continuación.

Página de descargas de RubyInstaller que enumera los instaladores de Ruby y Ruby+Devkit.

⚠️ Nota de versión: El archivo DevKit separado al que se refiere el tutorial original ha sido reemplazado por la cadena de herramientas MSYS2, que Kit de desarrollo Ruby+ El instalador incluye paquetes como un componente seleccionable. RubyInstaller actualmente recomienda la compilación Ruby+Devkit 4.0.X (x64) para nuevos usuarios, y el kit se actualiza más adelante con Instalación de ridk en lugar de volver a ejecutar dk.rb. Los pasos que se describen a continuación no sufren cambios.

Paso 2) Abra el archivo descargado. En la primera pantalla:

  1. Aceptar la licencia
  2. Haga clic en el botón Siguiente

Pantalla del acuerdo de licencia del instalador Ruby con el botón Siguiente.

Paso 3) En la siguiente pantalla:

  1. Seleccione su directorio de instalación
  2. Seleccione todas las opciones
  3. Haga clic en Instalar

Elegir el directorio de instalación de Ruby y seleccionar todas las opciones del instalador.

Paso 4) En la siguiente pantalla, haga clic en Siguiente.

Pantalla de selección de componentes del instalador Ruby antes de que comience la copia.

Paso 5) Espere a que finalice la instalación.

Progreso de la instalación de Ruby mientras se copian los archivos al disco.

Paso 6) Haga clic en Finalizar.

Pantalla final del instalador Ruby con el botón Finalizar

Paso 7) Una vez completada la instalación, ejecute Ruby desde el Windows Menu de inicio.

Windows Entrada del menú Inicio que abre el símbolo del sistema con Ruby

Paso 8) Verá un indicador de comandos de Ruby similar al siguiente: Windows ventana de comandos.

La ventana del símbolo del sistema de Ruby está lista para aceptar comandos de gemas.

Instale Cucumber

Con Ruby en la variable PATH, la gema en sí se ejecuta con un solo comando.

Paso 1) Escriba gema instalar pepino en el símbolo del sistema de Ruby. Este comando descarga e instala Cucumber en la propia línea de comandos.

Se escribió `gem install cucumber` en la consola de Ruby.

Después de unos segundos el Cucumber El procedimiento de instalación se inicia e informa de cada dependencia que descarga.

Cucumber Salida de la instalación de gemas que enumera las dependencias que se están instalando.

Paso 2) Para verificar si Cucumber instalado correctamente, tipo versión pepinoTenga en cuenta los dos guiones; un solo guion no es una opción larga válida.

El comando cucumber --version imprime la versión instalada. Cucumber versión

Instalar IDE RubyMine

No es estrictamente necesario un editor, pero RubyMine entiende Gherkin y puede pasar directamente de un paso a su definición. Sigue los pasos a continuación para instalarlo.

Pantalla de bienvenida del asistente de configuración de RubyMine

Paso 1) Haga clic en Siguiente para continuar con la instalación de RubyMine.

Primera página del instalador de RubyMine con el botón Siguiente.

Paso 2) Elija la ubicación de instalación.

Seleccionar la carpeta de instalación de RubyMine

Paso 3) Configure las opciones de instalación.

Opciones de instalación de RubyMine, como accesos directos y asociaciones de archivos.

Paso 4) Elija la carpeta del menú Inicio.

Seleccionar la carpeta del menú Inicio para el acceso directo de RubyMine

Paso 5) Haga clic en Instalar.

El instalador de RubyMine está listo para copiar archivos después de hacer clic en Instalar.

Paso 6) Haga clic en Finalizar.

Pantalla de configuración completada de RubyMine con el botón Finalizar

Paso 7) Seleccione No importar la configuración.

Diálogo de importación de configuración en el primer lanzamiento de RubyMine

Paso 8) Haga clic en Evaluar.

Ventana de activación de licencia de RubyMine con la opción Evaluar

Paso 9) Acepte la licencia.

Aceptación del acuerdo de licencia de RubyMine

Paso 10) Elija Omitir restantes y Establecer valores predeterminados.

Pantalla de personalización inicial de RubyMine con las opciones Omitir lo restante y Establecer valores predeterminados.

Paso 11) Abra el editor.

Pantalla de bienvenida de RubyMine con la opción Abrir

Paso 12) Crear un nuevo proyecto.

Nuevo diálogo de proyecto en RubyMine

⚠️ Nota de versión: RubyMine es un servicio de pago. JetBrains producto con una evaluación por tiempo limitado, que es lo que inicia el botón Evaluar en el Paso 8. Una alternativa gratuita es Visual Studio Code con un Rubí y un Cucumber Extensión (Gherkin); el resto de este tutorial funciona de la misma manera en ambos editores.

Instalar watir-webdriver

Cucumber solo ejecuta los pasos. Algo más tiene que abrir el navegador, y ese trabajo le corresponde a Watir, un envoltorio Ruby alrededor SeleniumSi prefiere controlar el navegador directamente, el mismo proyecto puede llamar a una función simple. Script de WebDriver.

Paso 1) Haga clic en Iniciar el símbolo del sistema con Ruby y ejecuta el comando de instalación gem install watir-webdriver.

Ejecutando gem install watir-webdriver en la consola de Ruby

Paso 2) La gema watir-webdriver se instala correctamente.

Salida de la consola que confirma la instalación de la gema watir-webdriver

⚠️ Nota de desuso: La gema watir-webdriver se integró en la principal. agua gema en Watir 6.0, y su propio repositorio ahora solo dirige a los usuarios al reemplazo. En una nueva máquina ejecuta Instalación de gemas watir En cambio, el comando histórico anterior se mantiene porque es lo que muestran las capturas de pantalla.

Cucumber Estructura de carpetas del proyecto

Cucumber Descubre los archivos por convención, no por configuración, por lo que la estructura importa más de lo que parece a primera vista. Un proyecto mínimo tiene este aspecto:

Path Reservaciones
caracteristicas/ Cada archivo .feature, escrito en Gherkin. Cucumber Las búsquedas se realizan aquí por defecto.
características/definiciones_de_pasos/ Los archivos Ruby cuyos bloques coinciden con cada línea Given, When y Then.
características/soporte/ El código de configuración se carga antes de que se ejecute cualquier paso, como por ejemplo env.rb, que es donde normalmente se abre y se cierra el navegador.

Dos reglas evitan mucha confusión posterior. Cucumber ignora la palabra clave cuando coincide con un paso, por lo que Dado que tengo una variable y Entonces tengo una variable colisionar con la misma definición. Y el texto del paso en el archivo de características debe coincidir exactamente con la expresión regular en el archivo de pasos, incluyendo la puntuación.

Nombre Cucumber Script

El ejemplo que aparece a continuación multiplica dos números, lo cual es suficiente para demostrar que el archivo de características, el archivo de pasos y la gema se comunican entre sí.

Paso 1) Abra el editor RubyMine desde el Windows Menu de inicio.

Abriendo RubyMine desde el Windows menú de inicio

El panel de control de RubyMine aparece como se muestra a continuación.

El panel de control de RubyMine se muestra después de que se abre el editor.

Paso 2) Crea un nuevo proyecto en el editor de RubyMine.

Iniciar un nuevo proyecto desde el panel de control de RubyMine

Dale un nombre y una ubicación al proyecto, y luego confírmalo.

Introducir el nombre y la ubicación del proyecto en el cuadro de diálogo de nuevo proyecto.

Paso 3) Cree un directorio de archivos.

Creación de un nuevo directorio dentro del proyecto RubyMine

El nuevo directorio aparece en el árbol del proyecto.

Árbol del proyecto que muestra el directorio de características recién creadas

Paso 4) Crear y guardar un archivo en tucarpeta/características/ con el nombre tuarchivo.característica.

Creación del archivo de características dentro del directorio features

Confirma que el nombre del archivo termine con la extensión .feature.

Nombrar el nuevo archivo con la extensión .feature

Paso 5) Para ejecutar nuestro escenario, guarde los siguientes comandos en el archivo de características.

Archivo de características abierto en el editor RubyMine listo para el escenario.

Code:

Feature: Multiplication 
I multiply two numbers 
	Scenario: multiply a and b 
		Given I have variable a 
		And I have variable b 
		When I multiplication a and b 
		Then I display the Result

Paso 6) Ahora ejecute el primer archivo de características.

Haga clic en Iniciar el símbolo del sistema con Ruby y ejecuta el comando cucumber desde la carpeta del proyecto.

Iniciar el símbolo del sistema de Ruby para ejecutar el archivo de características.

La consola muestra el resultado como se indica a continuación.

Salida de la consola desde el primero Cucumber ejecución del archivo de características

Paso 7) Cree el archivo de definición de pasos para el archivo de características.

Crea una nueva carpeta en el editor RubyMine.

Creación de una nueva carpeta en el proyecto RubyMine para las definiciones de pasos.

Nombrar la nueva carpeta de definiciones de pasos

Paso 8) Guarda el archivo en tu_carpeta/características/definiciones_de_pasos con el nombre paso_de_prueba.rb.

Guardar un nuevo archivo Ruby dentro de la carpeta de definiciones de pasos.

Introduciendo test_step.rb como nombre del archivo de definición del paso.

Paso 9) Escriba el siguiente código en el archivo de pasos.

El archivo de definición de pasos se abre en el editor antes de agregar el código.

Code:

Given(/^I have variable a$/) do
@a = 50
end

And(/^I have variable b$/) do
@b = 70
end

When(/^I multiplication a and b$/) do 
@mul = @a * @b
end

Then(/^I display the Result$/) do 
puts "Multiplication of #{@a} and #{@b} is #{@mul}"
end

Paso 10) Ahora ejecute de nuevo el archivo de características.

Ejecutar el archivo de características por segunda vez después de que se hayan definido los pasos.

El resultado se imprime en la consola y se informa que cada paso se ha superado con éxito.

Cucumber Salida de la consola después de que el archivo de características se ejecute con los pasos definidos.

Preguntas frecuentes sobre bancarrota Cucumber Errores de instalación y cómo solucionarlos

La mayoría de los fallos en esta etapa provienen del entorno más que de CucumberEstos son los que vale la pena reconocer a simple vista.

Mensaje Causa Solución
'cucumber' no se reconoce como un comando interno o externo. El directorio bin de Ruby no está en la variable PATH, o bien te encuentras en una ventana de comandos normal. Abra Iniciar el símbolo del sistema con Rubyo bien reinstale Ruby con la opción PATH seleccionada.
SSL_connect devolvió=1 errno=0 estado=error: error al verificar el certificado RubyGems no puede validar la cadena de certificados, que normalmente se encuentra detrás de un proxy corporativo. Actualiza RubyGems con gem update –system, o configura el proxy con el parámetro –http-proxy.
ERROR: No se pudo compilar la extensión nativa de la gema Falta el kit de desarrollo MSYS2. Ejecuta ridk install y elige las opciones de la cadena de herramientas MSYS2 y MINGW.
Opción no válida: -versión Se utilizó un solo guion para las opciones largas. Escriba pepino –versión con dos guiones.
Paso indefinido, con un fragmento sugerido impreso debajo. Cucumber Se encontró el archivo de características, pero no la definición correspondiente. Pegue el fragmento sugerido en un archivo dentro de features/step_definitions y complete el cuerpo.
No se puede cargar dicho archivo — watir La gema se instaló para una versión de Ruby diferente a la que se está ejecutando. Comprueba `ruby -v` y `gem list watir` en la misma consola, y luego reinstala la gema allí.

Una vez que el escenario de multiplicación informa que se ha completado con éxito, la instalación ha finalizado y el mismo proyecto puede convertirse en un proyecto completo. pruebas de automatización suite, ya sea que se utilice para prueba funcional o todas las noches pruebas de regresión.

Preguntas Frecuentes

No. Cucumber-Cubiertas de JVM Java, Kotlin y Scala, Cucumber.js cubre JavaExisten scripts y versiones para otros lenguajes. La versión de Ruby que se describe aquí es la implementación original, y la sintaxis de Gherkin es idéntica en todas ellas.

Cualquier editor funciona, porque un archivo de características es texto plano. RubyMine agrega autocompletado Gherkin y salto a la definición, mientras que Visual Studio Code ofrece un comportamiento similar de forma gratuita a través de una extensión de Ruby y una Cucumber extensión.

Sí, para cualquier conjunto de herramientas, más de una persona puede ejecutarlo. Un Gemfile con una versión explícita de Cucumber y un Gemfile.lock confirmado significa que cada máquina y cada agente de CI resuelve la misma gema, lo que elimina toda una clase de fallos del tipo "funciona en mi máquina".

No, en absoluto. Watir es un envoltorio conveniente sobre Selenium, por lo que puedes requerir la gema selenium-webdriver directamente en las definiciones de tus pasos. Watir Simplemente proporciona una sintaxis de elementos más corta para proyectos Ruby.

Cucumber Ya imprime un fragmento para cada paso indefinido, y los asistentes de IA lo amplían completando el cuerpo a partir de los objetos de página circundantes. Considere el resultado como un primer borrador, ya que los selectores generados suelen ser incorrectos.

Sí, funciona. Copilot reconoce Feature, Scenario, Given, When y Then, y sugiere escenarios adicionales con el mismo estilo. Su punto débil radica en determinar qué escenarios realmente aportan cobertura en lugar de repetir uno ya existente.

Las actualizaciones de parches dentro de una misma rama, como de la 3.4.0 a la 3.4.3, pueden reutilizar el mismo directorio y conservar las gemas existentes. Un cambio entre ramas estables requiere un nuevo directorio de destino, ya que las gemas con extensiones C no son compatibles entre ellas.

Tres opciones cubren la mayoría de las necesidades: –dry-run comprueba que cada paso tenga una definición sin ejecutar nada, –tags ejecuta un subconjunto etiquetado de escenarios y –format establece el generador de informes, por ejemplo, una salida con formato legible localmente y JSON o HTML para un servidor de compilación.

Resumir este post con: