Come scaricare e installare CUCUMBER in Windows

⚡ Riepilogo intelligente

Cucumber installazione attiva Windows necessita di quattro pezzi in ordine: Ruby con il suo kit di sviluppo, il Cucumber La gemma stessa, un editor come RubyMine e una libreria di driver per il browser. Ognuno di questi si installa in pochi minuti.

🔘 Ruby first: Cucumber Si tratta di una gemma Ruby, quindi l'installer Ruby+Devkit di RubyInstaller deve essere installato prima di qualsiasi altra cosa.
☑️ Un solo comando: Il comando `gem install cucumber` scarica la gemma e le sue dipendenze direttamente da RubyGems tramite riga di comando.
✅ Verificare immediatamente: L'esecuzione del comando `cucumber –version` conferma che la gemma è stata risolta e che l'eseguibile è presente nel PATH di sistema.
🧪 Editor facoltativo: RubyMine offre l'evidenziazione della sintassi e la navigazione passo passo, ma qualsiasi editor che salvi testo semplice eseguirà un file di funzionalità.
️ Driver del browser: Watir avvolge Selenium e gestisce il browser; il nome attuale del gem è watir, non il vecchio watir-webdriver.
📊 Layout fisso: I file delle funzionalità si trovano in features, le definizioni dei passaggi in features/step_definitions, oppure Cucumber non riesce a far corrispondere un passo.

Scopri di più

Cucumber L'installazione può sembrare noiosa, ma è relativamente facile una volta che i pezzi vengono presi nell'ordine giusto. Ecco la roadmap dei componenti che devono essere installati per realizzare Cucumber lavoro.

Prerequisiti per l'installazione Cucumber on Windows

Cucumber viene distribuito come gemma Ruby, quindi nulla funziona finché Ruby non è presente. Verifica quanto segue prima di scaricare qualsiasi cosa:

Windows 10 o versioni successive, 64 bit. RubyInstaller non consiglia più la build a 32 bit a meno che non si dipenda da DLL native a 32 bit o oggetti COM.
Diritti di amministratore. Il programma di installazione scrive nella cartella Programmi e modifica la variabile d'ambiente PATH.
Una connessione Internet. Entrambi i comandi gem install riportati di seguito scaricano i pacchetti da RubyGems.
Circa 1 GB di spazio libero su disco per Ruby più il kit di sviluppo MSYS2, e ancora di più se si aggiunge RubyMine.
Un browser per automatizzare. Watir guida Chrome, Edge o Firefox attraverso Selenium, quindi almeno uno deve essere installato.

Ci sono due comandi che vale la pena ricordare per dopo: rubino -v stampa la versione Ruby e gemma -v Stampa la versione di RubyGems. Se uno dei due tentativi fallisce, significa che il PATH non è stato aggiornato e il programma di installazione deve essere eseguito nuovamente anziché in modalità debug.

Installa Ruby e DevKit

Iniziate con il pacchetto Ruby+Devkit, che include la toolchain del compilatore necessaria alle gemme con estensioni C.

Passaggio 1) Vai a https://rubyinstaller.org/downloads/ e scegli un programma di installazione. La pagina di download è mostrata qui sotto.

⚠️ Nota sulla versione: l'archivio DevKit separato a cui fa riferimento la procedura guidata originale è stato sostituito dalla toolchain MSYS2, che Ruby+Devkit I pacchetti di installazione sono un componente selezionabile. RubyInstaller attualmente consiglia la build Ruby+Devkit 4.0.X (x64) per i nuovi utenti e il kit viene aggiornato in seguito con installazione di cavalletto anziché rieseguendo dk.rb. I passaggi seguenti rimangono altrimenti invariati.

Passaggio 2) Aprire il file scaricato. Nella prima schermata:

Accetta la licenza
Fai clic sul pulsante Avanti

Passaggio 3) Nella schermata successiva:

Seleziona la directory di installazione
Seleziona tutte le opzioni
Fare clic su Installa

Passaggio 4) Nella schermata successiva, fare clic su Avanti.

Passaggio 5) Attendere il completamento dell'installazione.

Passaggio 6) Fare clic su Fine.

Passaggio 7) Una volta completata l'installazione, esegui Ruby da Windows Menu iniziale.

Passaggio 8) Vedrai un prompt dei comandi Ruby simile a Windows finestra di comando.

Installazione Cucumber

Con Ruby nel PATH, la gemma stessa è un singolo comando.

Passaggio 1) Digitare gem install cucumber nel prompt dei comandi Ruby. Questo comando scarica e installa Cucumber direttamente dalla riga di comando.

Dopo pochi secondi il Cucumber La procedura di installazione si avvia e segnala ogni dipendenza scaricata.

Passaggio 2) Per verificare se Cucumber installato correttamente, tipo cetriolo –versione. Nota i due trattini: un singolo trattino non è un'opzione valida per una stringa lunga.

Installa l'IDE RubyMine

Un editor non è strettamente necessario, ma RubyMine supporta Gherkin ed è in grado di passare direttamente da un passaggio alla sua definizione. Segui i passaggi seguenti per installarlo.

Passaggio 1) Fare clic su Avanti per continuare con l'installazione di RubyMine.

Passaggio 2) Scegliere la posizione di installazione.

Passaggio 3) Impostare le opzioni di installazione.

Passaggio 4) Selezionare la cartella del menu Start.

Passaggio 5) Fare clic su Installa.

Passaggio 6) Fare clic su Fine.

Passaggio 7) Seleziona Non importare le impostazioni.

Passaggio 8) Fare clic su Valuta.

Passaggio 9) Accettare la licenza.

Passaggio 10) Selezionare Salta i rimanenti e Imposta impostazioni predefinite.

Passaggio 11) Aprire l'editor.

Passaggio 12) Creare un nuovo progetto.

⚠️ Nota sulla versione: RubyMine è un servizio a pagamento JetBrains prodotto con una valutazione a tempo limitato, che è ciò che avvia il pulsante Valuta nel passaggio 8. Un'alternativa gratuita è Visual Studio Code con un rubino e un Cucumber Estensione (Gherkin); il resto di questa guida funziona allo stesso modo in entrambi gli editor.

Installa il driver web dell'acqua

Cucumber esegue solo i passaggi. Qualcos'altro deve aprire il browser e quel compito appartiene a Watir, un wrapper Ruby attorno SeleniumSe preferisci controllare direttamente il browser, lo stesso progetto può chiamare un semplice Script WebDriver.

Passaggio 1) Fare clic su Avviare il prompt dei comandi con Ruby eseguendo il comando di installazione gem install watir-webdriver.

Passaggio 2) La gemma watir-webdriver viene installata correttamente.

⚠️ Nota di deprecazione: la gemma watir-webdriver è stata integrata nel progetto principale acqua gemma a Watir 6.0 e il suo repository ora indirizza gli utenti solo al sostituto. Su una nuova macchina eseguire gem install watir Invece. Il comando storico sopra riportato è mantenuto perché è quello che mostrano gli screenshot.

Cucumber Struttura delle cartelle del progetto

Cucumber Il sistema individua i file per convenzione, non per configurazione, quindi la struttura è più importante di quanto sembri a prima vista. Un progetto minimo si presenta così:

sentiero	Contiene
Caratteristiche/	Ogni file .feature è scritto in Gherkin. Cucumber Le ricerche vengono effettuate qui per impostazione predefinita.
caratteristiche/definizioni_di_passo/	I file Ruby i cui blocchi corrispondono a ciascuna riga Given, When e Then.
funzionalità/supporto/	Il codice di configurazione viene caricato prima dell'esecuzione di qualsiasi passaggio, come ad esempio env.rb, che è il file in cui il browser viene solitamente aperto e chiuso.

Due semplici regole evitano molta confusione in seguito. Cucumber ignora la parola chiave quando corrisponde a un passaggio, quindi Dato che ho la variabile a and Poi ho la variabile a entrare in conflitto con la stessa definizione. E il testo del passaggio nel file delle funzionalità deve corrispondere esattamente all'espressione regolare nel file dei passaggi, punteggiatura inclusa.

Nome Cucumber Copione

L'esempio seguente moltiplica due numeri, il che è sufficiente a dimostrare che il file delle funzionalità, il file dei passaggi e la gemma comunicano tra loro.

Passaggio 1) Apri l'editor RubyMine da Windows Menu iniziale.

La dashboard di RubyMine appare come mostrato di seguito.

Passaggio 2) Crea un nuovo progetto nell'editor di RubyMine.

Assegna un nome e una posizione al progetto, quindi conferma.

Passaggio 3) Creare una directory di file.

La nuova directory appare nell'albero del progetto.

Passaggio 4) Crea e salva un file in la tua cartella/funzionalità/ con il nome nomefile.caratteristica.

Conferma che il nome del file termini con l'estensione .feature.

Passaggio 5) Per eseguire il nostro scenario, salvare i seguenti comandi nel file delle funzionalità.

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

Passaggio 6) Ora esegui il primo file feature.

Fare clic su Avviare il prompt dei comandi con Ruby e avviare il comando cucumber dalla cartella del progetto.

La console riporta il risultato come mostrato di seguito.

Passaggio 7) Creare il file di definizione dei passaggi per il file delle funzionalità.

Crea una nuova cartella nell'editor di RubyMine.

Passaggio 8) Salva il file in la_tua_cartella/funzionalità/definizioni_dei_passaggi con il nome test_step.rb.

Passaggio 9) Scrivere il seguente codice nel file step.

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

Passaggio 10) Ora esegui nuovamente il file delle funzionalità.

Il risultato viene stampato nella console e ogni passaggio viene segnalato come superato.

Uncommon Cucumber Errori di installazione e come risolverli

La maggior parte dei fallimenti in questa fase derivano dall'ambiente piuttosto che da CucumberQuesti sono quelli che vale la pena riconoscere a prima vista.

Messaggio	Causare	Fissare
'cucumber' non è riconosciuto come comando interno o esterno	La directory bin di Ruby non è presente nel PATH oppure ti trovi in una normale finestra del prompt dei comandi.	Apri Avviare il prompt dei comandi con Rubyoppure reinstallare Ruby selezionando l'opzione PATH.
SSL_connect ha restituito=1 errno=0 stato=errore: verifica del certificato non riuscita	RubyGems non è in grado di convalidare la catena di certificati, solitamente protetta da un proxy aziendale.	Aggiorna RubyGems con gem update –system oppure configura il proxy con l'opzione –http-proxy.
ERRORE: Impossibile compilare l'estensione nativa del gem.	Il kit di sviluppo MSYS2 è mancante.	Esegui il comando ridk install e seleziona le opzioni della toolchain MSYS2 e MINGW.
opzione non valida: -versions	Per le opzioni lunghe è stato utilizzato un singolo trattino.	Digita cucumber –versione con due trattini.
Passaggio non definito, con un frammento di codice suggerito stampato sotto di esso	Cucumber Trovato il file delle funzionalità, ma nessuna definizione corrispondente.	Incolla il frammento di codice suggerito in un file nella cartella features/step_definitions e inserisci il corpo del file.
Impossibile caricare questo file — watir	La gemma è stata installata per una versione di Ruby diversa da quella in esecuzione.	Esegui i comandi `ruby -v` e `gem list watir` nello stesso prompt, quindi reinstalla la gemma.

Una volta che lo scenario di moltiplicazione segnala un successo, l'installazione è terminata e lo stesso progetto può crescere fino a diventare completo test di automazione suite, sia che venga utilizzata per test funzionali o ogni notte test di regressione.

DOMANDE FREQUENTI

No. Cucumber-Coperture JVM Java, Kotlin e Scala, Cucumber.js copre JavaLo script è disponibile anche in altre lingue. La versione Ruby qui descritta è l'implementazione originale e la sintassi di Gherkin è identica in tutte le altre.

Qualsiasi editor funziona, perché un file feature è testo semplice. RubyMine aggiunge il completamento automatico di Gherkin e il salto alla definizione, mentre Visual Studio Code offre un comportamento simile gratuitamente tramite un'estensione Ruby e un Cucumber estensione.

Sì, per qualsiasi suite eseguita da più persone. Un Gemfile con una versione Cucumber esplicita e un Gemfile.lock confermato significa che ogni macchina e ogni agente CI risolve la stessa gemma, eliminando un'intera classe di errori del tipo "funziona sulla mia macchina".

Affatto. Watir è un involucro pratico Selenium, quindi puoi richiedere la gemma selenium-webdriver direttamente nelle definizioni dei tuoi step. Watir Semplicemente, offre una sintassi degli elementi più breve per i progetti Ruby.

Cucumber Il sistema stampa già un frammento di codice per ogni passaggio non definito, e gli assistenti basati sull'IA estendono questa funzionalità completando il corpo del messaggio con i dati degli oggetti della pagina circostanti. Considera l'output come una prima bozza, poiché i selettori generati sono spesso errati.

Sì. Copilot riconosce Feature, Scenario, Given, When e Then e suggerirà ulteriori scenari nello stesso stile. Il suo punto debole è la capacità di valutare quali scenari aggiungono effettivamente copertura anziché ripetere uno scenario già esistente.

Gli aggiornamenti di patch all'interno dello stesso ramo, ad esempio dalla versione 3.4.0 alla 3.4.3, possono riutilizzare la stessa directory e mantenere le gemme esistenti. Il passaggio tra rami stabili richiede invece una nuova directory di destinazione, poiché le gemme con estensione C non sono compatibili tra di essi.

Tre opzioni coprono la maggior parte delle esigenze: –dry-run verifica che ogni passaggio abbia una definizione senza eseguire nulla, –tags esegue un sottoinsieme etichettato di scenari e –format imposta il reporter, ad esempio un output formattato in locale e JSON o HTML per un server di build.