Aqua 2024.2 ヘルプ

Aqua IDE の概要

JetBrains Aqua は、テスト自動化のための強力な IDE です。これには、テスト自動化エンジニアが必要とする可能性のあるすべてが含まれています。

  • 最も一般的なテストフレームワークのサポート — Aqua は Selenium(英語)Cypress(英語)Playwright(英語) フレームワークをサポートしており、推奨するツールを使用して自動テストを作成および実行できます。

  • 多言語サポート — Aqua は、Java、Kotlin、Python、JavaScript、TypeScript、SQL を理解し、インテリジェントなコーディング支援を提供する、インテリジェントなコンテキスト認識型 IDE です。

  • スマート IDE — Aqua は IntelliJ プラットフォーム上に構築されているため、一流の IDE に期待されるすべての利点と機能が含まれています。

  • Web インスペクター — 埋め込み Web インスペクターを使用すると、Aqua で Web ページを表示し、自動テストに必要な要素をキャプチャーできます。

IDE 内ですべてがどのように機能するかを確認するには、次のオンボーディングビデオを確認してください。

サポートされる言語

Aqua は JVM 言語用の IDE として設計されていますが、多数のプラグインによって拡張して多言語エクスペリエンスを提供できます。

JVM 言語

Aqua は次の JVM 言語をサポートします。

他の言語

プラグインは、次のような最も人気のある言語のサポートを追加します。

JetBrains マーケットプレイス(英語)を参照して、現在使用されているほぼすべての言語、フレームワーク、テクノロジー、サードパーティのプラグインのサポートを追加する公式プラグインを見つけることができます。プラグインの管理の詳細については、「プラグインのインストール」を参照してください。

ユーザーインターフェース

Aqua IDE のユーザーインターフェースは他の JetBrains 製品のユーザーインターフェースに似ており、ほとんど同じ要素で構成されています。ここでの最大の追加機能は、Web UI テスト自動化で使用される Web インスペクターツールウィンドウです。

Aqua IDE UI

UI 要素の詳細については、「ユーザーインターフェース」を参照してください。

外観のカスタマイズ

Aqua の最も優れた点の 1 つは、その調整可能性です。IDE の外観、ツールウィンドウとツールバーのレイアウト、コードのハイライトなど、事実上すべてを構成できます。また、エディターを微調整し、その動作をカスタマイズしてナビゲーションを高速化し、コードの邪魔になる余分なものを取り除く方法は数多くあります。

すべてのショートカット

Aqua では、エディターとさまざまなツールウィンドウの選択や切り替えなど、ほぼすべてのアクションのショートカットがあります。

最も便利なショートカットを使用するは、エディターからフォーカスを切り替えることなく頻繁なアクションを呼び出し、キーマップを調整して、お気に入りのコマンドにカスタムショートカットを割り当てます。

Aqua は、ソースコードファイル内だけでなく、プロジェクト全体の迅速なナビゲーションを提供します。

覚えておく価値のある最も便利なショートカットの 1 つは、どこでも検索ダイアログを表示する double Shift です。入力を開始すると、Aqua はプロジェクトに属するすべてのファイル、クラス、シンボル、さらには IDE アクションの中から検索文字列を検索します。

Search Everywhere dialog

以下は、最も便利なナビゲーションショートカットの一部です。

アクション

ショートカット

どこでも検索

Double Shift

ファイルに移動

Ctrl+Shift+N

クラスに移動

Ctrl+N

シンボルに移動

Ctrl+Alt+Shift+N

宣言に移動

Ctrl+B

最近使用したファイルと箇所

通常、一度に作業するのはファイルの小さなサブセットであり、すばやく切り替える必要があります。最近使用したファイルアクションは、ここでは時間の節約になります。Ctrl+E を押して、最後にアクセスしたファイルのリストを表示します。このアクションを使用して、任意のツールウィンドウを開くこともできます。

Recent Files popup

最近のファイルに移動するだけでなく、最近使用した箇所(最後に表示または編集したコードスニペット)にすばやくアクセスすることもできます。Ctrl+Shift+E を押すと、最近変更した特定の行に移動できます。

ファイル構造

Ctrl+F12 を押すと、ファイル構造ポップアップが開き、現在のファイルで使用されているすべての要素の概要が表示され、任意の要素に移動できます。

File structure popup

あるいは、構造ツールウィンドウ Alt+7 を使用します。

アクションの検索

使用するアクションのショートカットまたはメニューパスを覚えていない場合は、Ctrl+Shift+A を押してアクション名を入力します。

Find Action popup

コーディング支援

コード補完

Aqua は、状況に応じたコード補完を提供することで、コーディングプロセスの高速化を支援します。

  • 行全体補完では、コンピューターにダウンロードされた ML モデルを使用して、コードの行全体が提案されます。詳細については、行全体コード補完を参照してください。

  • 基本的な補完は、可視性スコープ内のクラス、メソッド、フィールド、キーワードの名前を補完できます。コード補完は、CSS および XPath ロケーター、および Playwright で使用されるロールベースのロケーターでも機能します。

    Code completion for CSS and XPath locators
  • 型一致補完は、Aqua が適切なタイプを決定できる場合に、現在のコンテキストに適用できる最も関連性の高いシンボルを提案します。

Aqua で使用できるさまざまなタイプのコード補完の詳細と例および生産性のヒントについては、「コード補完」を参照してください。

リファクタリング

Aqua は、自動コードリファクタリングの包括的なセットを提供し、生産性を大幅に向上させます。例: クラスの名前を変更すると、IDE はプロジェクト全体でこのクラスへのすべての参照を更新します。

リファクタリングを適用する前に、わざわざ何かを選択する必要さえありません。Aqua は、リファクタリングするステートメントを理解できるほど賢いです。複数の選択肢が可能な場合にのみ確認を求められます。Ctrl+Alt+Shift+T を押して、現在のコンテキストで利用可能なリファクタリングのリストを開きます。

Refactor This popup

利用可能なリファクタリングの完全なリストと使用シナリオ、およびその前後 の例については、コードのリファクタリングセクションを参照してください。

最も有用なリファクタリングのショートカットのいくつかを学びます:

アクション

ショートカット

リファクタリング

Ctrl+Alt+Shift+T

名前変更

Shift+F6

変数の導入

Ctrl+Alt+V

フィールドの導入

Ctrl+Alt+F

定数を抽出する

Ctrl+Alt+C

メソッドを抽出する

Ctrl+Alt+M

パラメーターを抽出する

Ctrl+Alt+P

インライン化

Ctrl+Alt+N

コピー

F5

移動

F6

静的コード分析

Aqua は、組み込みの静的コード分析ツールであるインスペクションのセットを提供します。これらは、潜在的なバグの発見、デッドコードの特定、パフォーマンスの問題の検出、全体的なコード構造の改善に役立ちます。

インスペクションは問題の場所を知らせるだけでなく、すぐに対処できるクイックフィックスも提供します。ハイライトされたコードの横にある赤いバルブをクリックするか、Alt+Enter を押して修正方法を選択します。

Intention action

Aqua は、クイックフィックスとは別に、正しいコードに自動変更を適用するのに役立つインテンションアクションも提供します。例: 言語の挿入、Java アノテーションの追加、JavaDoc の追加、HTML または XML タグの変換などを行うことができます。インテンションアクションの完全なリストを表示するには、設定ダイアログ (Ctrl+Alt+S) でエディター | インテンションに移動します。

Web インスペクター

Web インスペクター機能を使用すると、Aqua で Web ページを開いて、自動テストの開発に必要な重要なページ要素をキャプチャーできます。次に、Aqua は、選択した要素に対して一意の CSS、XPath、ロールベースのロケーターを生成し、それをソースコードに追加できます。

右側のサイドバーにある Web Inspector ボタンをクリックして、Web インスペクターツールウィンドウを開きます。

Web Inspector tool window

Web インスペクターがアクティブな場合、コード補完機能は最も重要な Web ページ要素のロケーターを提案し、ハイライトします。

この機能の詳細については、「Web インスペクター」を参照してください。

HTTP クライアント

Aqua を使用すると、コードエディターで直接 HTTP リクエストを作成、編集、実行できます。Aqua は、コード補完、ハイライト、リファクタリング、その他の機能を含む広範なコーディング支援も提供します。

HTTP Client

HTTP クライアントの詳細については、「HTTP クライアント」を参照してください。

テスト管理システム

Aqua はテスト管理ツールと統合されており、DEV チームと QA チーム間のやり取りがより透明になります。テストスイートとケース階層を参照し、TMS 項目に移動し、選択したテストシナリオの単体テストを生成し、自動化されていないテストケースや廃止されたテストメソッドを検索できます。

Test Management Systems

テスト管理システムの詳細については、「TMS 統合を開始する」を参照してください。

テストデータの生成

Aqua には、名前、メール、日付などのさまざまなタイプのテストデータを生成できるツールがあります。この機能を使用すると、単一のエントリをすばやく挿入したり、CSV、JSON、その他のカスタム形式で大規模なファイルを生成したりできます。

テストデータを生成するには、Alt+Insert を押してカテゴリを選択し、目的のテストデータオプションを選択します。

Generate Test Data

テストデータの生成の詳細については、「テストデータを生成する」を参照してください。

Docker のサポート

Aqua を使用すると、Docker コンテナーにアクセスして、コンテナーの実行とデバッグ、イメージのダウンロードとビルド、マルチコンテナーアプリケーションの実行が可能になります。

Docker integration

詳細は、Docker を参照してください。

データベース管理

Aqua を使用すると、IDE で複数のデータベースを処理し、SQL スクリプトを開発し、低レベルのデータアサーションを実行できます。Aqua は、ライブデータベースへの接続を提供し、クエリを実行し、データをエクスポートし、ビジュアルインターフェースでのスキームの管理をサポートします。これは、Oracle、SQL Server、PostgreSQL、MySQL、その他のデータベースに IDE から直接アクセスできることを意味します。

Database management

詳細は、データベースツールおよび SQL を参照してください。

関連ページ:

プラグインのインストール

プラグインは Aqua のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケットプレイ...

Python

Aqua で Python スクリプトを開発するには:Python をダウンロードしてインストールします。少なくとも 1 つの Python SDK を構成します。Windows ユーザーの場合、Windows 用 Python をインストールすることをお勧めします。サポートされるバージョン:Python 2: バージョン 2.7、Python 3: バージョン 3.6 からバージョン 3.12 まで、次の機能は、Python 3.12 サポートの一部として使用できます。PEP 695 – 型パラメー...

JavaScript のテスト

Aqua を使用すると、Karma、Vitest、Jest、Protractor、Cucumber.js、Mocha、Node.js テストランナーを使用して JavaScript ユニットテストを実行およびデバッグできます。テスト結果はツリービューで確認でき、そこからテストソースに簡単に移動できます。テストのステータスは、エディターのテストの隣に表示され、すぐに実行またはデバッグするオプションがあります。Jest、Karma、Mocha については、Aqua のコードカバレッジレポートを参照す...

TypeScript

Aqua は TypeScript ソースコードの開発、実行、デバッグをサポートします。Aqua は .ts および .tsx ファイルを認識し、ユーザー側で追加の手順を踏むことなく編集するためのコーディング支援を提供します。TypeScript ファイルはアイコン。TypeScript 対応のコーディング支援には、キーワード、ラベル、変数、パラメーター、関数の補完、エラーと構文のハイライト、フォーマット、多数のコードインスペクションとクイックフィックス、および一般的で TypeScript 固有リファクタ...

HTML

Aqua は、構文やエラーのハイライト、コードスタイルに応じたフォーマット、構造検証、コード補完、デバッグセッション中のオンザフライプレビュー(ライブ編集)やコードエディターの専用プレビュータブなど、HTML を強力にサポートします。HTML ツールプラグインを有効にするこの機能は、デフォルトで Aqua にバンドルされて有効になっている HTML ツールプラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択しま...

スタイルシート

Aqua を使用すると、Sass、Less、SCSS、Stylus など、CSS およびそれにコンパイルされるさまざまな言語でスタイル定義を記述できます。スタイルシートのドキュメントの検索、ルールセットの作成と移動、変数の導入などもできます。始める前に:設定で CSS プラグインが有効になっていることを確認します。を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに CSS と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。コード補完...