Jak stáhnout a nainstalovat CUCUMBER in Windows

⚡ Chytré shrnutí

Cucumber instalace na Windows potřebuje v pořadí čtyři části: Ruby s jeho vývojářskou sadou, Cucumber samotný gem, editor jako RubyMine a knihovna ovladačů prohlížeče. Každý z nich se nainstaluje během několika minut.

  • 🔘 Rubín první: Cucumber je gem v Ruby, takže instalační program Ruby+Devkit z RubyInstalleru musí být nainstalován před čímkoli jiným.
  • ☑️ Jeden příkaz: Příkaz gem install cucumber stáhne gem a jeho závislosti přímo z RubyGems z příkazového řádku.
  • (Tj. Okamžitě ověřte: Spuštěním příkazu cucumber –version se potvrdí, že gem byl vyřešen a že se spustitelný soubor nachází v systémové cestě PATH.
  • 🧪 Volitelné pro editora: RubyMine nabízí zvýrazňování syntaxe a navigaci po jednotlivých krocích, ale jakýkoli editor, který ukládá prostý text, spustí soubor s funkcemi.
  • 🛠️ Ovladač prohlížeče: Watir zábaly Selenium a řídí prohlížeč; moderní název gem je watir, nikoli vyřazený watir-webdriver.
  • 📊 Pevné rozvržení: Soubory prvků se nacházejí v souboru features, definice kroků v souboru features/step_definitions nebo Cucumber nemůže odpovídat kroku.

Stažení a instalace Cucumber on Windows s Ruby, RubyMine a Watir

Cucumber Instalace může vypadat únavně, ale je relativně snadná, jakmile jsou jednotlivé díly sestaveny ve správném pořadí. Zde je plán s komponenty, které je třeba nainstalovat, aby... Cucumber práce.

Předpoklady pro instalaci Cucumber on Windows

Cucumber je distribuován jako Ruby gem, takže nic nefunguje, dokud není Ruby nainstalován. Před stažením čehokoli si ověřte následující:

  • Windows 10 nebo novější, 64bitová. RubyInstaller již nedoporučuje 32bitovou verzi, pokud nejste závislí na 32bitových nativních knihovnách DLL nebo objektech COM.
  • Práva správce. Instalační program zapisuje do Program Files a upravuje proměnnou prostředí PATH.
  • Připojení k internetu. Oba níže uvedené příkazy pro instalaci gem načítají balíčky z RubyGems.
  • Přibližně 1 GB volného místa na disku pro Ruby plus vývojářskou sadu MSYS2 a další, pokud přidáte RubyMine.
  • Prohlížeč pro automatizaci. Watir disky Chrome, Edge nebo Firefox přes Selenium, takže musí být nainstalován alespoň jeden.

Dva příkazy je dobré si zapamatovat pro pozdější použití: ruby -v vytiskne verzi Ruby a drahokam -v vypíše verzi RubyGems. Pokud některý z nich selže, cesta PATH nebyla aktualizována a instalační program by měl být spuštěn znovu, nikoli laděn.

Nainstalujte Ruby a DevKit

Začněte s balíčkem Ruby+Devkit, který obsahuje sadu nástrojů kompilátoru, které potřebují gemy s rozšířeními C.

Krok 1) Přejděte na https://rubyinstaller.org/downloads/ a vyberte instalační program. Stránka pro stahování je zobrazena níže.

Stránka ke stažení RubyInstalleru se seznamem instalačních programů Ruby a Ruby+Devkit

⚠️ Poznámka k verzi: Samostatný archiv DevKit, na který se odkazuje původní návod, byl nahrazen sadou nástrojů MSYS2, kterou Ruby+Devkit instalační balíčky jako volitelná komponenta. RubyInstaller v současné době doporučuje novým uživatelům verzi Ruby+Devkit 4.0.X (x64) a sada je později aktualizována o zbavit se instalace spíše než opětovným spuštěním souboru dk.rb. Níže uvedené kroky zůstávají jinak nezměněny.

Krok 2) Otevřete stažený soubor. Na první obrazovce:

  1. Přijměte licenci
  2. Klikněte na tlačítko Další

Obrazovka licenční smlouvy instalačního programu Ruby s tlačítkem Další

