Jak pobrać i zainstalować CUCUMBER w Windows
⚡ Inteligentne podsumowanie
Cucumber instalacja włączona Windows potrzebuje czterech części w kolejności: Ruby z zestawem deweloperskim, Cucumber Sam gem, edytor taki jak RubyMine i biblioteka sterowników przeglądarki. Instalacja każdego z nich zajmuje kilka minut.
Cucumber Instalacja może wydawać się żmudna, ale jest stosunkowo łatwa, gdy elementy zostaną ułożone w odpowiedniej kolejności. Oto plan działania dotyczący komponentów, które należy zainstalować, aby… Cucumber praca.
Wymagania wstępne dotyczące instalacji Cucumber on Windows
Cucumber jest dystrybuowany jako klejnot Ruby, więc nic nie działa, dopóki Ruby nie będzie obecny. Przed pobraniem sprawdź poniższe:
- Windows 10 lub nowszy, 64-bitowy. RubyInstaller nie zaleca już kompilacji 32-bitowej, chyba że potrzebujesz 32-bitowych natywnych bibliotek DLL lub obiektów COM.
- Uprawnienia administratora. Instalator zapisuje dane w Program Files i edytuje zmienną środowiskową PATH.
- Połączenie internetowe. Oba poniższe polecenia gem install pobierają pakiety z RubyGems.
- Około 1 GB wolnego miejsca na dysku dla Ruby, a także zestaw narzędzi deweloperskich MSYS2 i jeszcze więcej, jeśli dodasz RubyMine.
- Przeglądarka do automatyzacji. Watir obsługuje Chrome, Edge lub Firefox przez Selenium, więc co najmniej jeden musi być zainstalowany.
Warto zapamiętać na później dwa polecenia: ruby -v drukuje wersję Ruby i klejnot -v Wyświetla wersję RubyGems. Jeśli którakolwiek z tych opcji się nie powiedzie, ścieżka PATH nie została zaktualizowana i instalator powinien zostać uruchomiony ponownie, a nie debugowany.
Zainstaluj Ruby i DevKit
Zacznij od pakietu Ruby+Devkit, który zawiera zestaw narzędzi kompilatora potrzebny bibliotekom gem z rozszerzeniami C.
Krok 1) Przejdź do https://rubyinstaller.org/downloads/ i wybierz instalator. Strona pobierania znajduje się poniżej.
⚠️ Uwaga dotycząca wersji: oddzielne archiwum DevKit, do którego odnosi się oryginalny przewodnik, zostało zastąpione przez zestaw narzędzi MSYS2, który Ruby+zestaw deweloperski Pakiety instalatora są dostępne jako komponenty do wyboru. RubyInstaller obecnie zaleca nowym użytkownikom kompilację Ruby+Devkit 4.0.X (x64), a zestaw będzie później aktualizowany o usuń instalację zamiast ponownego uruchamiania pliku dk.rb. Poniższe kroki pozostają bez zmian.
Krok 2) Otwórz pobrany plik. Na pierwszym ekranie:
- Zaakceptuj licencję
- Kliknij przycisk Dalej
Krok 3) Na następnym ekranie:
- Wybierz katalog instalacyjny
- Zaznacz wszystkie opcje
- Kliknij przycisk Zainstaluj
Krok 4) Na następnym ekranie kliknij Dalej.
Krok 5) Poczekaj na zakończenie instalacji.
Krok 6) Kliknij Zakończ.
Krok 7) Po zakończeniu instalacji uruchom Ruby z Windows Menu Start.
Krok 8) Zobaczysz wiersz poleceń Ruby podobny do Windows okno cmd.
Zainstalować Cucumber
W przypadku Ruby w PATH sam klejnot jest pojedynczym poleceniem.
Krok 1) Wpisz klejnot instaluj ogórek w wierszu poleceń Ruby. To polecenie pobiera i instaluje Cucumber bezpośrednio w wierszu poleceń.
Po kilku sekundach Cucumber rozpoczyna się procedura instalacyjna, która raportuje każdą pobraną zależność.
Krok 2) Aby sprawdzić, czy Cucumber zainstalowano pomyślnie, wpisz ogórek – wersja. Zwróć uwagę na dwa myślniki — pojedyncza myślnik nie jest prawidłową opcją długą.
Zainstaluj IDE RubyMine
Edytor nie jest wymagany, ale RubyMine rozumie Gherkina i potrafi przejść od kroku do jego definicji. Wykonaj poniższe kroki, aby go zainstalować.
Krok 1) Kliknij Dalej, aby kontynuować instalację RubyMine.
Krok 2) Wybierz miejsce instalacji.
Krok 3) Ustaw opcje instalacji.
Krok 4) Wybierz folder menu Start.
Krok 5) Kliknij Zainstaluj.
Krok 6) Kliknij Zakończ.
Krok 7) Wybierz Nie importuj ustawień.
Krok 8) Kliknij Oceń.
Krok 9) Zaakceptuj licencję.
Krok 10) Wybierz opcję Pomiń pozostałe i Ustaw wartości domyślne.
Krok 11) Otwórz edytor.
Krok 12) Utwórz nowy projekt.
⚠️ Uwaga dotycząca wersji: RubyMine jest płatny JetBrains produkt z ograniczoną czasowo oceną, którą uruchamia przycisk „Oceń” w kroku 8. Bezpłatną alternatywą jest Visual Studio Code z Rubinem i Cucumber rozszerzenie (Gherkin); reszta tego przewodnika działa w ten sam sposób w obu edytorach.
Zainstaluj watir-webdriver
Cucumber uruchamia tylko kroki. Coś innego musi otworzyć przeglądarkę, a to zadanie należy do Watir, opakowanie Ruby SeleniumJeśli wolisz sterować przeglądarką bezpośrednio, ten sam projekt może wywołać zwykły Skrypt WebDriver.
Krok 1) Kliknij Uruchom wiersz poleceń za pomocą Ruby i uruchom polecenie instalacyjne gem install watir-webdriver.
Krok 2) Instalacja modułu watir-webdriver przebiegła pomyślnie.
⚠️ Uwaga dotycząca wycofania: klejnot watir-webdriver został złożony w głównym pliku czekać klejnot w Watir 6.0 i jego własne repozytorium teraz wskazują użytkownikom tylko zamiennik. Na nowym komputerze uruchom gem install watir Zamiast tego zachowano powyższe polecenie historyczne, ponieważ jest ono widoczne na zrzutach ekranu.
Cucumber Struktura folderów projektu
Cucumber Odkrywa pliki według konwencji, a nie konfiguracji, więc układ ma większe znaczenie, niż mogłoby się wydawać na pierwszy rzut oka. Minimalny projekt wygląda tak:
| ścieżka | Mieści |
|---|---|
| cechy/ | Każdy plik .feature napisany w Gherkinie. Cucumber wyszukuje tutaj domyślnie. |
| funkcje/definicje_kroków/ | Pliki Ruby, których bloki pasują do każdej linii Given, When i Then. |
| funkcje/wsparcie/ | Kod konfiguracji jest ładowany przed wykonaniem dowolnego kroku, np. env.rb, w którym zwykle otwiera się i zamyka przeglądarkę. |
Dwie zasady pozwalają uniknąć wielu nieporozumień w przyszłości. Cucumber ignoruje słowo kluczowe, gdy pasuje do kroku, więc Biorąc pod uwagę, że mam zmienną a oraz Następnie mam zmienną a kolidują z tą samą definicją. Tekst kroku w pliku funkcji musi dokładnie odpowiadać wyrażeniu regularnemu w pliku kroku, łącznie z interpunkcją.
Imię Cucumber Scenariusz
Poniższy przykład mnoży dwie liczby, co wystarcza, aby udowodnić, że plik funkcji, plik kroków i klejnot komunikują się ze sobą.
Krok 1) Otwórz edytor RubyMine z Windows Menu Start.
Panel RubyMine wygląda tak, jak pokazano poniżej.
Krok 2) Utwórz nowy projekt w edytorze RubyMine.
Podaj nazwę i lokalizację projektu, a następnie potwierdź.
Krok 3) Utwórz katalog plików.
Nowy katalog pojawi się w drzewie projektu.
Krok 4) Utwórz i zapisz plik w twójfolder/funkcje/ z nazwą twojanazwapliku.funkcja.
Sprawdź, czy nazwa pliku kończy się rozszerzeniem .feature.
Krok 5) Aby zrealizować nasz scenariusz, zapisz następujące polecenia w pliku funkcji.
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) Teraz uruchom pierwszy plik funkcji.
Kliknij na Uruchom wiersz poleceń za pomocą Ruby i uruchom polecenie Cucumber z folderu projektu.
Konsola wyświetla wynik w sposób pokazany poniżej.
Krok 7) Utwórz plik definicji kroku dla pliku funkcji.
Utwórz nowy folder w edytorze RubyMine.
Krok 8) Zapisz plik w twójfolder/funkcje/definicje_kroków z nazwą krok_testowy.rb.
Krok 9) Zapisz poniższy kod w pliku kroków.
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) Teraz uruchom ponownie plik funkcji.
Wynik jest wyświetlany na konsoli, a każdy krok jest oznaczany jako zaliczony.
wspólny Cucumber Błędy instalacji i jak je naprawić
Większość awarii na tym etapie wynika raczej ze środowiska niż z Cucumber. To te, które warto rozpoznać na pierwszy rzut oka.
| Treść wiadomości | Spowodować | Fix |
|---|---|---|
| „ogórek” nie jest rozpoznawany jako polecenie wewnętrzne lub zewnętrzne | Katalog bin Ruby nie znajduje się w zmiennej środowiskowej PATH lub znajdujesz się w zwykłym oknie poleceń. | Otwarte Uruchom wiersz poleceń za pomocą Rubylub zainstaluj ponownie Ruby z wybraną opcją PATH. |
| SSL_connect zwróciło=1 errno=0 state=błąd: weryfikacja certyfikatu nie powiodła się | RubyGems nie jest w stanie zweryfikować łańcucha certyfikatów, zwykle korzystając z korporacyjnego serwera proxy. | Zaktualizuj RubyGems za pomocą polecenia gem update –system lub skonfiguruj serwer proxy za pomocą przełącznika –http-proxy. |
| BŁĄD: Nie udało się zbudować natywnego rozszerzenia gem | Brakuje zestawu deweloperskiego MSYS2. | Uruchom ridk install i wybierz opcje zestawu narzędzi MSYS2 i MINGW. |
| nieprawidłowa opcja: -wersja | Do wyboru opcji długiej użyto pojedynczego myślnika. | Wpisz ogórek – wersja z dwoma myślnikami. |
| Niezdefiniowany krok, z sugerowanym fragmentem kodu wydrukowanym poniżej | Cucumber znaleziono plik funkcji, ale nie ma pasującej definicji. | Wklej proponowany fragment kodu do pliku w folderze features/step_definitions i wypełnij jego treść. |
| nie można załadować takiego pliku — czekaj | Ten klejnot został zainstalowany dla innej wersji Ruby niż ta, która jest uruchomiona. | Sprawdź ruby -v i gem list watir w tym samym wierszu poleceń, a następnie ponownie zainstaluj gem. |
Gdy scenariusz mnożenia zgłosi zaliczenie, instalacja zostaje zakończona, a ten sam projekt może rozrosnąć się do pełnego testowanie automatyzacji apartament, niezależnie od tego, czy jest używany do testy funkcjonalności lub nocnych testy regresji.












































