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.
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.
⚠️ 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:
- Aceite a licença
- Clique no botão Next
Passo 3) Na próxima tela:
- Selecione o diretório de instalação.
- Selecione todas as opções
- Clique em Instalar
Passo 4) Na tela seguinte, clique em Avançar.
Passo 5) Aguarde a conclusão da instalação.
Passo 6) Clique em Concluir.
Passo 7) Após a conclusão da instalação, execute o Ruby a partir do Windows Menu Iniciar.
Passo 8) Você verá um prompt de comando Ruby semelhante ao Windows janela cmd.
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.
Após alguns segundos, Cucumber O procedimento de instalação é iniciado e informa cada dependência que obtém.
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.
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.
Passo 1) Clique em Avançar para continuar com a instalação do RubyMine.
Passo 2) Escolha o local de instalação.
Passo 3) Defina as opções de instalação.
Passo 4) Selecione a pasta do menu Iniciar.
Passo 5) Clique em Instalar.
Passo 6) Clique em Concluir.
Etapa 7) Selecione Não importar configurações.
Passo 8) Clique em Avaliar.
Etapa 9) Aceite a licença.
Passo 10) Selecione Ignorar o restante e Definir padrões.
Passo 11) Abra o editor.
Passo 12) Crie um novo projeto.
⚠️ 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.
Etapa 2) A gem watir-webdriver é instalada com sucesso.
⚠️ 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.
O painel de controle do RubyMine aparece conforme mostrado abaixo.
Passo 2) Crie um novo projeto no editor RubyMine.
Dê um nome e uma localização ao projeto e, em seguida, confirme.
Passo 3) Crie um diretório de arquivos.
O novo diretório aparece na árvore do projeto.
Passo 4) Crie e salve um arquivo em suapasta/recursos/ com o nome seuarquivo.recurso.
Confirme se o nome do arquivo termina com a extensão .feature.
Etapa 5) Para executar nosso cenário, salve os seguintes comandos no arquivo de recursos.
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.
O console exibe o resultado conforme mostrado abaixo.
Etapa 7) Crie o arquivo de definição de etapa para o arquivo de recurso.
Crie uma nova pasta no editor RubyMine.
Passo 8) Salve o arquivo em sua pasta/recursos/definições_de_etapas com o nome test_step.rb.
Passo 9) Escreva o seguinte código no arquivo de etapas.
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.
O resultado é impresso no console e cada etapa é relatada como concluída com sucesso.
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.












