Krok 3) Na další obrazovce:

  1. Vyberte instalační adresář
  2. Vybrat všechny možnosti
  3. Klikněte na tlačítko Instalovat

Výběr instalačního adresáře Ruby a výběr všech možností instalačního programu

Krok 4) Na následující obrazovce klikněte na tlačítko Další.

Obrazovka výběru komponent instalačního programu Ruby před zahájením kopírování

Krok 5) Počkejte na dokončení instalace.

Průběh instalace Ruby během kopírování souborů na disk

Krok 6) Klikněte na Dokončit.

Závěrečná obrazovka instalačního programu Ruby s tlačítkem Dokončit

Krok 7) Po dokončení instalace spusťte Ruby z Windows Nabídka Start.

Windows Položka nabídky Start, která otevírá příkazový řádek s Ruby

Krok 8) Zobrazí se příkazový řádek Ruby podobný tomuto Windows okno cmd.

Okno příkazového řádku Ruby připraveno přijímat příkazy gem

instalovat Cucumber

S Ruby v cestě PATH je samotný gem jediným příkazem.

Krok 1) Zadejte instalace drahokamu okurka v příkazovém řádku Ruby. Tento příkaz stáhne a nainstaluje Cucumber na samotném příkazovém řádku.

gem install cucumber zadaný do příkazového řádku Ruby

Po několika sekundách se Cucumber Instalační procedura se spustí a oznámí každou závislost, kterou načte.

Cucumber výstup instalace Gem s výpisem instalovaných závislostí

Krok 2) Ověření, zda Cucumber úspěšně nainstalováno, zadejte okurková verzeVšimněte si dvou pomlček – jedna pomlčka není platnou dlouhou volbou.

příkaz cucumber --version vypíše nainstalovanou verzi Cucumber verze

Nainstalujte IDE RubyMine

Editor není striktně vyžadován, ale RubyMine rozumí Gherkinu a dokáže přeskočit z kroku na jeho definici. Pro jeho instalaci postupujte podle níže uvedených kroků.

Úvodní obrazovka průvodce nastavením RubyMine

Krok 1) Klikněte na tlačítko Další pro pokračování v instalaci RubyMine.

První stránka instalačního programu RubyMine s tlačítkem Další

Krok 2) Vyberte místo instalace.

Výběr instalační složky RubyMine

Krok 3) Nastavte možnosti instalace.

Možnosti instalace RubyMine, jako jsou zkratky a asociace souborů

Krok 4) Vyberte složku nabídky Start.

Výběr složky v nabídce Start pro zástupce RubyMine

Krok 5) Klikněte na tlačítko Instalovat.

Instalační program RubyMine je připraven ke kopírování souborů po kliknutí na tlačítko Instalovat

Krok 6) Klikněte na Dokončit.

Obrazovka dokončení nastavení RubyMine s tlačítkem Dokončit

Krok 7) Vyberte Neimportovat nastavení.

Dialogové okno nastavení importu při prvním spuštění RubyMine

Krok 8) Klikněte na Vyhodnotit.

Okno aktivace licence RubyMine s možností Vyhodnotit

Krok 9) Přijměte licenci.

Souhlas s licenční smlouvou RubyMine

Krok 10) Vyberte Přeskočit zbývající a Nastavit výchozí hodnoty.

Úvodní obrazovka přizpůsobení RubyMine s funkcemi Přeskočit zbývající a Nastavit výchozí hodnoty

Krok 11) Otevřete editor.

Úvodní obrazovka RubyMine s možností Otevřít

Krok 12) Vytvořte nový projekt.

Dialogové okno nového projektu v RubyMine

⚠️ Poznámka k verzi: RubyMine je placená JetBrains produkt s časově omezeným hodnocením, které se spustí stisknutím tlačítka Vyhodnotit v kroku 8. Bezplatnou alternativou je Visual Studio Code s Ruby a Cucumber (Gherkin) rozšíření; zbytek tohoto návodu funguje v obou editorech stejně.

Nainstalujte ovladač watir-webdriver

Cucumber pouze spouští kroky. Prohlížeč musí otevřít něco jiného a tato úloha patří Watir, obalovací jazyk Ruby kolem SeleniumPokud dáváte přednost přímému ovládání prohlížeče, stejný projekt může volat prostý Skript WebDriver.

