CUCUMBER をダウンロードしてインストールする方法 Windows

⚡ スマートサマリー

Cucumber にインストール Windows 必要な部品は 4 つです: 開発キット付きの Ruby、 Cucumber gem本体、RubyMineのようなエディタ、そしてブラウザドライバライブラリ。どれも数分でインストールできます。

  • 🔘 まずルビーから: Cucumber これはRuby gemなので、他の何よりも先にRubyInstallerのRuby+Devkitインストーラーをインストールしておく必要があります。
  • ☑️ 1つのコマンド: `gem install cucumber` コマンドは、コマンドラインから RubyGems から直接 gem とその依存関係を取得します。
  • すぐに確認してください: cucumber –versionを実行すると、gemが解決され、実行ファイルがシステムPATHに存在することが確認できます。
  • 🧪 エディターはオプションです。 RubyMineは構文ハイライトとステップナビゲーションを提供しますが、プレーンテキストを保存するエディタであればどれでもフィーチャーファイルを実行します。
  • 🛠️ ブラウザドライバ: Watir ラップ Selenium そしてブラウザを駆動します。現在のgem名はwatirであり、廃止されたwatir-webdriverではありません。
  • 📊 固定レイアウト: フィーチャーファイルは features の下に、ステップ定義は features/step_definitions の下にあります。 Cucumber ステップに一致しません。

ダウンロードしてインストール Cucumber on Windows Ruby、RubyMine、 Watir

Cucumber インストールは面倒に見えるかもしれませんが、正しい順序で部品を取り出せば比較的簡単です。以下は、インストールする必要のあるコンポーネントのロードマップです。 Cucumber 作業。

インストールの前提条件 Cucumber on Windows

Cucumber これはRuby gemとして配布されているため、Rubyがインストールされていないと何も動作しません。ダウンロードする前に、以下の点を確認してください。

  • Windows Windows 10以降、64ビット版。 RubyInstallerは、32ビットネイティブDLLまたはCOMオブジェクトに依存している場合を除き、32ビットビルドを推奨しなくなりました。
  • 管理者権限。 インストーラーはProgram Filesに書き込みを行い、PATH環境変数を編集します。
  • インターネット接続。 以下の2つのgem installコマンドはどちらもRubyGemsからパッケージを取得します。
  • 約1GBの空きディスク容量 RubyとMSYS2開発キットが必要で、さらにRubyMineを追加すればさらに多くのものが必要になります。
  • 自動化のためのブラウザ。 Watir Chrome、Edge、または Firefox   Seleniumそのため、少なくとも1つはインストールする必要があります。

後々のために覚えておくと良いコマンドが2つあります。 ルビー -v Ruby版を出力し、 gem -v RubyGemsのバージョンを表示します。どちらかが失敗した場合は、PATHが更新されていないため、デバッグするのではなくインストーラーを再度実行してください。

Ruby と DevKit をインストールする

まずは、C拡張機能を持つgemに必要なコンパイラツールチェーンを同梱したRuby+Devkitパッケージから始めましょう。

ステップ 1) に移動します https://rubyinstaller.org/downloads/ インストーラーを選択してください。ダウンロードページは以下に表示されています。

RubyInstallerのダウンロードページには、RubyおよびRuby+Devkitインストーラーの一覧が表示されます。

⚠️ バージョンノート: 元のウォークスルーで参照されている別の DevKit アーカイブは、MSYS2 ツールチェーンに置き換えられました。 Ruby+開発キット インストーラーは選択可能なコンポーネントとしてバンドルします。RubyInstaller は現在、新規ユーザーには Ruby+Devkit 4.0.X (x64) ビルドを推奨しており、キットは後ほど更新されます。 ridkのインストール dk.rbを再実行するのではなく、以下の手順は変更ありません。

ステップ2)ダウンロードしたファイルを開きます。最初の画面で:

  1. ライセンスを受け入れる
  2. Nextボタンをクリックしてください。

Rubyインストーラーのライセンス契約画面(次へボタン付き)

ステップ3)次の画面で:

  1. インストールディレクトリを選択してください
  2. すべてのオプションを選択
  3. インストールをクリックします。

Rubyのインストールディレクトリを選択し、インストーラーのすべてのオプションを選択します。

ステップ4)次の画面で「次へ」をクリックします。

コピー開始前のRubyインストーラーコンポーネント選択画面

ステップ5)インストールが完了するまで待ちます。

ファイルがディスクにコピーされている間のRubyのインストール進行状況

ステップ6)「完了」をクリックします。

完了ボタンが表示されたRubyインストーラーの最終画面

ステップ 7) インストールが完了したら、Ruby を実行します。 Windows スタートメニュー。

Windows スタートメニューのエントリから、Ruby のコマンドプロンプトを開く

ステップ 8) 次のような Ruby コマンド プロンプトが表示されます。 Windows コマンドウィンドウ。

gemコマンドを受け付ける準備ができたRubyコマンドプロンプトウィンドウ

インストールを開始する Cucumber

RubyがPATH環境変数に設定されていれば、gem自体は単一のコマンドで実行できます。

ステップ1)タイプする gem install cucumber Ruby コマンドプロンプトで、このコマンドはダウンロードしてインストールします。 Cucumber コマンドライン自体で。

「gem install cucumber」とRubyコマンドプロンプトに入力する。

数秒後 Cucumber インストール手順が開始され、取得した各依存関係が報告されます。

Cucumber gemのインストール時にインストールされる依存関係の一覧が出力される。

ステップ2) Cucumber インストールに成功しました。 キュウリ –バージョンハイフンが2つあることに注意してください。ハイフン1つでは有効なロングオプションになりません。

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.

Rubyコマンドプロンプトで`gem install watir-webdriver`を実行する

ステップ2)watir-webdriver gemが正常にインストールされます。

コンソール出力で、watir-webdriver gemがインストールされたことが確認できます。

⚠️ 非推奨に関する注記: watir-webdriver gem はメインに統合されました ワティル 宝石 Watir 6.0 では、独自のレポジトリは代替バージョンへの参照のみをユーザーに提供するようになりました。新しいマシンで実行すると、 gem install watir 代わりに、上記の従来のコマンドを残しておきます。これはスクリーンショットに示されている内容だからです。

Cucumber プロジェクトフォルダ構造

Cucumber は設定ではなく慣例に基づいてファイルを検出するため、レイアウトは見た目以上に重要です。最小限のプロジェクトは次のようになります。

パス 保持しています
特徴/ すべての.featureファイルはGherkinで記述されています。 Cucumber デフォルトではここで検索します。
機能/ステップ定義/ 各 Given、When、Then 行に一致するブロックを持つ Ruby ファイル。
機能/サポート/ セットアップコードは、env.rbなどのどのステップが実行される前にも読み込まれます。通常、ブラウザの開閉はこのenv.rbで行われます。

2つのルールを守ることで、後々の混乱を大幅に回避できます。 Cucumber ステップに一致する場合はキーワードを無視します。 変数aがあると仮定して (NAIST) と 次に変数aがあります 同じ定義と競合しないようにする必要があります。また、フィーチャーファイル内のステップテキストは、句読点を含め、ステップファイル内の正規表現と完全に一致する必要があります。

最初 Cucumber スクリプト

以下の例では2つの数値を乗算していますが、これはフィーチャーファイル、ステップファイル、およびgemが互いに通信していることを証明するのに十分です。

ステップ 1) RubyMine エディタを以下の場所から開きます。 Windows スタートメニュー。

RubyMineを開く Windows [スタート]メニュー

RubyMineのダッシュボードは以下のように表示されます。

エディタを開いた後に表示されるRubyMineダッシュボード

ステップ2)RubyMineエディタで新しいプロジェクトを作成します。

RubyMineダッシュボードから新しいプロジェクトを開始する

プロジェクト名と場所を入力し、確認してください。

新規プロジェクトダイアログにプロジェクト名と場所を入力する

ステップ3)ファイルディレクトリを作成します。

RubyMineプロジェクト内に新しいディレクトリを作成する

新しいディレクトリがプロジェクトツリーに表示されます。

新しく作成されたフィーチャーディレクトリを示すプロジェクトツリー

ステップ4)ファイルを作成して保存します あなたのフォルダ/機能/ 名前で あなたのファイル名.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_definitions 名前で 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)次に、フィーチャーファイルを再度実行します。

ステップが定義された後にフィーチャーファイルを2回実行する

結果はコンソールに表示され、各ステップは合格として報告されます。

Cucumber 定義済みのステップでフィーチャーファイルを実行した後のコンソール出力

コマンドと Cucumber インストールエラーとその解決方法

この段階での失敗のほとんどは、環境が原因であり、 Cucumberこれらは、一目見ただけで見分けられる価値のあるものです。

メッセージ 原因となる 修正する
「cucumber」は内部コマンドまたは外部コマンドとして認識されません RubyのbinディレクトリがPATH環境変数に設定されていないか、または通常のコマンドプロンプトウィンドウを使用しています。 店は開いています コマンドプロンプトをRubyで起動するまたは、PATHオプションを選択してRubyを再インストールしてください。
SSL_connect が 1 を返しました errno=0 state=error: 証明書の検証に失敗しました RubyGemsは、通常企業プロキシの背後にある証明書チェーンを検証できません。 `gem update –system` コマンドで RubyGems を更新するか、`–http-proxy` スイッチを使用してプロキシを設定してください。
エラー: gemネイティブ拡張機能のビルドに失敗しました MSYS2開発キットが不足しています。 ridk installを実行し、MSYS2およびMINGWツールチェーンのオプションを選択してください。
無効なオプション: -version 長いオプションにはハイフン1つが使用されました。 キュウリ –version と入力してください(ハイフン2つ)。
未定義のステップ。その下に推奨されるコードスニペットが表示されます。 Cucumber フィーチャーファイルは見つかりましたが、一致する定義が見つかりませんでした。 提案されたコードスニペットをfeatures/step_definitionsディレクトリ内のファイルに貼り付け、本文を記入してください。
このようなファイルは読み込めません — watir インストールされているgemは、現在実行中のRubyのバージョンとは異なるバージョンに対応しています。 同じプロンプトで `ruby -v` と `gem list watir` を実行して確認し、その後、そこで gem を再インストールしてください。

乗算シナリオが合格と報告されると、インストールは完了し、同じプロジェクトを完全なものに拡張できます。 自動化テスト スイート、それが何に使用されるか 機能テスト または毎晩 回帰試験.

よくあるご質問

いいえ。 Cucumber-JVM カバー Java、KotlinとScala、 Cucumber.js カバー Javaスクリプトや、他のいくつかの言語への移植版も存在します。ここで説明するRuby版はオリジナルの実装であり、Gherkinの構文はどのバージョンでも同一です。

フィーチャーファイルはプレーンテキストなので、どのエディタでも動作します。RubyMineはGherkinのオートコンプリートと定義へのジャンプ機能を追加しますが、 Visual Studio Code Ruby拡張機能と Cucumber 拡大。

はい、複数の人が実行するスイートであればどれでもそうです。Cucumberのバージョンを明示的に指定したGemfileとコミット済みのGemfile.lockがあれば、すべてのマシンとすべてのCIエージェントが同じgemを解決するため、「自分のマシンでは動作する」といった種類の失敗が解消されます。

全然。 Watir 便利な包装です Seleniumそのため、ステップ定義内でselenium-webdriver gemを直接読み込むことができます。 Watir これは単に、Rubyプロジェクトにおける要素構文を短縮するものです。

Cucumber 既に未定義のステップごとにスニペットが出力されていますが、AIアシスタントは周囲のページオブジェクトから本文を補完することで、その機能を拡張します。生成されたセレクターは誤っていることが多いため、出力はあくまでも下書きとして扱ってください。

はい、その通りです。CopilotはFeature、Scenario、Given、When、Thenを認識し、同じスタイルのシナリオをさらに提案します。ただし、既存のシナリオの繰り返しではなく、真にカバレッジを追加するシナリオを判断する能力は最も劣ります。

同一ブランチ内でのパッチアップグレード(例:3.4.0から3.4.3)では、同じディレクトリを再利用し、既存のgemを保持できます。しかし、安定版ブランチ間での移動には、C拡張機能を持つgemは互換性がないため、新しいターゲットディレクトリが必要です。

以下の3つがほとんどのニーズに対応します。–dry-runは、何も実行せずにすべてのステップに定義があるかどうかを確認します。–tagsは、ラベル付けされたシナリオのサブセットを実行します。–formatは、レポーターを設定します。たとえば、ローカルでは見やすい出力、ビルドサーバーではJSONまたはHTMLなどです。