So laden Sie CUCUMBER herunter und installieren es Windows

⚡ Intelligente Zusammenfassung

Cucumber Installation auf Windows benötigt vier Komponenten in der richtigen Reihenfolge: Ruby mit seinem Entwicklungskit, die Cucumber Das Gem selbst, ein Editor wie RubyMine und eine Browsertreiberbibliothek. Jede dieser Komponenten lässt sich in wenigen Minuten installieren.

  • 🔘 Ruby zuerst: Cucumber Da es sich um ein Ruby-Gem handelt, muss der Ruby+Devkit-Installer von RubyInstaller vor allen anderen Installationen installiert sein.
  • ☑️ Ein Befehl: Der Befehl gem install cucumber lädt das Gem und seine Abhängigkeiten direkt von RubyGems über die Kommandozeile herunter.
  • ✅ Sofort überprüfen: Der Befehl cucumber --version bestätigt, dass das Gem aufgelöst wurde und sich die ausführbare Datei im Systempfad befindet.
  • 🧪 Editor optional: RubyMine bietet Syntaxhervorhebung und Schrittnavigation, aber jeder Editor, der Klartext speichert, kann eine Feature-Datei ausführen.
  • ️ Browsertreiber: Watir Wraps Selenium und steuert den Browser; der moderne Gem-Name lautet watir, nicht mehr watir-webdriver.
  • 📊 Festes Layout: Feature-Dateien befinden sich unter features, Schrittdefinitionen unter features/step_definitions, oder Cucumber Ein Schritt kann nicht zugeordnet werden.

Laden Sie  Cucumber on Windows mit Ruby, RubyMine und Watir

Cucumber Die Installation mag auf den ersten Blick mühsam erscheinen, ist aber relativ einfach, sobald die Teile in der richtigen Reihenfolge montiert sind. Hier ist die Übersicht der Komponenten, die zur Herstellung benötigt werden. Cucumber Arbeit.

Voraussetzungen für die Installation Cucumber on Windows

Cucumber Es wird als Ruby-Gem verteilt, daher funktioniert nichts, solange Ruby nicht installiert ist. Bitte überprüfen Sie Folgendes, bevor Sie etwas herunterladen:

  • Windows 10 oder höher, 64-Bit. RubyInstaller empfiehlt die 32-Bit-Version nicht mehr, es sei denn, Sie benötigen 32-Bit-native DLLs oder COM-Objekte.
  • Administratorrechte. Das Installationsprogramm schreibt in das Verzeichnis „Programme“ und ändert die Umgebungsvariable PATH.
  • Eine Internetverbindung. Die beiden unten stehenden gem install-Befehle laden Pakete von RubyGems herunter.
  • Etwa 1 GB freier Speicherplatz für Ruby plus das MSYS2-Entwicklungskit, und noch mehr, wenn Sie RubyMine hinzufügen.
  • Ein Browser zur Automatisierung. Watir treibt Chrome, Edge oder Firefox - durch Konsolidierung, SeleniumDaher muss mindestens eines installiert sein.

Zwei Befehle sollte man sich für später merken: Ruby -v Gibt die Ruby-Version aus, und gem -v Gibt die RubyGems-Version aus. Falls einer der beiden Versuche fehlschlägt, wurde der PATH nicht aktualisiert und das Installationsprogramm sollte erneut ausgeführt statt debuggt werden.

Installieren Sie Ruby und DevKit

Beginnen Sie mit dem Ruby+Devkit-Paket, das die Compiler-Toolchain enthält, die Gems mit C-Erweiterungen benötigen.

Schritt 1) Gehen Sie zu https://rubyinstaller.org/downloads/ und wählen Sie ein Installationsprogramm aus. Die Downloadseite wird unten angezeigt.

RubyInstaller-Downloadseite mit Auflistung der Ruby- und Ruby+Devkit-Installer

⚠️ Versionshinweis: Das separate DevKit-Archiv, auf das sich die ursprüngliche Anleitung bezieht, wurde durch die MSYS2-Toolchain ersetzt, die Ruby+Devkit Das Installationsprogramm ist als auswählbare Komponente enthalten. RubyInstaller empfiehlt derzeit neuen Benutzern die Version Ruby+Devkit 4.0.X (x64), die später aktualisiert wird. Ridk installieren anstatt dk.rb erneut auszuführen. Die folgenden Schritte bleiben ansonsten unverändert.