Krok 1) Klikněte na Spuštění příkazového řádku s Ruby a spusťte instalační příkaz gem install watir-webdriver.

gem install watir-webdriver spuštěný v příkazovém řádku Ruby

Krok 2) Gem watir-webdriver se úspěšně nainstaloval.

Výstup konzole potvrzující instalaci gem watir-webdriver

⚠️ Poznámka k ukončení podpory: Gem watir-webdriver byl složen do hlavního voda klenot na Watir 6.0 a jeho vlastní repozitář nyní uživatele pouze odkazuje na náhradu. Na novém počítači spusťte instalace drahokamu watir Místo toho je zachován výše uvedený historický příkaz, protože ho ukazují snímky obrazovky.

Cucumber Struktura složek projektu

Cucumber vyhledává soubory podle konvence, nikoli podle konfigurace, takže na rozvržení záleží více, než se na první pohled zdá. Minimální projekt vypadá takto:

Cesta Pojme
vlastnosti/ Každý soubor .feature, napsaný v Gherkinu. Cucumber vyhledává zde ve výchozím nastavení.
funkce/definice_kroků/ Soubory Ruby, jejichž bloky odpovídají každému řádku Given, When a Then.
funkce/podpora/ Kód nastavení se načte před spuštěním jakéhokoli kroku, například env.rb, kde se obvykle otevírá a zavírá prohlížeč.

Dvě pravidla ušetří pozdější velký zmatek. Cucumber ignoruje klíčové slovo, pokud odpovídá kroku, takže Vzhledem k tomu, že mám proměnnou a a Pak mám proměnnou a kolidují se stejnou definicí. A text kroku v souboru funkcí se musí přesně shodovat s regulárním výrazem v souboru kroků, včetně interpunkce.

Jméno Cucumber Scénář

Níže uvedený příklad vynásobí dvě čísla, což stačí k prokázání, že soubor s funkcemi, soubor s krokem a gem spolu komunikují.

Krok 1) Otevřete editor RubyMine z Windows Nabídka Start.

Otevření RubyMine z Windows V nabídce Start

Ovládací panel RubyMine vypadá, jak je znázorněno níže.

Zobrazení dashboardu RubyMine po otevření editoru

Krok 2) Vytvořte nový projekt v editoru RubyMine.

Spuštění nového projektu z dashboardu RubyMine

Zadejte název a umístění projektu a poté potvrďte.

Zadání názvu a umístění projektu v dialogovém okně nový projekt

Krok 3) Vytvořte adresář souborů.

Vytvoření nového adresáře v projektu RubyMine

Nový adresář se zobrazí ve stromové struktuře projektu.

Strom projektu zobrazující nově vytvořený adresář funkcí

Krok 4) Vytvořte a uložte soubor do vašesložka/funkce/ s názvem název_souboru.funkce.

Vytvoření souboru feature v adresáři features

Ověřte název souboru tak, aby končil příponou .feature.

Pojmenování nového souboru s příponou .feature

Krok 5) Pro spuštění našeho scénáře uložte následující příkazy do souboru feature.

Soubor s funkcemi otevřený v editoru RubyMine připravený pro scénář

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

Krok 6) Nyní spusťte první soubor s funkcemi.

Klikněte na Spuštění příkazového řádku s Ruby a spusťte příkaz cucumber ze složky projektu.

Spuštění příkazového řádku Ruby pro spuštění souboru funkcí

Konzole hlásí výsledek, jak je znázorněno níže.

Výstup konzole z prvního Cucumber spuštění souboru s funkcemi

Krok 7) Vytvořte soubor s definicí kroku pro soubor prvku.

V editoru RubyMine vytvořte novou složku.

Vytvoření nové složky v projektu RubyMine pro definice kroků

Pojmenování nové složky s definicemi kroků

Krok 8) Uložte soubor do vašesložka/funkce/definice_kroků s názvem test_krok.rb.

Uložení nového souboru Ruby do složky s definicemi kroků

Zadáním test_step.rb jako názvu souboru s definicí kroku

Krok 9) Do souboru step napište následující kód.

Soubor s definicí kroku otevřený v editoru před přidáním kódu

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

Krok 10) Nyní znovu spusťte soubor s funkcemi.

Spuštění souboru funkcí podruhé po definování kroků

Výsledek se vypíše do konzole a každý krok se označí jako úspěšný.

