Como baixar e instalar o CUCUMBER em Windows

⚡ Resumo Inteligente

Cucumber instalação em Windows precisa de quatro peças em ordem: Ruby com seu kit de desenvolvimento, o Cucumber O pacote gem em si, um editor como o RubyMine e uma biblioteca de drivers de navegador. Cada um deles é instalado em minutos.

  • 🔘 Ruby primeiro: Cucumber É uma gem do Ruby, portanto o instalador Ruby+Devkit do RubyInstaller deve estar instalado antes de qualquer outra coisa.
  • ☑️ Um comando: O comando `gem install cucumber` instala a gem e suas dependências diretamente do RubyGems pela linha de comando.
  • ✅ Verifique imediatamente: Executar o comando `cucumber --version` confirma que a gem foi resolvida e que o executável está no PATH do sistema.
  • 🧪 Editor opcional: O RubyMine oferece realce de sintaxe e navegação passo a passo, mas qualquer editor que salve texto simples executará um arquivo de recursos.
  • 🛠️ Driver do navegador: Watir embrulha Selenium e controla o navegador; o nome moderno da gem é watir, não o antigo watir-webdriver.
  • 📊 Layout fixo: Os arquivos de recursos ficam em features, as definições de etapas em features/step_definitions, ou Cucumber Não é possível encontrar uma etapa correspondente.

Baixe e instale Cucumber on Windows com Ruby, RubyMine e Watir

Cucumber A instalação pode parecer cansativa, mas é relativamente fácil depois que as peças são colocadas na ordem correta. Aqui está o roteiro dos componentes que precisam ser instalados para montar o produto. Cucumber <span class="word" data-word="work." style="--word-index: 2; translate: none; rotate: none; scale: none; transform: translate(0px, 0px); opacity: 1;">work.</span>

Pré-requisitos para a instalação Cucumber on Windows

Cucumber É distribuído como uma gem do Ruby, portanto, nada funciona até que o Ruby esteja instalado. Confirme o seguinte antes de baixar qualquer coisa:

  • Windows 10 ou posterior, 64 bits. O RubyInstaller não recomenda mais a versão de 32 bits, a menos que você dependa de DLLs nativas de 32 bits ou objetos COM.
  • Direitos de administrador. O instalador grava arquivos na pasta Arquivos de Programas e edita a variável de ambiente PATH.
  • Uma conexão com a Internet. Os dois comandos de instalação de gems abaixo baixam pacotes do RubyGems.
  • Aproximadamente 1 GB de espaço livre em disco para Ruby mais o kit de desenvolvimento MSYS2, e ainda mais se você adicionar o RubyMine.
  • Um navegador para automatizar. Watir executa Chrome, Edge ou Firefox através de SeleniumPortanto, pelo menos um deve ser instalado.

Vale a pena lembrar dois comandos para mais tarde: rubi -v imprime a versão Ruby, e gema -v Imprime a versão do RubyGems. Se alguma das duas opções falhar, o PATH não foi atualizado e o instalador deve ser executado novamente em vez de depurado.

Instale Ruby e DevKit

Comece com o pacote Ruby+Devkit, que inclui o conjunto de ferramentas de compilação necessário para gems com extensões em C.

Etapa 1) Vá para https://rubyinstaller.org/downloads/ e selecione um instalador. A página de download é mostrada abaixo.

Página de downloads do RubyInstaller listando os instaladores do Ruby e do Ruby+Devkit.

⚠️ Nota de versão: O arquivo DevKit separado ao qual o guia original se referia foi substituído pelo conjunto de ferramentas MSYS2, que... Ruby+Devkit O instalador oferece pacotes como um componente selecionável. Atualmente, o RubyInstaller recomenda a versão Ruby+Devkit 4.0.X (x64) para novos usuários, e o kit é atualizado posteriormente com instalação ridk em vez de executar o dk.rb novamente. Os demais passos permanecem inalterados.

Passo 2) Abra o arquivo baixado. Na primeira tela:

  1. Aceite a licença
  2. Clique no botão Next

Tela de contrato de licença do instalador Ruby com o botão Próximo.

Passo 3) Na próxima tela:

  1. Selecione o diretório de instalação.
  2. Selecione todas as opções
  3. Clique em Instalar