Schritt 2) Öffnen Sie die heruntergeladene Datei. Auf dem ersten Bildschirm:

  1. Akzeptieren Sie die Lizenz
  2. Klicken Sie auf die Schaltfläche Weiter

Ruby-Installationsbildschirm mit Lizenzvereinbarung und der Schaltfläche „Weiter“

Schritt 3) Auf dem nächsten Bildschirm:

  1. Wählen Sie Ihr Installationsverzeichnis aus
  2. Alle Optionen auswählen
  3. Klicken Sie auf Installieren

Auswahl des Ruby-Installationsverzeichnisses und Auswahl aller Installationsoptionen

Schritt 4) Klicken Sie im folgenden Bildschirm auf Weiter.

Auswahlbildschirm für die Ruby-Installationskomponenten vor Beginn des Kopiervorgangs

Schritt 5) Warten Sie, bis die Installation abgeschlossen ist.

Ruby-Installationsfortschritt während des Kopierens der Dateien auf die Festplatte

Schritt 6) Klicken Sie auf Fertigstellen.

Abschließender Ruby-Installationsbildschirm mit der Schaltfläche „Fertigstellen“

Schritt 7) Sobald die Installation abgeschlossen ist, führen Sie Ruby von der folgenden Seite aus: Windows Startmenü.

Windows Startmenüeintrag, der die Eingabeaufforderung mit Ruby öffnet

Schritt 8) Sie sehen eine Ruby-Befehlszeile, die der folgenden ähnelt: Windows cmd-Fenster.

Ruby-Befehlszeilenfenster bereit zur Annahme von Gem-Befehlen

Installieren Cucumber

Wenn Ruby im PATH vorhanden ist, ist das Gem selbst ein einziger Befehl.

Schritt 1) ​​Typ gem install cucumber in der Ruby-Befehlszeile. Dieser Befehl lädt herunter und installiert Cucumber direkt in der Kommandozeile.

gem install cucumber wurde in die Ruby-Befehlszeile eingegeben

Nach ein paar Sekunden Cucumber Der Installationsvorgang startet und meldet jede installierte Abhängigkeit.

Cucumber Ausgabe der Gem-Installation mit Auflistung der installierten Abhängigkeiten

Schritt 2) Um zu überprüfen, ob Cucumber erfolgreich installiert, Typ GurkenversionBeachten Sie die zwei Bindestriche – ein einzelner Bindestrich ist keine gültige lange Option.

Der Befehl cucumber --version gibt die installierte Version aus Cucumber Version

Installieren Sie die RubyMine-IDE

Ein Editor ist nicht unbedingt erforderlich, aber RubyMine unterstützt Gherkin und kann direkt von einem Schritt zur Definition springen. Folgen Sie den unten stehenden Schritten, um ihn zu installieren.

Willkommensbildschirm des RubyMine-Einrichtungsassistenten

Schritt 1) ​​Klicken Sie auf Weiter, um mit der RubyMine-Installation fortzufahren.

Erste Seite des RubyMine-Installationsprogramms mit der Schaltfläche „Weiter“

Schritt 2) Wählen Sie den Installationsort.

Auswahl des RubyMine-Installationsordners

Schritt 3) Installationsoptionen festlegen.

RubyMine-Installationsoptionen wie Verknüpfungen und Dateizuordnungen

Schritt 4) Wählen Sie den Ordner im Startmenü.

Auswählen des Startmenüordners für die RubyMine-Verknüpfung

Schritt 5) Klicken Sie auf Installieren.

Der RubyMine-Installer ist nach dem Klicken auf „Installieren“ bereit, die Dateien zu kopieren.

Schritt 6) Klicken Sie auf Fertigstellen.

RubyMine-Setup-Bildschirm mit der Schaltfläche „Fertigstellen“ abgeschlossen

Schritt 7) Auswählen Einstellungen nicht importieren.