Cucumber výstup konzole po spuštění souboru funkcí s definovanými kroky

Společný Cucumber Chyby při instalaci a jak je opravit

Většina selhání v této fázi pochází spíše z prostředí než z CucumberTo jsou ty, které stojí za to poznat na první pohled.

Zpráva Způsobit Opravit
Příkaz „cucumber“ není rozpoznán jako interní ani externí. Adresář Ruby bin se nenachází v cestě PATH, nebo se nacházíte v prostém okně cmd. Otevřená Spuštění příkazového řádku s Ruby, nebo znovu nainstalujte Ruby s vybranou možností PATH.
SSL_connect returned=1 errno=0 state=error: ověření certifikátu selhalo RubyGems nedokáže ověřit řetězec certifikátů, obvykle za firemní proxy. Aktualizujte RubyGems pomocí gem update –system nebo nakonfigurujte proxy pomocí přepínače –http-proxy.
CHYBA: Nepodařilo se sestavit nativní rozšíření GEM. Chybí vývojová sada MSYS2. Spusťte příkaz ridk install a vyberte možnosti MSYS2 a MINGW toolchain.
neplatná volba: -version Pro dlouhou možnost byla použita jedna pomlčka. Napište okurka – verze se dvěma pomlčkami.
Nedefinovaný krok s navrhovaným úryvkem kódu vytištěným pod ním Cucumber nalezen soubor s funkcí, ale žádná odpovídající definice. Vložte navrhovaný úryvek kódu do souboru v adresáři features/step_definitions a vyplňte tělo.
takový soubor nelze načíst — watir Gem nainstalovaný pro jinou verzi Ruby, než je ta, která běží. Ve stejném příkazovém řádku zkontrolujte ruby ​​-v a gem list watir a poté tam znovu nainstalujte gem.

Jakmile scénář násobení ohlásí úspěšný výsledek, instalace je dokončena a stejný projekt se může rozvinout do plnohodnotného testování automatizace apartmá, ať už se používá pro funkční testování nebo každou noc regresní testování.

Nejčastější dotazy

Ne. Cucumber-JVM pokrývá Java, Kotlin a Scala, CucumberKryty .js JavaSkripty a porty existují i ​​pro několik dalších jazyků. Verze Ruby popsaná zde je původní implementací a syntaxe Gherkinu je ve všech shodná.

Funguje jakýkoli editor, protože soubor s funkcemi je prostý text. RubyMine přidává automatické doplňování Gherkin a skok na definici, zatímco Visual Studio Code nabízí podobné chování zdarma prostřednictvím rozšíření Ruby a Cucumber rozšíření.

Ano, pro jakoukoli sadu, kterou spouští více než jeden člověk. Gemfile s explicitní verzí typu cucumber a potvrzeným souborem Gemfile.lock znamená, že každý počítač a každý CI agent řeší stejný gem, což odstraňuje celou třídu chyb typu „funguje na mém počítači“.

Vůbec ne. Watir je obal na pohodlí Selenium, takže můžete místo toho v definicích kroků přímo vyžadovat gem selenium-webdriver. Watir jednoduše poskytuje kratší syntaxi elementů pro projekty v Ruby.

Cucumber již vytiskne úryvek pro každý nedefinovaný krok a asistenti umělé inteligence ho rozšiřují vyplněním těla z okolních objektů stránky. Výstup považujte za první návrh, protože vygenerované selektory jsou často chybné.

Ano. Copilot rozpoznává Funkce, Scénář, Dané, Kdy a Pak a navrhne další scénáře ve stejném stylu. Nejslabší je v posuzování, které scénáře skutečně rozšiřují pokrytí, spíše než opakují stávající.

Aktualizace v rámci jedné větve, například z verze 3.4.0 na 3.4.3, mohou znovu použít stejný adresář a zachovat stávající gemy. Přesun mezi stabilními větvemi vyžaduje nový cílový adresář, protože gemy s příponami C mezi nimi nejsou kompatibilní.

Tři pokrývají většinu potřeb: –dry-run kontroluje, zda má každý krok definici, aniž by cokoli spouštěl, –tags spustí označenou podmnožinu scénářů a –format nastaví reportér, například pretty výstup lokálně a JSON nebo HTML pro sestavovací server.

Shrňte tento příspěvek takto: