Как скачать и установить CUCUMBER в Windows

⚡ Умное резюме

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

  • 🔘 Сначала Ruby: Cucumber Это Ruby-гем, поэтому перед всем остальным необходимо установить установщик Ruby+Devkit из RubyInstaller.
  • ☑️ Одна команда: Команда `gem install cucumber` загружает гем и его зависимости непосредственно из RubyGems через командную строку.
  • Проверьте немедленно: Запуск команды cucumber –version подтверждает, что гем разрешен и исполняемый файл находится в системной переменной 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-гем, поэтому ничего не будет работать, пока не будет установлен Ruby. Перед загрузкой убедитесь в следующем:

  • Windows 10 или более поздняя версия, 64-бит. RubyInstaller больше не рекомендует 32-битную сборку, если вы не используете 32-битные нативные DLL-файлы или COM-объекты.
  • Права администратора. Установщик записывает данные в папку Program Files и изменяет переменную среды PATH.
  • Интернет-соединение. Обе приведенные ниже команды установки гемов загружают пакеты из RubyGems.
  • Примерно 1 ГБ свободного места на диске. для Ruby плюс комплект разработки MSYS2, и еще больше, если добавить RubyMine.
  • Браузер для автоматизации. Watir управляет Chrome, Edge или Firefox через Selenium, поэтому необходимо установить как минимум один.

Две команды стоит запомнить на будущее: ruby -v выводит версию на Ruby, и gem -v Выводит версию RubyGems. Если что-то из этого не сработает, значит, переменная PATH не была обновлена, и установщик следует запустить заново, а не отлаживать.

Установите Ruby и DevKit.

Начните с пакета Ruby+Devkit, который включает в себя набор инструментов компилятора, необходимых для гемов с расширениями на языке C.

Шаг 1) Перейти к https://rubyinstaller.org/downloads/ и выберите установщик. Страница загрузки показана ниже.

На странице загрузок RubyInstaller представлен список установщиков Ruby и Ruby+Devkit.

⚠️ Примечание к версии: Отдельный архив DevKit, упомянутый в первоначальном руководстве, был заменен набором инструментов MSYS2, который Рубин+Девкит Установщик включает в себя компонент, который можно выбрать. В настоящее время RubyInstaller рекомендует новым пользователям сборку Ruby+Devkit 4.0.X (x64), а обновление комплекта будет произведено позже. установка ридка вместо повторного запуска dk.rb. В остальном описанные ниже шаги остаются без изменений.

Шаг 2) Откройте загруженный файл. На первом экране:

  1. Принять лицензию
  2. Нажмите кнопку Далее

Экран лицензионного соглашения установщика Ruby с кнопкой «Далее».

Шаг 3) На следующем экране:

  1. Выберите каталог для установки
  2. Выберите все варианты
  3. Нажмите «Установить».

Выберите каталог установки Ruby и выберите все параметры установщика.

Шаг 4) На следующем экране нажмите «Далее».

Экран выбора компонентов установщика Ruby перед началом копирования

Шаг 5) Дождитесь завершения установки.

Ход установки Ruby во время копирования файлов на диск.

Шаг 6) Нажмите «Готово».

Финальный экран установщика Ruby с кнопкой «Готово».

Шаг 7) После завершения установки запустите Ruby из... Windows Стартовое меню.

Windows Пункт меню «Пуск», открывающий командную строку с Ruby.

Шаг 8) Вы увидите командную строку Ruby, похожую на следующую: Windows Окно командной строки.

Окно командной строки Ruby готово принимать команды gem.

Установите Cucumber

В Ruby, подключенном к PATH, сам гем представляет собой всего одну команду.

Шаг 1) Введите драгоценный камень установить огурец в командной строке Ruby. Эта команда загружает и устанавливает Cucumber непосредственно в командной строке.

команду `gem install cucumber` вводится в командную строку Ruby.

Через несколько секунд Cucumber Запускается процедура установки, которая сообщает о каждой загружаемой зависимости.

Cucumber Вывод команды `gem install`, содержащий список устанавливаемых зависимостей.

Шаг 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Если вы предпочитаете управлять браузером напрямую, в рамках того же проекта можно вызвать обычный интерфейс. Скрипт WebDriver.

Шаг 1) Нажмите на Запуск командной строки с помощью Ruby и выполните команду установки. gem install watir-webdriver.

Выполните команду `gem install watir-webdriver` в командной строке Ruby.

Шаг 2) Гем watir-webdriver успешно установлен.

Вывод консоли подтверждает установку гема watir-webdriver.

⚠️ Примечание об устаревании: Гем watir-webdriver был интегрирован в основной код. ватир драгоценность в Watir 6.0, и теперь собственный репозиторий просто указывает пользователям на замену. На новой машине запустите gem install watir Вместо этого. Приведенная выше историческая команда сохранена, поскольку именно ее показывают скриншоты.

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

Cucumber Файлы обнаруживаются по соглашению, а не по конфигурации, поэтому структура имеет большее значение, чем кажется на первый взгляд. Минимальный проект выглядит так:

Тропа Содержит
функции/ Все файлы .feature написаны на Gherkin. Cucumber Поиск по умолчанию осуществляется здесь.
features/step_definitions/ Файлы Ruby, блоки которых соответствуют каждой строке Given, When и Then.
функции/поддержка/ Код инициализации загружается перед выполнением любого шага, например, файл env.rb, в котором обычно открывается и закрывается браузер.

Два правила позволяют избежать множества путаницы в дальнейшем. Cucumber игнорирует ключевое слово, если оно соответствует шагу, поэтому Учитывая, что у меня есть переменная a и Тогда у меня есть переменная a. конфликтуют с одним и тем же определением. И текст шага в файле описания объекта должен точно соответствовать регулярному выражению в файле шага, включая знаки препинания.

Имя Cucumber Сценарий

В приведенном ниже примере происходит умножение двух чисел, чего достаточно, чтобы доказать, что файл описания функций, файл шагов и библиотека взаимодействуют друг с другом.

Шаг 1) Откройте редактор RubyMine из Windows Стартовое меню.

Открытие RubyMine из Windows Меню Пуск

Панель управления RubyMine выглядит так, как показано ниже.

Панель управления RubyMine отображается после открытия редактора.

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

Создание нового проекта из панели управления RubyMine.

Присвойте проекту название и укажите местоположение, а затем подтвердите.

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

Шаг 3) Создайте файловую директорию.

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

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

Дерево проекта, отображающее недавно созданный каталог функций.

Шаг 4) Создайте и сохраните файл в ваша папка/функции/ с именем yourfilename.feature.

Создание файла описания функции внутри каталога features.

Убедитесь, что имя файла заканчивается расширением .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) Сохраните файл в yourfolder/features/step_definititons с именем 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Именно их можно узнать с первого взгляда.

Сообщение Вызывать фиксированный
Команда 'cucumber' не распознается ни как внутренняя, ни как внешняя команда. Каталог bin Ruby отсутствует в переменной PATH, или вы находитесь в обычном окне командной строки. Открыто Запуск командной строки с помощью Rubyили переустановите Ruby, выбрав опцию PATH.
SSL_connect вернул=1 errno=0 state=error: проверка сертификата не удалась RubyGems не может проверить цепочку сертификатов, обычно используя корпоративный прокси-сервер. Обновите RubyGems с помощью команды `gem update –system` или настройте прокси с помощью ключа `--http-proxy`.
ОШИБКА: Не удалось собрать нативное расширение гема. Комплект разработчика MSYS2 отсутствует. Запустите команду `ridk install` и выберите параметры цепочки инструментов MSYS2 и MINGW.
Недопустимый параметр: -version Для длинного варианта использовался один дефис. Введите cucumber –version с двумя дефисами.
Неопределенный шаг, под которым напечатан предлагаемый фрагмент кода. Cucumber Файл с описанием объекта найден, но соответствующее определение отсутствует. Вставьте предложенный фрагмент кода в файл в папке features/step_definitions и заполните его содержимое.
не удается загрузить такой файл — watir Установленный гем предназначен для другой версии Ruby, нежели та, которая используется в текущей версии. В той же командной строке выполните команды `ruby -v` и `gem list watir`, затем переустановите гем там же.

Как только сценарий умножения подтвердит успешное завершение, установка будет закончена, и тот же проект может разрастись до полноценного проекта. автоматизация тестирования номер, независимо от того, для чего он используется функциональное тестирование или ночью регрессионное тестирование.

Часто задаваемые вопросы (FAQ)

№ CucumberJVM охватывает JavaKotlin и Scala. Cucumber.js охватывает JavaСуществуют скрипты и порты для нескольких других языков. Описанная здесь версия на Ruby является оригинальной реализацией, и синтаксис Gherkin идентичен во всех них.

Подойдет любой редактор, поскольку файл с описанием функций представляет собой обычный текст. RubyMine добавляет автозавершение кода и переход к определению в стиле Gherkin, а Visual Studio Code Аналогичное поведение предлагается бесплатно через расширение Ruby и Cucumber расширение.

Да, для любого набора тестов, запущенного более чем одним человеком. Gemfile с явно указанной версией Cucumber и зафиксированным Gemfile.lock означает, что каждая машина и каждый агент CI разрешают один и тот же гем, что устраняет целый класс проблем, когда все работает на моей машине.

Вовсе нет. Watir это удобная обертка над SeleniumТаким образом, вы можете напрямую подключить гем selenium-webdriver в определениях шагов. Watir просто предоставляет более короткий синтаксис элементов для проектов на Ruby.

Cucumber Уже сейчас для каждого неопределенного шага выводится фрагмент кода, а ИИ-помощники расширяют это, заполняя тело кода за счет окружающих объектов страницы. Рассматривайте вывод как черновик, поскольку сгенерированные селекторы часто бывают неверными.

Да, это так. Copilot распознает категории Feature, Scenario, Given, When и Then и предложит дополнительные сценарии в том же стиле. Однако он хуже всего справляется с оценкой того, какие сценарии действительно расширяют охват, а не просто повторяют уже существующие.

Обновление патчей внутри одной ветки, например, с 3.4.0 до 3.4.3, позволяет использовать ту же директорию и сохранить существующие гемы. Для перехода между стабильными ветками требуется новая целевая директория, поскольку гемы с расширениями на языке C несовместимы между ними.

Три варианта удовлетворяют большинству потребностей: –dry-run проверяет, что у каждого шага есть определение, не выполняя ничего, –tags запускает помеченное подмножество сценариев, и –format задает объект для формирования отчета, например, красиво оформленный вывод локально и JSON или HTML для сервера сборки.

Подведем итог этой публикации следующим образом: