Maven スナップショット(SNAPSHOT)

大規模なソフトウェアアプリケーションは通常、複数のモジュールを含み、複数のチームが同じアプリケーションの異なるモジュールを開発するのが一般的なシナリオです。例として、あるチームがアプリケーションのフロントエンドを開発しているとします。プロジェクトは app-ui(app-ui.jar:1.0)です。一方、別のチームがバックエンドを開発しており、使用するプロジェクトは data-service(data-service.jar:1.0)です。

現在、data-service を開発するチームが迅速なバグ修正やプロジェクト改善を行っており、ほぼ1日おきにライブラリをリモートリポジトリに公開している状況が考えられます。data-service チームが1日おきに新しいバージョンをアップロードすると、次のような問題が発生します。

  • data-service チームは更新されたコードを公開するたびに app-ui チームに知らせなければなりません。
  • app-ui チームは pom.xml ファイルを頻繁に最新バージョンに更新する必要があります。

この状況を解決するために、スナップショットの概念が役に立ちます。


スナップショットとは?

スナップショットは特別なバージョンであり、ある現在の開発進捗のコピーを指定します。通常のバージョンとは異なり、Maven はビルドのたびにリモートリポジトリで新しいスナップショットをチェックします。data-service チームは更新されたコードのスナップショットをリポジトリに公開します。たとえば、data-service:1.0-SNAPSHOT を公開して、古いスナップショットの jar パッケージを置き換えます。


プロジェクトのスナップショット vs バージョン

バージョンの場合、Maven が以前に指定されたバージョンのファイル(たとえば data-service:1.0)をダウンロードしたことがあれば、Maven は新しい利用可能な 1.0 ファイルをリポジトリから再びダウンロードしません。更新されたコードをダウンロードするには、data-service のバージョンを 1.1 に上げる必要があります。

スナップショットの場合、app-ui チームがプロジェクトをビルドするたびに、Maven は自動的に最新のスナップショット(data-service:1.0-SNAPSHOT)を取得します。

app-ui プロジェクトの pom.xml ファイル

app-ui プロジェクトは data-service プロジェクトの 1.0 スナップショットを使用しています。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>app-ui</groupId> <artifactId>app-ui</artifactId> <version>1.0</version> <packaging>jar</packaging> <name>health</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <dependency> <groupId>data-service</groupId> <artifactId>data-service</artifactId> <version>1.0-SNAPSHOT</version> <scope>test</scope> </dependency> </dependencies> </project>

data-service プロジェクトの pom.xml ファイル

data-service プロジェクトは小さな変更のたびに 1.0 スナップショットを公開します。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>data-service</groupId> <artifactId>data-service</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>health</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> </project>

スナップショットの場合、Maven は通常の作業で自動的に最新のスナップショットを取得しますが、任意の maven コマンドで -U パラメータを使用して、Maven に最新のスナップショットビルドを強制的にダウンロードさせることもできます。

mvn clean package -U

コマンドコンソールを開き、C:\ > MVN > app-ui ディレクトリに移動して、次の mvn コマンドを実行しましょう。

C:\MVN\app-ui>mvn clean package -U

Maven は data-service の最新スナップショットをダウンロードした後、プロジェクトの構築を開始します。

[INFO] Scanning for projects...
[INFO] -------------------------------------------------------------------
[INFO] Building consumerBanking
[INFO]    task-segment: [clean, package]
[INFO] -------------------------------------------------------------------
[INFO] Downloading data-service:1.0-SNAPSHOT
[INFO] 290K downloaded.
[INFO] [clean:clean {execution: default-clean}]
[INFO] Deleting directory C:\MVN\app-ui\target
[INFO] [resources:resources {execution: default-resources}]
[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources,
i.e. build is platform dependent!
[INFO] skip non existing resourceDirectory C:\MVN\app-ui\src\main\
resources
[INFO] [compiler:compile {execution: default-compile}]
[INFO] Compiling 1 source file to C:\MVN\app-ui\target\classes
[INFO] [resources:testResources {execution: default-testResources}]
[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources,
i.e. build is platform dependent!
[INFO] skip non existing resourceDirectory C:\MVN\app-ui\src\test\
resources
[INFO] [compiler:testCompile {execution: default-testCompile}]
[INFO] Compiling 1 source file to C:\MVN\app-ui\target\test-classes
[INFO] [surefire:test {execution: default-test}]
[INFO] Surefire report directory: C:\MVN\app-ui\target\
surefire-reports
-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running com.companyname.bank.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.027 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] [jar:jar {execution: default-jar}]
[INFO] Building jar: C:\MVN\app-ui\target\
app-ui-1.0-SNAPSHOT.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2 seconds
[INFO] Finished at: Tue Jul 10 16:52:18 IST 2012
[INFO] Final Memory: 16M/89M
[INFO] ------------------------------------------------------------------------
その他の拡張