Comment télécharger et installer CONCOMBRE dans Windows
Thomas Hamilton
⚡ Résumé intelligent
Cucumber installation sur Windows nécessite quatre éléments dans l'ordre : Ruby avec son kit de développement, le Cucumber Le gem lui-même, un éditeur comme RubyMine et une bibliothèque de pilotes de navigateur s'installent en quelques minutes.
Cucumber L'installation peut paraître fastidieuse, mais elle est relativement simple une fois les pièces assemblées dans le bon ordre. Voici la liste des composants à installer pour réaliser le montage. Cucumber .
Prérequis pour l'installation Cucumber on Windows
Cucumber Ce module est distribué en tant que gem Ruby ; par conséquent, rien ne fonctionnera tant que Ruby n'est pas installé. Veuillez vérifier les points suivants avant de télécharger quoi que ce soit :
- Windows 10 ou version ultérieure, 64 bits. RubyInstaller ne recommande plus la version 32 bits, sauf si vous utilisez des DLL natives 32 bits ou des objets COM.
- Droits d'administrateur. Le programme d'installation écrit dans le répertoire Program Files et modifie la variable d'environnement PATH.
- Une connexion internet. Les deux commandes d'installation de gems ci-dessous récupèrent les paquets depuis RubyGems.
- Environ 1 Go d'espace disque libre pour Ruby plus le kit de développement MSYS2, et encore plus si vous ajoutez RubyMine.
- Un navigateur pour automatiser. Watir pilotes Chrome, Edge ou Firefox à travers Selenium, donc au moins un doit être installé.
Deux commandes méritent d'être retenues pour plus tard : ruby -v affiche la version Ruby, et gem -v Affiche la version de RubyGems. En cas d'échec, le PATH n'a pas été mis à jour et il convient de relancer l'installateur plutôt que de procéder au débogage.
Installer Ruby et DevKit
Commencez par le package Ruby+Devkit, qui regroupe la chaîne d'outils de compilation dont les gems avec extensions C ont besoin.
Étape 1) Allez à https://rubyinstaller.org/downloads/ Choisissez ensuite un programme d'installation. La page de téléchargement est affichée ci-dessous.
⚠️ Note de version : L'archive DevKit distincte à laquelle fait référence le guide d'utilisation original a été remplacée par la chaîne d'outils MSYS2, qui Ruby+Devkit RubyInstaller propose des modules d'installation comme composant sélectionnable. Il recommande actuellement la version Ruby+Devkit 4.0.X (x64) aux nouveaux utilisateurs, et le kit sera mis à jour ultérieurement. installation de ridk plutôt que de réexécuter dk.rb. Les étapes ci-dessous restent par ailleurs inchangées.
Étape 2) Ouvrez le fichier téléchargé. Sur le premier écran :
- Accepter la licence
- Cliquez sur le bouton Suivant
Étape 3) Sur l'écran suivant :
- Sélectionnez votre répertoire d'installation
- Sélectionnez toutes les options
- Cliquez sur Installer
Étape 4) Sur l'écran suivant, cliquez sur Suivant.
Étape 5) Attendez que l'installation soit terminée.
Étape 6) Cliquez sur Terminer.
Étape 7) Une fois l'installation terminée, exécutez Ruby depuis le Windows Le menu Démarrer.
Étape 8) Vous verrez une invite de commande Ruby similaire à celle-ci : Windows fenêtre cmd.
Installer Cucumber
Avec Ruby dans le PATH, la gem elle-même se résume à une simple commande.
Étape 1) Tapez gem install cucumber dans l'invite de commandes Ruby. Cette commande télécharge et installe Cucumber directement sur la ligne de commande.
Après quelques secondes, Cucumber La procédure d'installation démarre et signale chaque dépendance qu'elle récupère.
Étape 2) Vérifier si Cucumber installé avec succès, type concombre –versionNotez les deux traits d'union — un seul trait d'union ne constitue pas une option longue valide.
Installer l'EDI RubyMine
Un éditeur n'est pas strictement nécessaire, mais RubyMine comprend Gherkin et peut accéder directement à la définition d'une étape. Suivez les étapes ci-dessous pour l'installer.
Étape 1) Cliquez sur Suivant pour poursuivre l'installation de RubyMine.
Étape 2) Choisissez l'emplacement d'installation.
Étape 3) Définissez les options d'installation.
Étape 4) Choisissez le dossier du menu Démarrer.
Étape 5) Cliquez sur Installer.
Étape 6) Cliquez sur Terminer.
Étape 7) Sélectionnez Ne pas importer les paramètres.
Étape 8) Cliquez sur Évaluer.
Étape 9) Accepter la licence.
Étape 10) Choisissez « Ignorer le reste et définir les valeurs par défaut ».
Étape 11) Ouvrez l'éditeur.
Étape 12) Créez un nouveau projet.
⚠️ Note de version : RubyMine est un logiciel payant. JetBrains produit avec une période d'évaluation limitée, que lance le bouton « Évaluer » à l'étape 8. Une alternative gratuite est disponible. Visual Studio Code avec un rubis et un Cucumber (Extension Gherkin) ; le reste de cette procédure fonctionne de la même manière dans les deux éditeurs.
Installer Watir-WebDriver
Cucumber exécute uniquement les étapes. L'ouverture du navigateur doit être effectuée par un autre processus, et cette tâche incombe à… Watir, un wrapper Ruby autour SeleniumSi vous préférez piloter directement le navigateur, le même projet peut appeler une simple fonction. Script WebDriver.
Étape 1) Cliquez sur Démarrer l'invite de commandes avec Ruby et exécutez la commande d'installation gem installer watir-webdriver.
Étape 2) La gemme watir-webdriver s'installe avec succès.
⚠️ Note de dépréciation : Le module complémentaire watir-webdriver a été intégré au module principal. eau joyau à Watir 6.0, et son propre dépôt ne fait désormais que rediriger les utilisateurs vers le remplacement. Sur une nouvelle machine, exécutez gem install watir En revanche, la commande historique ci-dessus est conservée car elle correspond à ce que montrent les captures d'écran.
Cucumber Structure du dossier du projet
Cucumber La détection des fichiers se fait par convention, et non par configuration ; l’organisation est donc plus importante qu’il n’y paraît. Un projet minimal ressemble à ceci :
| Chemin | Capacité |
|---|---|
| traits/ | Chaque fichier .feature est écrit en Gherkin. Cucumber Recherche effectuée ici par défaut. |
| fonctionnalités/définitions_étapes/ | Les fichiers Ruby dont les blocs correspondent à chaque ligne Given, When et Then. |
| fonctionnalités/assistance/ | Le code de configuration est chargé avant l'exécution de chaque étape, comme par exemple env.rb, qui est l'endroit où le navigateur est généralement ouvert et fermé. |
Deux règles permettent d'éviter bien des confusions par la suite. Cucumber ignore le mot-clé lorsqu'il correspond à une étape, donc Étant donné que j'ai la variable a et J'ai donc la variable a entre en collision avec la même définition. De plus, le texte de l'étape dans le fichier de fonctionnalités doit correspondre exactement à l'expression régulière du fichier d'étape, ponctuation comprise.
Prénom Cucumber scénario
L'exemple ci-dessous multiplie deux nombres, ce qui suffit à prouver que le fichier de fonctionnalités, le fichier STEP et la gem communiquent tous entre eux.
Étape 1) Ouvrez l'éditeur RubyMine depuis Windows Le menu Démarrer.
Le tableau de bord de RubyMine s'affiche comme ci-dessous.
Étape 2) Créez un nouveau projet dans l'éditeur RubyMine.
Donnez un nom et un emplacement au projet, puis confirmez.
Étape 3) Créer un répertoire de fichiers.
Le nouveau répertoire apparaît dans l'arborescence du projet.
Étape 4) Créez et enregistrez un fichier dans votredossier/fonctionnalités/ avec le nom votrenomdefichier.feature.
Vérifiez que le nom du fichier se termine bien par l'extension .feature.
Étape 5) Pour exécuter notre scénario, enregistrez les commandes suivantes dans le fichier de fonctionnalités.
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
Étape 6) Exécutez maintenant le premier fichier de fonctionnalités.
Cliquez sur Démarrer l'invite de commandes avec Ruby et exécutez la commande cucumber depuis le dossier du projet.
La console affiche le résultat ci-dessous.
Étape 7) Créez le fichier de définition d'étape pour le fichier de fonctionnalités.
Créez un nouveau dossier dans l'éditeur RubyMine.
Étape 8) Enregistrez le fichier dans votredossier/fonctionnalités/définitions_étapes avec le nom test_step.rb.
Étape 9) Écrivez le code suivant dans le fichier step.
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
Étape 10) Exécutez à nouveau le fichier de fonctionnalités.
Le résultat est affiché dans la console, et chaque étape est signalée comme réussie.
Commun Cucumber Erreurs d'installation et comment les corriger
La plupart des échecs à ce stade sont dus à l'environnement plutôt qu'à des facteurs intrinsèques. CucumberCe sont ceux qu'il faut reconnaître au premier coup d'œil.
| Message | Causes | Fixer |
|---|---|---|
| « concombre » n'est pas reconnu comme une commande interne ou externe. | Le répertoire bin de Ruby n'est pas dans le PATH, ou vous êtes dans une simple fenêtre cmd. | Ouvrez Démarrer l'invite de commandes avec Ruby, ou réinstallez Ruby en sélectionnant l'option PATH. |
| SSL_connect a renvoyé 1 errno=0 état=erreur : échec de la vérification du certificat | RubyGems ne peut pas valider la chaîne de certificats, généralement située derrière un proxy d'entreprise. | Mettez à jour RubyGems avec la commande gem update --system, ou configurez le proxy avec l'option --http-proxy. |
| ERREUR : Échec de la génération de l'extension native du gem | Le kit de développement MSYS2 est manquant. | Exécutez la commande ridk install et choisissez les options de chaîne d'outils MSYS2 et MINGW. |
| Option invalide : -version | Un seul trait d'union a été utilisé pour l'option longue. | Tapez concombre –version avec deux tirets. |
| Étape non définie, avec un extrait de code suggéré imprimé ci-dessous. | Cucumber Le fichier de fonctionnalités a été trouvé, mais aucune définition correspondante n'a été trouvée. | Collez l'extrait de code suggéré dans un fichier sous features/step_definitions et remplissez le corps du texte. |
| Impossible de charger ce fichier — watir | Le gem installé correspond à une version de Ruby différente de celle utilisée. | Vérifiez la commande `ruby -v` et `gem list watir` dans la même invite de commandes, puis réinstallez la gem à cet endroit. |
Une fois que le scénario de multiplication est validé, l'installation est terminée et le même projet peut devenir une installation complète. tests d'automatisation suite, qu'elle soit utilisée pour test fonctionel ou la nuit les tests de régression.