Dialogfeld „Importeinstellungen“ beim ersten Start von RubyMine

Schritt 8) Klicken Sie auf Auswerten.

RubyMine-Lizenzaktivierungsfenster mit der Option „Evaluieren“

Schritt 9) Akzeptieren Sie die Lizenz.

Annahme des RubyMine-Lizenzvertrags

Schritt 10) Wählen Sie "Überspringen Sie die verbleibenden Schritte" und "Standardeinstellungen festlegen".

RubyMine-Anpassungsbildschirm mit den Optionen „Verbleibende überspringen“ und „Standardwerte festlegen“

Schritt 11) Öffnen Sie den Editor.

RubyMine-Willkommensbildschirm mit der Option „Öffnen“.

Schritt 12) Erstellen Sie ein neues Projekt.

Neuer Projektdialog in RubyMine

⚠️ Versionshinweis: RubyMine ist ein kostenpflichtiges JetBrains Ein Produkt mit zeitlich begrenzter Testphase, die durch die Schaltfläche „Testen“ in Schritt 8 gestartet wird. Eine kostenlose Alternative ist Visual Studio Code mit einem Rubin und einem Cucumber (Gherkin)-Erweiterung; der Rest dieser Anleitung funktioniert in beiden Editoren auf die gleiche Weise.

Installieren Sie watir-webdriver

Cucumber Es werden lediglich die Schritte ausgeführt. Etwas anderes muss den Browser öffnen, und diese Aufgabe gehört zu Watir, ein Ruby-Wrapper um SeleniumWenn Sie den Browser lieber direkt ansteuern möchten, kann dasselbe Projekt eine einfache Funktion aufrufen. WebDriver-Skript.

Schritt 1) Klicken Sie auf Befehlszeile mit Ruby starten und führen Sie den Installationsbefehl aus gem install wair-webdriver.

gem install watir-webdriver läuft in der Ruby-Befehlszeile

Schritt 2) Das watir-webdriver Gem wird erfolgreich installiert.

Konsolenausgabe, die die Installation des watir-webdriver-Gems bestätigt.

⚠️ Hinweis zur Veraltung: Das watir-webdriver-Gem wurde in den Hauptteil integriert. Wasser Juwel bei Watir 6.0, und das zugehörige Repository verweist nun ausschließlich auf die Nachfolgeversion. Führen Sie auf einem neuen Rechner Folgendes aus: gem install wair Stattdessen wird der oben genannte historische Befehl beibehalten, da er in den Screenshots dargestellt ist.

Cucumber Projektordnerstruktur

Cucumber Dateien werden anhand von Konventionen und nicht anhand von Konfigurationen erkannt, daher ist das Layout wichtiger als es zunächst scheint. Ein minimales Projekt sieht folgendermaßen aus:

Path Enthält
Eigenschaften/ Jede .feature-Datei ist in Gherkin geschrieben. Cucumber Die Suche startet standardmäßig hier.
features/step_definitions/ Die Ruby-Dateien, deren Blöcke jeweils einer Given-, When- und Then-Zeile entsprechen.
Funktionen/Unterstützung/ Setup-Code wird geladen, bevor ein Schritt ausgeführt wird, z. B. env.rb, wo normalerweise der Browser geöffnet und geschlossen wird.

Zwei Regeln ersparen später viel Verwirrung. Cucumber Das Schlüsselwort wird ignoriert, wenn es mit einem Schritt übereinstimmt, also Angenommen, ich habe die Variable a und Dann habe ich die Variable a Sie müssen mit derselben Definition kollidieren. Der Schritttext in der Feature-Datei muss exakt mit dem regulären Ausdruck in der Schrittdatei übereinstimmen, einschließlich der Interpunktion.

Vorname Cucumber Skript

Das unten stehende Beispiel multipliziert zwei Zahlen, was ausreicht, um zu beweisen, dass die Feature-Datei, die Step-Datei und das Gem miteinander kommunizieren.

Schritt 1) ​​Öffnen Sie den RubyMine-Editor über den Windows Startmenü.

RubyMine wird von der Windows Startmenü