Selecionar o diretório de instalação do Ruby e escolher todas as opções do instalador.

Passo 4) Na tela seguinte, clique em Avançar.

Tela de seleção de componentes do instalador Ruby antes do início da cópia.

Passo 5) Aguarde a conclusão da instalação.

Progresso da instalação do Ruby enquanto os arquivos são copiados para o disco.

Passo 6) Clique em Concluir.

Tela final do instalador Ruby com o botão Concluir

Passo 7) Após a conclusão da instalação, execute o Ruby a partir do Windows Menu Iniciar.

Windows Entrada do menu Iniciar que abre o prompt de comando com Ruby.

Passo 8) Você verá um prompt de comando Ruby semelhante ao Windows janela cmd.

A janela do prompt de comando do Ruby está pronta para aceitar comandos gem.

Instale Cucumber

Com o Ruby no PATH, a gem em si é executada com um único comando.

Passo 1) Digite gem instalar pepino no prompt de comando do Ruby. Este comando baixa e instala Cucumber na própria linha de comando.

O comando `gem install cucumber` foi digitado no prompt de comando do Ruby.

Após alguns segundos, Cucumber O procedimento de instalação é iniciado e informa cada dependência que obtém.

Cucumber Saída da instalação do gem listando as dependências que estão sendo instaladas.

Etapa 2) Para verificar se Cucumber Instalado com sucesso, digite pepino – versãoObserve os dois hífenes — um único hífen não é uma opção longa válida.

O comando `cucumber --version` imprime a versão instalada. Cucumber versão

Instale o IDE RubyMine

Um editor não é estritamente necessário, mas o RubyMine entende Gherkin e pode pular de uma etapa para sua definição. Siga os passos abaixo para instalá-lo.

Tela de boas-vindas do assistente de configuração do RubyMine

Passo 1) Clique em Avançar para continuar com a instalação do RubyMine.

Primeira página do instalador do RubyMine com o botão Próximo.

Passo 2) Escolha o local de instalação.

Selecionando a pasta de instalação do RubyMine

Passo 3) Defina as opções de instalação.

Opções de instalação do RubyMine, como atalhos e associações de arquivos.

Passo 4) Selecione a pasta do menu Iniciar.

Selecionando a pasta do menu Iniciar para o atalho do RubyMine

Passo 5) Clique em Instalar.

O instalador do RubyMine está pronto para copiar os arquivos após clicar em Instalar.

Passo 6) Clique em Concluir.

Tela de instalação do RubyMine concluída com o botão Concluir

Etapa 7) Selecione Não importar configurações.

Diálogo de configurações de importação na primeira inicialização do RubyMine

Passo 8) Clique em Avaliar.

Janela de ativação da licença RubyMine com a opção Avaliar

Etapa 9) Aceite a licença.

Aceitação do contrato de licença do RubyMine

Passo 10) Selecione Ignorar o restante e Definir padrões.

Tela inicial de personalização do RubyMine com as opções "Ignorar o restante" e "Definir padrões".

Passo 11) Abra o editor.

Tela de boas-vindas do RubyMine com a opção Abrir

Passo 12) Crie um novo projeto.

Novo diálogo de projeto no RubyMine

⚠️ Nota de versão: RubyMine é um serviço pago. JetBrains produto com avaliação por tempo limitado, que é o que o botão Avaliar na Etapa 8 inicia. Uma alternativa gratuita é Visual Studio Code com um rubi e um Cucumber Extensão (Gherkin); o restante deste guia funciona da mesma forma em qualquer editor.

Instale o watir-webdriver

Cucumber apenas executa os passos. Algo mais precisa abrir o navegador, e essa tarefa cabe a Watir, um wrapper Ruby em torno de SeleniumSe preferir controlar o navegador diretamente, o mesmo projeto pode chamar um comando simples. Script WebDriver.

Etapa 1) Clique em Iniciar o Prompt de Comando com Ruby e execute o comando de instalação. gem install watir-webdriver.

Instale a gem watir-webdriver executando o comando no prompt do Ruby.

Etapa 2) A gem watir-webdriver é instalada com sucesso.

Saída do console confirmando a instalação da gem watir-webdriver

⚠️ Nota sobre a descontinuação: A gem watir-webdriver foi incorporada ao projeto principal. água joia em Watir 6.0, e seu próprio repositório agora apenas direciona os usuários para a substituição. Em uma nova máquina, execute gem install watir Em vez disso. O comando histórico acima é mantido porque é o que as capturas de tela mostram.

Cucumber Estrutura da pasta do projeto

Cucumber O sistema descobre arquivos por convenção, não por configuração, portanto o layout importa mais do que parece à primeira vista. Um projeto mínimo se parece com isto:

Caminho Detém
características/ Todos os arquivos .feature são escritos em Gherkin. Cucumber As buscas aqui são realizadas por padrão.
recursos/definições_de_etapas/ Os arquivos Ruby cujos blocos correspondem a cada linha "Dado", "Quando" e "Então".
recursos/suporte/ O código de configuração é carregado antes da execução de qualquer etapa, como o arquivo env.rb, que é onde o navegador geralmente é aberto e fechado.

Duas regras evitam muita confusão mais tarde. Cucumber ignora a palavra-chave quando ela corresponde a uma etapa, então Dado que tenho a variável a e Então eu tenho a variável a colidem com a mesma definição. E o texto da etapa no arquivo de recursos deve corresponder exatamente à expressão regular no arquivo de etapas, incluindo a pontuação.

Primeiro nome Cucumber Script

O exemplo abaixo multiplica dois números, o que é suficiente para provar que o arquivo de funcionalidade, o arquivo de etapas e a gem estão todos se comunicando entre si.

Passo 1) Abra o editor RubyMine a partir do Windows Menu Iniciar.

Abrindo o RubyMine a partir do Windows menu Iniciar

O painel de controle do RubyMine aparece conforme mostrado abaixo.

O painel do RubyMine é exibido após a abertura do editor.

Passo 2) Crie um novo projeto no editor RubyMine.

Iniciando um novo projeto a partir do painel de controle do RubyMine

Dê um nome e uma localização ao projeto e, em seguida, confirme.

Inserindo o nome e a localização do projeto na caixa de diálogo de novo projeto

Passo 3) Crie um diretório de arquivos.

Criando um novo diretório dentro do projeto RubyMine

O novo diretório aparece na árvore do projeto.

Árvore do projeto mostrando o diretório de recursos recém-criado

Passo 4) Crie e salve um arquivo em suapasta/recursos/ com o nome seuarquivo.recurso.

Criando o arquivo de recurso dentro do diretório de recursos.

Confirme se o nome do arquivo termina com a extensão .feature.

Nomeie o novo arquivo com a extensão .feature.

Etapa 5) Para executar nosso cenário, salve os seguintes comandos no arquivo de recursos.

Arquivo de recursos aberto no editor RubyMine, pronto para o cenário.

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

Passo 6) Agora execute o primeiro arquivo de recurso.

Clique em Iniciar o Prompt de Comando com Ruby e execute o comando cucumber a partir da pasta do projeto.

Abrindo o prompt de comando do Ruby para executar o arquivo de funcionalidade.

O console exibe o resultado conforme mostrado abaixo.

Saída do console do primeiro Cucumber execução do arquivo de recurso

Etapa 7) Crie o arquivo de definição de etapa para o arquivo de recurso.

Crie uma nova pasta no editor RubyMine.

Criando uma nova pasta no projeto RubyMine para definições de etapas.

Nomeando a nova pasta de definições de etapas

Passo 8) Salve o arquivo em sua pasta/recursos/definições_de_etapas com o nome test_step.rb.

Salvando um novo arquivo Ruby dentro da pasta de definições de passos.

Inserindo test_step.rb como o nome do arquivo de definição da etapa.

Passo 9) Escreva o seguinte código no arquivo de etapas.

O arquivo de definição de etapas deve ser aberto no editor antes da adição do 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

Passo 10) Agora execute o arquivo de recursos novamente.

Executar o arquivo de recursos uma segunda vez após a definição das etapas.

O resultado é impresso no console e cada etapa é relatada como concluída com sucesso.

Cucumber Saída do console após a execução do arquivo de recursos com etapas definidas.

comum Cucumber Erros de instalação e como corrigi-los

A maioria das falhas nesta fase decorre do ambiente, e não de fatores externos. CucumberEssas são as que valem a pena reconhecer à primeira vista.

Mensagem Causar Fixar
'cucumber' não é reconhecido como um comando interno ou externo. O diretório bin do Ruby não está no PATH, ou você está em uma janela de comando simples. Abra Iniciar o Prompt de Comando com RubyOu reinstale o Ruby com a opção PATH selecionada.
SSL_connect retornou=1 errno=0 estado=erro: falha na verificação do certificado O RubyGems não consegue validar a cadeia de certificados, geralmente por estar atrás de um proxy corporativo. Atualize o RubyGems com o comando `gem update --system`, ou configure o proxy com a opção `--http-proxy`.
ERRO: Falha ao compilar a extensão nativa da gem O kit de desenvolvimento MSYS2 está faltando. Execute o comando `ridk install` e escolha as opções de cadeia de ferramentas MSYS2 e MINGW.
Opção inválida: -version Um único hífen foi usado para opções longas. Digite cucumber –version com dois hífenes.
Etapa indefinida, com um trecho de código sugerido impresso abaixo dela. Cucumber O arquivo de recursos foi encontrado, mas nenhuma definição correspondente foi encontrada. Cole o trecho sugerido em um arquivo em features/step_definitions e preencha o corpo do código.
não foi possível carregar esse arquivo — watir A gem foi instalada para uma versão do Ruby diferente da que está em execução. Verifique o ruby ​​com `ruby -v` e a lista de gems com `watir` no mesmo prompt e reinstale a gem por lá.

Assim que o cenário de multiplicação apresentar um resultado positivo, a instalação estará concluída e o mesmo projeto poderá ser expandido para uma versão completa. teste de automação suíte, seja ela usada para teste funcional ou noturno teste de regressão.

Perguntas Frequentes

Não. Cucumber-A JVM abrange JavaKotlin e Scala, CucumberCapas .js JavaScripts e versões adaptadas existem para diversas outras linguagens. A versão em Ruby descrita aqui é a implementação original, e a sintaxe Gherkin é idêntica em todas elas.

Qualquer editor funciona, porque um arquivo de recurso é texto simples. O RubyMine adiciona autocompletar Gherkin e ir para a definição, enquanto Visual Studio Code oferece comportamento semelhante gratuitamente por meio de uma extensão Ruby e um Cucumber extensão.

Sim, para qualquer conjunto de testes executado por mais de uma pessoa. Um Gemfile com uma versão explícita do Cucumber e um Gemfile.lock definido no repositório significa que todas as máquinas e todos os agentes de CI resolvem a mesma gem, o que elimina toda uma classe de problemas do tipo "funciona na minha máquina".

Nem um pouco. Watir é uma embalagem conveniente sobre SeleniumAssim, você pode importar a gem selenium-webdriver diretamente nas definições de seus passos. Watir Isso simplesmente fornece uma sintaxe de elemento mais curta para projetos Ruby.

Cucumber O sistema já imprime um trecho de código para cada etapa indefinida, e os assistentes de IA ampliam isso preenchendo o corpo do código com os objetos da página adjacentes. Considere a saída como um primeiro rascunho, pois os seletores gerados frequentemente estão incorretos.

Sim, funciona. O Copilot reconhece Funcionalidade, Cenário, Dado, Quando e Então, e sugerirá outros cenários no mesmo estilo. Sua maior dificuldade reside em avaliar quais cenários realmente adicionam cobertura, em vez de repetir um cenário existente.

Atualizações de patches dentro de uma mesma branch, como da versão 3.4.0 para a 3.4.3, podem reutilizar o mesmo diretório e manter as gems existentes. Uma migração entre branches estáveis ​​requer um novo diretório de destino, pois gems com extensão em C não são compatíveis entre elas.

Três opções atendem à maioria das necessidades: –dry-run verifica se cada etapa possui uma definição sem executar nada, –tags executa um subconjunto rotulado de cenários e –format define o relatório, por exemplo, saída formatada localmente e JSON ou HTML para um servidor de compilação.

Resuma esta postagem com: