Maven よく使うコマンド
Maven コマンドは以下のパターンに従います:
mvn [选项] [生命周期阶段] [目标]
Maven のバージョンを確認する
例
このコマンドは、インストールされている Maven バージョン、Java バージョンなどの情報を表示します。
Maven ライフサイクルコマンド
Maven はビルドライフサイクルの概念に基づいており、3つの主要なライフサイクルがあります:
- clean:プロジェクトをクリーンアップする
- default (build):プロジェクトを構築する
- site:プロジェクトドキュメントを生成する
プロジェクトのクリーン
例
このコマンドはtargetディレクトリを削除します。つまり、ビルドで生成されたすべてのファイルを削除します。
プロジェクトのコンパイル
例
ソースコードをコンパイルし、コンパイル後の class ファイルはtarget/classesディレクトリに配置されます。
テストの実行
例
プロジェクト内のすべてのテストケースを実行します。
プロジェクトのパッケージ化
例
POM ファイルで指定されたパッケージタイプ(jar、war など)に従ってプロジェクトをパッケージ化します。
ローカルリポジトリへのインストール
例
プロジェクトをビルドしてローカル Maven リポジトリにインストールし、他のプロジェクトが依存関係として使用できるようにします。
リモートリポジトリへのデプロイ
例
最終的なプロジェクトパッケージをリモートリポジトリにコピーし、他の開発者やプロジェクトが使用できるようにします。
依存関係管理コマンド
プロジェクトの依存関係ツリーを表示
例
プロジェクトの依存関係ツリーを表示し、依存関係の分析や依存関係の競合解決に役立ちます。
ソースコードのダウンロード
例
プロジェクトが依存するソースコードをダウンロードします。
依存関係の分析
例
プロジェクトで使用されているが宣言されていない依存関係と、宣言されているが使用されていない依存関係を分析します。
プロジェクト作成コマンド
シンプルなプロジェクトの作成
例
Maven アーキタイプシステムを使用して、シンプルな Java プロジェクトを作成します。
Web プロジェクトの作成
例
シンプルな Web アプリケーションプロジェクトを作成します。
その他の便利なコマンド
テストのスキップ
例
プロジェクトをビルドしてローカルリポジトリにインストールしますが、テストフェーズはスキップします。
特定のテストを実行
例
指定されたテストクラスのみを実行します。
例
指定されたテストクラス内の特定のテストメソッドのみを実行します。
依存関係の更新
例
プロジェクト内のどの依存関係に利用可能な更新バージョンがあるかを確認します。
サイトドキュメントの生成
例
さまざまなレポートを含むプロジェクトのサイトドキュメントを生成します。
特定のフェーズを実行
例
最初に clean ライフサイクルを実行し、次に default ライフサイクルを package フェーズまで実行します。
Maven コマンドの組み合わせ使用
Maven コマンドは効率を上げるために組み合わせて使用できます:
例
まずプロジェクトをクリーンアップし、次にコンパイル、テスト、ローカルリポジトリへのインストールを実行します。
例
プロジェクトをクリーンアップし、テストを実行せずにパッケージ化します。
よくある問題の解決
スナップショット依存関係を強制更新
例
-Uパラメータは Maven にリモートリポジトリ内の依存関係の更新バージョンを強制的に確認させます。
オフラインモード
例
-oパラメータは Maven をオフラインモードで実行させ、ローカルリポジトリ内の依存関係のみを使用します。
デバッグモード
例
-Xパラメータはデバッグ出力を有効にし、詳細な実行情報を表示します。
基本的なビルドコマンド
| コマンド | 機能 | 実行されるライフサイクルフェーズ |
|---|---|---|
mvn clean | 削除target/ディレクトリ | clean |
mvn validate | プロジェクトが正しいか検証する | validate |
mvn compile | メインのソースコードをコンパイルする | compile |
mvn test-compile | テストコードをコンパイルする | test-compile |
mvn test | ユニットテストを実行する | test |
mvn package | プロジェクトをパッケージ化する | package |
mvn verify | 統合テストを実行する | verify |
mvn install | ローカルリポジトリにインストールする | install |
mvn deploy | リモートリポジトリにデプロイする | deploy |
典型的な開発フロー:
mvn clean compile test package
依存関係管理コマンド
| コマンド | 機能 |
|---|---|
mvn dependency:tree | 依存関係ツリーを表示 |
mvn dependency:analyze | 依存関係の問題を分析 |
mvn dependency:copy-dependencies | 依存関係をディレクトリにコピー |
mvn dependency:purge-local-repository | ローカル依存関係キャッシュをクリア |
mvn versions:display-dependency-updates | 依存関係の更新を確認 |
# 查看依赖树 mvn dependency:tree # 检查可用更新 mvn versions:display-dependency-updates
プラグイン関連コマンド
| コマンド | 機能 |
|---|---|
mvn help:describe -Dplugin=插件名 | プラグイン情報を表示 |
mvn help:effective-pom | 最終的に有効な POM を表示 |
mvn 插件前缀:目标 | プラグインターゲットを直接実行 |
# 查看compiler插件信息 mvn help:describe -Dplugin=compiler # 直接运行compiler插件的compile目标 mvn compiler:compile
テスト関連コマンド
| コマンド | 機能 |
|---|---|
mvn test | すべてのテストを実行 |
mvn -Dtest=测试类名 test | 指定されたテストクラスを実行 |
mvn -Dtest=测试类名#方法名 test | 指定されたテストメソッドを実行 |
mvn -DskipTests=true package | テストをスキップ |
# 只运行UserServiceTest类 mvn -Dtest=UserServiceTest test # 只运行UserServiceTest中的testCreate方法 mvn -Dtest=UserServiceTest#testCreate test
マルチモジュールプロジェクトのコマンド
| コマンド | 機能 |
|---|---|
mvn -pl 模块名 命令 | 指定されたモジュールに対してコマンドを実行 |
mvn -am -pl 模块名 命令 | コマンドを実行し、依存モジュールを処理 |
mvn -rf 模块名 命令 | 指定されたモジュールから実行を継続 |
# 只编译service模块 mvn -pl service compile # 编译web模块及其依赖的模块 mvn -am -pl web compile
高度な使い方
| コマンド | 機能 |
|---|---|
mvn -T 4 install | 4つのスレッドを使用して並列ビルド |
mvn -o package | オフラインモードで実行 |
mvn -X clean install | デバッグ出力を有効にする |
mvn -U clean install | snapshot 依存関係を強制更新 |
mvn release:prepare | プロジェクトのリリース準備 |
mvn release:perform | プロジェクトのリリース実行 |
# 并行构建(4线程) mvn -T 4 clean install # 强制更新snapshot依赖 mvn -U clean install
よく使うコマンドの組み合わせ
| 組み合わせコマンド | 機能 |
|---|---|
mvn clean install | クリーンアップ後に再インストール |
mvn clean package -DskipTests | クリーンアップ後にテストをスキップしてパッケージ化 |
mvn clean test | クリーンアップ後にテストを実行 |
mvn clean deploy | クリーンアップ後にデプロイ |
実用的なテクニック
プロジェクト情報をすばやく表示:
mvn help:effective-pom mvn help:describe -Dcmd=compile
ビルド問題のデバッグ:
mvn -X clean install
チェックをスキップ:
mvn install -Dcheckstyle.skip=true -Dpmd.skip=true
プロファイルを指定:
mvn install -P production
ビルド時間を表示:
mvn install --batch-mode | grep "Total time"その他の拡張