Das RubyMine-Dashboard sieht wie folgt aus.

Das RubyMine-Dashboard wird nach dem Öffnen des Editors angezeigt.

Schritt 2) Erstellen Sie ein neues Projekt im RubyMine-Editor.

Ein neues Projekt über das RubyMine-Dashboard starten

Geben Sie dem Projekt einen Namen und einen Standort und bestätigen Sie anschließend.

Eingabe des Projektnamens und des Standorts im Dialogfeld „Neues Projekt“

Schritt 3) Erstellen Sie ein Dateiverzeichnis.

Erstellen eines neuen Verzeichnisses innerhalb des RubyMine-Projekts

Das neue Verzeichnis erscheint in der Projektstruktur.

Projektstruktur mit dem neu erstellten Verzeichnis „Features“

Schritt 4) Erstellen und speichern Sie eine Datei in IhrOrdner/Features/ mit der Bezeichnung IhrDateiname.Feature.

Die Feature-Datei wird im Verzeichnis „features“ erstellt.

Bitte überprüfen Sie, ob der Dateiname auf die Dateiendung .feature endet.

Die neue Datei wird mit der Dateiendung .feature benannt.

Schritt 5) Um unser Szenario auszuführen, speichern Sie die folgenden Befehle in der Feature-Datei.

Die Feature-Datei ist im RubyMine-Editor geöffnet und bereit für das Szenario.

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

Schritt 6) Führen Sie nun die erste Feature-Datei aus.

Klicken Sie auf Befehlszeile mit Ruby starten und führe den Cucumber-Befehl aus dem Projektordner aus.

Die Ruby-Befehlszeile wird gestartet, um die Feature-Datei auszuführen.

Die Konsole meldet das Ergebnis wie unten dargestellt.

Konsolenausgabe vom ersten Cucumber Ausführung der Feature-Datei

Schritt 7) Erstellen Sie die Schrittdefinitionsdatei für die Feature-Datei.

Erstelle einen neuen Ordner im RubyMine-Editor.

Im RubyMine-Projekt wird ein neuer Ordner für Schrittdefinitionen erstellt.

Benennung des neuen Ordners für Schrittdefinitionen

Schritt 8) Speichern Sie die Datei in IhrOrdner/Features/Schrittdefinitionen mit der Bezeichnung test_step.rb.

Eine neue Ruby-Datei im Ordner „Schrittdefinitionen“ speichern

test_step.rb als Schrittdefinitionsdateinamen eingeben

Schritt 9) Schreiben Sie den folgenden Code in die STEP-Datei.

Die Schrittdefinitionsdatei muss im Editor geöffnet werden, bevor der Code hinzugefügt wird.

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

Schritt 10) Führen Sie nun die Feature-Datei erneut aus.

Die Feature-Datei wird nach der Definition der Schritte ein zweites Mal ausgeführt.

Das Ergebnis wird in der Konsole ausgegeben, und jeder Schritt wird als bestanden gemeldet.

Cucumber Konsolenausgabe nach Ausführung der Feature-Datei mit definierten Schritten

gemeinsam Cucumber Installationsfehler und wie man sie behebt

Die meisten Fehler in dieser Phase resultieren eher aus der Umgebung als aus der... CucumberDas sind diejenigen, die man auf den ersten Blick erkennt.

Nachricht Verursachen Fixieren
'cucumber' wird nicht als interner oder externer Befehl erkannt. Das Ruby-Binärverzeichnis befindet sich nicht im PATH, oder Sie befinden sich in einem normalen cmd-Fenster. Öffne Befehlszeile mit Ruby startenAlternativ können Sie Ruby mit ausgewählter PATH-Option neu installieren.
SSL_connect gab zurück=1 errno=0 state=error: Zertifikatsprüfung fehlgeschlagen RubyGems kann die Zertifikatskette nicht validieren, da diese üblicherweise hinter einem Unternehmensproxy liegt. Aktualisieren Sie RubyGems mit gem update --system oder konfigurieren Sie den Proxy mit dem Schalter --http-proxy.
FEHLER: Fehler beim Erstellen der nativen Gem-Erweiterung Das MSYS2-Entwicklungskit fehlt. Führen Sie den Befehl ridk install aus und wählen Sie die Toolchain-Optionen MSYS2 und MINGW.
Ungültige Option: -version Für eine lange Option wurde ein einzelner Bindestrich verwendet. Geben Sie „gurke“ ein – Version mit zwei Bindestrichen.
Nicht definierter Schritt, darunter wird ein Code-Vorschlag angezeigt. Cucumber Die Feature-Datei wurde gefunden, aber keine passende Definition. Fügen Sie den vorgeschlagenen Codeausschnitt in eine Datei unter features/step_definitions ein und füllen Sie den Textkörper aus.
Datei kann nicht geladen werden — watir Das installierte Gem ist für eine andere Ruby-Version als die aktuell verwendete. Überprüfen Sie in derselben Eingabeaufforderung die Befehle ruby ​​-v und gem list watir und installieren Sie das Gem anschließend dort neu.

Sobald das Multiplikationsszenario erfolgreich abgeschlossen ist, ist die Installation beendet und dasselbe Projekt kann zu einem vollständigen Projekt ausgebaut werden. Automatisierungstests Suite, ob sie verwendet wird für Funktionsprüfung oder nächtlich Regressionstests.

Häufig gestellte Fragen

Nein. Cucumber-JVM deckt ab JavaKotlin und Scala, Cucumber.js-Abdeckungen JavaEs existieren Skripte und Portierungen für verschiedene andere Sprachen. Die hier beschriebene Ruby-Version ist die Originalimplementierung, und die Gherkin-Syntax ist in allen Versionen identisch.

Jeder Editor funktioniert, da eine Feature-Datei reiner Text ist. RubyMine fügt Gherkin-Autovervollständigung und die Funktion „Zur Definition springen“ hinzu, während Visual Studio Code bietet ähnliches Verhalten kostenlos über eine Ruby-Erweiterung und eine Cucumber Erweiterung.

Ja, das gilt für jede Suite, die von mehreren Personen ausgeführt wird. Eine Gemfile mit einer expliziten Cucumber-Versionsangabe und einer festgeschriebenen Gemfile.lock-Datei stellt sicher, dass auf jedem Rechner und jedem CI-Agenten dasselbe Gem aufgelöst wird. Dadurch wird eine ganze Klasse von Fehlern vermieden, die auf dem eigenen Rechner auftreten können.

Überhaupt nicht. Watir ist eine praktische Verpackung über SeleniumSie können also das selenium-webdriver Gem direkt in Ihren Schrittdefinitionen einbinden. Watir Bietet einfach eine kürzere Elementsyntax für Ruby-Projekte.

Cucumber Es wird bereits für jeden undefinierten Schritt ein Codeausschnitt ausgegeben, und KI-Assistenten erweitern dies, indem sie den Inhalt anhand der umgebenden Seitenobjekte ergänzen. Betrachten Sie die Ausgabe als ersten Entwurf, da generierte Selektoren häufig fehlerhaft sind.

Ja. Copilot erkennt die Kategorien „Feature“, „Szenario“, „Gegeben“, „Wann“ und „Dann“ und schlägt weitere Szenarien im selben Stil vor. Am schwächsten ist es jedoch darin, zu beurteilen, welche Szenarien die Abdeckung tatsächlich erweitern und welche lediglich bestehende wiederholen.

Patch-Upgrades innerhalb eines Branches, beispielsweise von 3.4.0 auf 3.4.3, können dasselbe Verzeichnis wiederverwenden und vorhandene Gems beibehalten. Ein Wechsel zwischen stabilen Branches erfordert ein neues Zielverzeichnis, da Gems mit der Dateiendung C nicht kompatibel sind.

Drei Optionen decken die meisten Bedürfnisse ab: –dry-run prüft, ob jeder Schritt definiert ist, ohne etwas auszuführen; –tags führt eine gekennzeichnete Teilmenge von Szenarien aus; und –format legt das Ausgabeformat fest, z. B. eine lesbare Ausgabe lokal und JSON oder HTML für einen Build-Server.

Fassen Sie diesen Beitrag mit folgenden Worten zusammen: