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: