Как да изтеглите и инсталирате CUCUMBER в Windows

⚡ Умно обобщение

Cucumber инсталация на Windows се нуждае от четири части, подредени по ред: Ruby с неговия комплект за разработка, Cucumber самият gem, редактор като RubyMine и библиотека с драйвери за браузър. Всеки един от тях се инсталира за минути.

  • 🔘 Първо Руби: Cucumber е скъпоценен камък на Ruby, така че инсталаторът на Ruby+Devkit от RubyInstaller трябва да е инсталиран преди всичко останало.
  • ☑️ Една команда: Командата gem install cucumber изтегля gem-а и неговите зависимости директно от RubyGems в командния ред.
  • Проверете незабавно: Изпълнението на cucumber –version потвърждава, че gem-ът е разрешен и че изпълнимият файл е в системния PATH.
  • 🧪 Редакторът е по избор: RubyMine предлага синтактично подчертаване и навигация по стъпки, но всеки редактор, който запазва обикновен текст, ще изпълни файл с функции.
  • 🛠️ Драйвер за браузър: Watir тайна Selenium и управлява браузъра; съвременното име на скъпоценния камък е watir, а не пенсионираното watir-webdriver.
  • 📊 Фиксирано оформление: Файловете с характеристики се намират под features, дефинициите на стъпките под features/step_definitions или Cucumber не може да съответства на стъпка.

Изтеглете и инсталирайте Cucumber on Windows с Ruby, RubyMine и Watir

Cucumber Инсталацията може да изглежда досадна, но е сравнително лесна, след като частите са взети в правилния ред. Ето пътната карта на компонентите, които трябва да бъдат инсталирани, за да се направи Cucumber работят.

Предварителни изисквания за инсталиране Cucumber on Windows

Cucumber се разпространява като Ruby gem, така че нищо не работи, докато Ruby не е наличен. Проверете следното, преди да изтеглите каквото и да било:

  • Windows 10 или по-нова версия, 64-битова. RubyInstaller вече не препоръчва 32-битовата версия, освен ако не разчитате на 32-битови native DLL файлове или COM обекти.
  • Администраторски права. Инсталаторът записва в Program Files и редактира променливата на средата PATH.
  • Интернет връзка. И двете команди за инсталиране на gem по-долу извличат пакети от RubyGems.
  • Около 1 GB свободно дисково пространство за Ruby плюс комплекта за разработка MSYS2 и още много други, ако добавите RubyMine.
  • Браузър за автоматизиране. Watir кара Chrome, Edge или Firefox чрез Selenium, така че поне един трябва да бъде инсталиран.

Две команди си струва да запомните за по-късно: рубин -в отпечатва Ruby версията и скъпоценен камък -v отпечатва версията на RubyGems. Ако някоя от двете не успее, PATH не е актуализиран и инсталаторът трябва да се стартира отново, вместо да се отстраняват грешки.

Инсталирайте Ruby и DevKit

Започнете с пакета Ruby+Devkit, който включва инструментариума за компилиране, от който се нуждаят скъпоценните камъни с C разширения.

Стъпка 1) Отидете на https://rubyinstaller.org/downloads/ и изберете инсталатор. Страницата за изтегляне е показана по-долу.

Страница за изтегляне на RubyInstaller, в която са изброени инсталаторите на Ruby и Ruby+Devkit

⚠️ Бележка към версията: Отделният DevKit архив, за който се отнася оригиналното ръководство, е заменен от инструментариума MSYS2, който... Ruby+Devkit инсталационните пакети се предлагат като избираем компонент. RubyInstaller в момента препоръчва версията Ruby+Devkit 4.0.X (x64) за нови потребители, а комплектът се актуализира по-късно с инсталиране на ridk а не чрез повторно изпълнение на dk.rb. Стъпките по-долу са непроменени.

Стъпка 2) Отворете изтегления файл. На първия екран:

  1. Приемете лиценза
  2. Щракнете върху бутона Напред

Екран с лицензионното споразумение на инсталатора на Ruby с бутона „Напред“

Стъпка 3) На следващия екран:

  1. Изберете вашата инсталационна директория
  2. Изберете всички опции
  3. Кликнете върху Инсталиране

Избор на директорията за инсталиране на Ruby и избиране на всички опции за инсталиране

Стъпка 4) На следващия екран щракнете върху „Напред“.

Екран за избор на компоненти на инсталатора на Ruby преди началото на копирането

Стъпка 5) Изчакайте инсталацията да завърши.

Напредък на инсталирането на Ruby, докато файловете се копират на диск

Стъпка 6) Кликнете върху „Готово“.

Финален екран на инсталатора на Ruby с бутона Finish

Стъпка 7) След като инсталацията приключи, стартирайте Ruby от Windows Старт меню.

Windows Запис в менюто „Старт“, който отваря командния ред с Ruby

Стъпка 8) Ще видите команден ред на Ruby, подобен на Windows прозорец на командната кутия.

Прозорецът на командния ред на Ruby е готов да приема gem команди

Инсталирайте Cucumber

С Ruby на PATH, самият gem е една единствена команда.

Стъпка 1) Въведете инсталиране на краставица от скъпоценен камък в командния ред на Ruby. Тази команда изтегля и инсталира Cucumber в самия команден ред.

gem install cucumber, въведено в командния ред на Ruby

След няколко секунди Cucumber Процедурата по инсталиране стартира и докладва всяка зависимост, която извлича.

Cucumber изход от инсталирането на gem, изброяващ инсталираните зависимости

Стъпка 2) За да се провери дали Cucumber инсталирано успешно, въведете краставица – версияОбърнете внимание на двете тирета — едно тире не е валидна дълга опция.

командата cucumber --version отпечатва инсталираната версия Cucumber версия

Инсталирайте IDE RubyMine

Редакторът не е строго задължителен, но RubyMine разбира Gherkin и може да преминава от стъпка към неговата дефиниция. Следвайте стъпките по-долу, за да го инсталирате.

Начален екран на съветника за настройка на RubyMine

Стъпка 1) Кликнете върху „Напред“, за да продължите с инсталирането на RubyMine.

Първа страница на инсталатора на RubyMine с бутона „Напред“

Стъпка 2) Изберете мястото за инсталиране.

Избор на инсталационната папка на RubyMine

Стъпка 3) Задайте опциите за инсталиране.

Опции за инсталиране на RubyMine, като например преки пътища и файлови асоциации

Стъпка 4) Изберете папката в менюто „Старт“.

Избор на папката в менюто „Старт“ за пряк път на RubyMine

Стъпка 5) Кликнете върху „Инсталиране“.

Инсталаторът на RubyMine е готов да копира файлове след щракване върху „Инсталирай“.

Стъпка 6) Кликнете върху „Готово“.

Екранът за завършена настройка на RubyMine с бутона „Готово“

Стъпка 7) Изберете Не импортирай настройките.

Диалогов прозорец за настройки за импортиране при първото стартиране на RubyMine

Стъпка 8) Кликнете върху „Оценка“.

Прозорец за активиране на лиценза на RubyMine с опцията „Оценка“

Стъпка 9) Приемете лиценза.

Приемане на лицензионното споразумение на RubyMine

Стъпка 10) Изберете „Пропускане на оставащите“ и „Задаване на настройки по подразбиране“.

Начален екран за персонализиране на RubyMine с „Пропускане на оставащи“ и „Задаване на настройки по подразбиране“

Стъпка 11) Отворете редактора.

Начален екран на RubyMine с опцията „Отваряне“

Стъпка 12) Създайте нов проект.

Диалогов прозорец за нов проект в RubyMine

⚠️ Бележка към версията: RubyMine е платена JetBrains продукт с ограничена във времето оценка, която се стартира с бутона „Оценка“ в стъпка 8. Безплатна алтернатива е Visual Studio Code с рубин и Cucumber (Gherkin) разширение; останалата част от това ръководство работи по един и същи начин и в двата редактора.

Инсталирайте watir-webdriver

Cucumber само изпълнява стъпките. Нещо друго трябва да отвори браузъра и тази задача принадлежи на Watir, обвивка на Ruby около SeleniumАко предпочитате да управлявате браузъра директно, същият проект може да извика обикновен Скрипт за уеб драйвер.

Стъпка 1) Кликнете върху Стартирайте командния ред с Ruby и изпълнете командата за инсталиране инсталиране на скъпоценен камък watir-webdriver.

gem install watir-webdriver, работещ в командния ред на Ruby

Стъпка 2) Gem-пакетът watir-webdriver се инсталира успешно.

Изход от конзолата, потвърждаващ инсталирането на watir-webdriver gem

⚠️ Бележка за отхвърляне: скъпоценният камък watir-webdriver беше сгънат в основния уатир скъпоценен камък в Watir 6.0, а собственото му хранилище вече насочва потребителите само към замяната. На нова машина, стартирана инсталиране на скъпоценен камък watir вместо това. Горната историческата команда се запазва, защото е показана на екранните снимки.

Cucumber Структура на папките на проекта

Cucumber открива файлове по конвенция, а не по конфигурация, така че оформлението е по-важно, отколкото изглежда на пръв поглед. Минималистичният проект изглежда така:

Път Приема
характеристики/ Всеки .feature файл, написан на Gherkin. Cucumber търси тук по подразбиране.
функции/дефиниции_на_стъпките/ Ruby файловете, чиито блокове съответстват на всеки ред Given, When и Then.
функции/поддръжка/ Кодът за настройка се зарежда преди изпълнението на която и да е стъпка, като например env.rb, където обикновено се отваря и затваря браузърът.

Две правила спестяват много объркване по-късно. Cucumber игнорира ключовата дума, когато тя съвпада със стъпка, така че Като се има предвид, че имам променлива a намлява Тогава имам променлива a сблъскват се с едно и също определение. И текстът на стъпката във файла с характеристики трябва да съвпада точно с регулярния израз във файла със стъпки, включително пунктуационните знаци.

Първо Cucumber Сценарий

Примерът по-долу умножава две числа, което е достатъчно, за да докаже, че файлът с характеристики, файлът с стъпки и gem-а си взаимодействат.

Стъпка 1) Отворете редактора на RubyMine от Windows Старт меню.

Отваряне на RubyMine от Windows Старт менюто

Таблото за управление на RubyMine изглежда както е показано по-долу.

Таблото за управление на RubyMine се показва след отваряне на редактора

Стъпка 2) Създайте нов проект в редактора на RubyMine.

Стартиране на нов проект от таблото за управление на RubyMine

Дайте име и местоположение на проекта, след което потвърдете.

Въвеждане на името и местоположението на проекта в диалоговия прозорец за нов проект

Стъпка 3) Създайте файлова директория.

Създаване на нова директория в проекта RubyMine

Новата директория се появява в дървото на проекта.

Дърво на проекта, показващо новосъздадената директория с функции

Стъпка 4) Създайте и запазете файл в вашатапапка/функции/ с името име на файл.функция.

Създаване на файла с функции в директорията с функции

Потвърдете името на файла, така че да завършва с разширението .feature.

Именуване на новия файл с разширението .feature

Стъпка 5) За да изпълним нашия сценарий, запазете следните команди във файла с функции.

Файлът с функции е отворен в редактора на RubyMine и е готов за сценария.

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

Стъпка 6) Сега стартирайте първия файл с функции.

Кликнете върху Стартирайте командния ред с Ruby и изпълнете командата cucumber от папката на проекта.

Стартиране на командния ред на Ruby за изпълнение на файла с функции

Конзолата докладва резултата, както е показано по-долу.

Изход от конзолата от първия Cucumber изпълнение на файла с характеристики

Стъпка 7) Създайте файл с дефиниция на стъпка за файла с характеристики.

Създайте нова папка в редактора на RubyMine.

Създаване на нова папка в проекта RubyMine за дефиниции на стъпки

Именуване на новата папка с дефиниции на стъпки

Стъпка 8) Запазете файла в вашатапапка/функции/дефиниции_на_стъпките с името test_step.rb.

Запазване на нов Ruby файл в папката с дефиниции на стъпки

Въвеждане на test_step.rb като име на файла за дефиниране на стъпка

Стъпка 9) Напишете следния код във файла със стъпки.

Файлът с дефиницията на стъпката се отваря в редактора, преди да се добави кодът

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

Стъпка 10) Сега стартирайте файла с функциите отново.

Изпълнение на файла с характеристиките втори път, след като стъпките са дефинирани

Резултатът се отпечатва в конзолата и всяка стъпка се отчита като изпълнена.

Cucumber конзолен изход след изпълнение на файла с дефинирани стъпки

Общ Cucumber Грешки при инсталиране и как да ги поправим

Повечето неуспехи на този етап идват от околната среда, а не от CucumberТова са онези, които си струва да се разпознаят от пръв поглед.

Съобщение Причина Фиксирайте
„краставица“ не се разпознава като вътрешна или външна команда Директорията Ruby bin не е в PATH или сте в обикновен cmd прозорец. отворено Стартирайте командния ред с Rubyили преинсталирайте Ruby с избрана опция PATH.
SSL_connect returned=1 errno=0 state=error: проверката на сертификата не е успешна RubyGems не може да валидира веригата от сертификати, обикновено зад корпоративен прокси. Актуализирайте RubyGems с gem update –system или конфигурирайте проксито с ключа –http-proxy.
ГРЕШКА: Неуспешно изграждане на разширението gem native Липсва комплектът за разработка MSYS2. Стартирайте ridk install и изберете опциите за инструменти MSYS2 и MINGW.
невалидна опция: -version За дълга опция е използвано едно тире. Напишете краставица – версия с две тирета.
Неопределена стъпка, с предложен фрагмент, отпечатан под нея Cucumber намерен е файлът с характеристиките, но няма съответстваща дефиниция. Поставете предложения фрагмент във файл под features/step_definitions и попълнете тялото.
не може да се зареди такъв файл — watir Gem-ът е инсталиран за различна версия на Ruby от тази, която се изпълнява. Проверете ruby ​​-v и gem list watir в същия ред, след което преинсталирайте gem там.

След като сценарият за умножение отчете успешно преминаване, инсталацията е завършена и същият проект може да се превърне в пълноценен тестване за автоматизация апартамент, независимо дали се използва за функционално тестване или всяка вечер регресионно тестване.

Въпроси и Отговори

Не. Cucumber-JVM покрива Java, Котлин и Скала, Cucumber.js покрива JavaСъществуват скриптове и портове за няколко други езика. Версията на Ruby, описана тук, е оригиналната имплементация, а синтаксисът на Gherkin е идентичен във всички тях.

Всеки редактор работи, защото файлът с функции е обикновен текст. RubyMine добавя автоматично довършване на Gherkin и преход към дефиниция, докато Visual Studio Code предлага подобно поведение безплатно чрез разширение за Ruby и Cucumber удължаване.

Да, за всеки пакет, който се изпълнява от повече от един човек. Gemfile с изрична версия тип „cucurbita“ и потвърден Gemfile.lock означава, че всяка машина и всеки CI агент разрешава един и същ gem, което премахва цял клас от повреди „работи на моята машина“.

Ни най-малко. Watir е удобна опаковка върху Selenium, така че можете да изисквате gem-а selenium-webdriver директно в дефинициите на стъпките си. Watir просто дава по-кратък синтаксис на елементите за Ruby проекти.

Cucumber вече отпечатва фрагмент за всяка недефинирана стъпка, а асистентите с изкуствен интелект го разширяват, като попълват тялото от околните обекти на страницата. Третирайте резултата като първа чернова, защото генерираните селектори често са грешни.

Така е. Copilot разпознава „Характеристика“, „Сценарий“, „Дадено“, „Когато“ и „Тогава“ и ще предложи допълнителни сценарии в същия стил. Най-слаб е в преценката кои сценарии наистина добавят покритие, вместо да повтарят съществуващ.

Надстройките с пачове в рамките на един клон, като например от 3.4.0 до 3.4.3, могат да използват повторно същата директория и да запазят съществуващите gem-ове. Преместването между стабилни клонове изисква нова целева директория, защото gem-овете с C разширения не са съвместими между тях.

Три покриват повечето нужди: –dry-run проверява дали всяка стъпка има дефиниция, без да изпълнява нищо, –tags изпълнява етикетирано подмножество от сценарии и –format задава репортера, например pretty output локално и JSON или HTML за build сървър.

Обобщете тази публикация с: