Mavenでローカルjarをインストールする
1問題とその選択肢
Mavenは非常に用途の広いツールであり、その利用可能な公開リポジトリは他に類を見ません。ただし、
どこにもホストされていない
、またはそれがホストされているリポジトリに依存するのは危険です。
それが起こるとき、いくつかの選択肢があります。
-
弾丸を噛んで本格的な** リポジトリ管理をインストール
ソリューションhttp://www.sonatype.org/nexus/[Nexusなど]** アーティファクトをより評判の良い人にアップロードしてみてください
リポジトリ
Mavenプラグインを使用して
アーティファクトを
ローカルに
インストールする
-
Nexus
はもちろんより成熟したソリューションですが、
より複雑な** もあります。 Nexusを実行するためのインスタンスのプロビジョニング、Nexus自体のセットアップ、設定および保守は、単一のjarファイルを使用するなどの単純な問題ではやり過ぎるかもしれません。このシナリオ(カスタム成果物のホスティング)が一般的なシナリオである場合は、リポジトリー・マネージャーが非常に役立ちます。
アーティファクトを
公開リポジトリ
またはMaven Centralに直接アップロードすることも良い解決策ですが、通常http://maven.apache.org/guides/mini/guide-central-repository-upload.html[a]。さらに、ライブラリはMaven対応ではないため、プロセスがはるかに困難になるため、今すぐアーティファクトを使用できるようにするための現実的なソリューションではありません。
この場合、ソース管理にアーティファクトを追加し、Mavenプラグインを使用するという3番目の選択肢は残ります。ビルドプロセスで必要になる前にローカルにインストールしてください。これは、最も簡単で信頼性の高い方法です。
2
maven-install-plugin
を使ってローカルjarをインストールする
アーティファクトをローカルリポジトリにインストールするのに必要な完全な設定から始めましょう。
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-install-plugin</artifactId>
<version>2.5.1</version>
<configuration>
<groupId>org.somegroup</groupId>
<artifactId>someartifact</artifactId>
<version>1.0</version>
<packaging>jar</packaging>
<file>${basedir}/dependencies/someartifact-1.0.jar</file>
<generatePom>true</generatePom>
</configuration>
<executions>
<execution>
<id>install-jar-lib</id>
<goals>
<goal>install-file</goal>
</goals>
<phase>validate</phase>
</execution>
</executions>
</plugin>
それでは、この構成の詳細を分析して分析しましょう。
2.1. アーティファクト情報
案件情報は、
<configuration>
要素の一部として定義されます。実際の構文は、依存関係の宣言(
groupId
、
artifactId
、および
version
要素)と非常によく似ています。
設定の次の部分では、アーティファクトの
packaging
を定義する必要があります – これは
jar
として指定されています。
次に、インストールする実際のjarファイルの
location
を指定する必要があります。これは絶対ファイルパスでも相対パスでもかまいません。
https://cwiki.apache.org/confluence/display/MAVENを使用してください。/MavenプロパティガイドMaven
で利用可能な[プロパティ]。この場合、
$ \ {basedir}
プロパティはプロジェクトのルート、つまり
pom.xml
ファイルが存在する場所を表します。つまり、
someartifact-1.0.jar
ファイルは、ルートの下の
/dependencies/
ディレクトリに配置する必要があります。
最後に、他にも設定可能なhttp://maven.apache.org/plugins/maven-install-plugin/install-file-mojo.html[オプションの詳細]がいくつかあります。
2.2. 実行
-
install-file
goal
の実行は、標準のMaven
build lifecycle
の
validate
phase ** にバインドされています。そのため、コンパイルを試みる前に – 検証フェーズを明示的に実行する必要があります。
mvn validate
このステップの後、標準のコンパイルはうまくいきます。
mvn clean install
コンパイルフェーズが実行されると、Maven Centralから取得された他のアーティファクトと同様に、
someartifact-1.0.jar
がローカルリポジトリに正しくインストールされます。
2.3.
pom
を生成することと
pom
を供給すること
成果物に
pom.xml
ファイルを提供する必要があるかどうかは、主に成果物自体の
ランタイム依存関係
によって異なります。簡単に言うと、アーティファクトが他のjarファイルに実行時依存関係を持っている場合、これらのjarファイルは実行時にもクラスパス上に存在する必要があります。実行時に依存関係がない可能性が高いため、問題にならない単純な成果物を使用します(依存関係グラフのリーフ)。
install-file
の目標の
generatePom
オプションは、これらの種類の成果物で十分なはずです。
<generatePom>true</generatePom>
しかし、成果物がより複雑で、重要な
依存関係
を持っている場合は、これらの依存関係がまだクラスパスに存在しない場合は、それらを追加する必要があります。そのための1つの方法は、これらの新しい依存関係をプロジェクトのpomファイルに手動で定義することです。より良い解決策は、インストールされた成果物と一緒にカスタム
pom.xml
ファイルを提供することです。
<generatePom>false</generatePom>
<pomFile>${basedir}/dependencies/someartifact-1.0.pom</pomFile>
これにより、Mavenは、このカスタム
pom.xml
で定義されたアーティファクトのすべての依存関係を、プロジェクトのメインpomファイルで手動で定義しなくても解決できるようになります。
3結論
この記事では、Mavenプロジェクト内のどこにもホストされていないjarファイルを
maven-install-plugin
を使用してローカルにインストールする方法について説明します。