Maven基礎

1. Maven基礎 2013/9/30 株式会社アークシステム瀧口季男

2. Mavenって？ Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information. http://maven.apache.org 上に書いてある通り、ソフトウェアプロジェクトの管理＆支援ツールです。

3. Javaでコンパイル～どうやるんだっけ？～

4. javacって、ありましたよね？コンパイル？ javac -cp lib/foo.jar;lib/baa.jar;lib/poo.jar -source 1.5 -target 1.5 -d classes src/com/example/foo/*.java src/com/example/baa/*.java JAR？ jar cvf hoge.jar -C classes/ . 実行？ java –cp classes;lib/foo.jar;lib/baa.jar;lib/poo.jar com.example.foo.Main arg… 私には無理です。本当にありがとうございました。

5. Ant ～それは革命～

6. さよならシェルスクリプト build.xmlを書いておけば、ant compile でコンパイルできる！ <project name="hoge" default="jar" basedir="."> <target name="compile"> <javac destdir="bin" encoding="UTF-8"> <src path="src" /> <classpath> <fileset dir="lib"> <include name="**/*.jar" /> </fileset> </classpath> </javac> </target> <target name="jar" depends="compile"> <jar jarfile="dist/hoge.jar" basedir="bin"></jar> </target> </project>

7. Antがあってよかったなって Write once, build anywhere! ビルドに必要なソース、依存JAR、 build.xmlとAntが一式あれば、WindowsでもLinuxでもビルドできる！

8. パーキンソンの法則仕事は、その遂行のために利用できる時間をすべて埋めるように拡大する

9. Antあるあるオレオレbuild.xml 「私のプロジェクトでは、モジュール名をソースディレクトリ名とするｷﾘｯ」依存JARが増えると・・・いちいちサイト巡ってダウンロードするのめんどくせ (‘A`) SCMにJARを全部コミットしたらサーバーのHDD が・・・あれ、デジャビュ？このAnt task、夢の中で書いた、ような・・・いちいちbuild.xml書くのめんどくせ (‘A`)

10. ヒックの法則意思決定にかかる時間は、可能な選択肢の数に依存する

11. じゃ、決めちゃおうぜプロジェクトのディレクトリ構成決めても従わない奴ばかりだとしても、もし最初からディレクトリ構成を作ってくれるとしたら？依存jarの解決あちこち探してダウンロードするんじゃなくて、 1箇所に集まってたら？さらに、自動でダウンロードしてくれるとしたら？ビルドの流れコンパイルして、テストして、ZIPで固めて・・

12. __ __ | ¥/ |__ _Apache__ ___ | |¥/| / _` ¥ V / -_) ' ¥ ~ intelligent projects ~ |_| |_¥__,_|¥_/¥___|_||_| v. 1.0.2 ～ビルドツールのその先へ～

13. ディレクトリ構成決めましたこれで行くから。 [basedir] ├ pom.xml ├ src │ ├ main │ │ ├ java │ │ └ resources │ └ test │ ├ java │ └ resources └ target ├ classes └ test-classes src/main/webapp、src/siteなどもある maven 1.0 の頃は、mainとtestが分かれてなかった。時代の流れを感じるところ。 http://maven.apache.org/guides/introduction/introductio n-to-the-standard-directory-layout.html

14. JARのリポジトリ作りましたセントラルリポジトリにたくさんのJARを集めて公開するよ個々のJARを識別する仕組みも考えたよ groupId、artifactId、versionで特定するよ依存するJARを設定ファイルに書いて明確化できるよビルド時に自動で依存を解決するよリポジトリからJARをダウンロードするよダウンロードしたJARがSCM管理下に入らないように、こっそり別の場所に保存しておくよ http://maven.apache.org/guides/introduction/introductio n-to-repositories.html

15. ビルドの流れを決めました Clean Site validate pre-clean pre-site compile Build Lifecycle Default clean site test post-clean post-site package integration -test verify install deploy site-deploy Mavenには3種類のライフサイクルがある Defaultライフサイクルは、実際もっと細かいフェーズに分かれている（全部で23個！） http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#Lifecycle_Reference

16. ここまでのまとめ javacからAnt ビルドの定型化、環境非依存化開発が大規模化するにつれ、冗長なところが多くなった AntからMaven ビルドの普遍化、環境の統一化

17. Mavenがうごくしくみ～Goal & Lifecycle～

18. Maven本体とゴール Maven本体の機能 POM（後述）の解析ライフサイクルの各フェーズに結びついたゴールの実行ゴールビルドの個々のタスク。コンパイル、JAR 作成、ファイルのコピーなどなど。ゴールは全てプラグインが提供する

19. Goalの実行個々のプラグイン名：ゴール名で、1 個のゴールを実行する compiler :compile > mvn compile Maven dependency resolve copy list compiler compile testCompile surefire test jar jar test-jar pluginたち

20. Phaseの実行ライフサイクル中の指定したPhaseまで、各Phaseに紐付いたゴールを実行する各Phaseに結びつ resolve いたGoalを実行 > mvn test dependency Maven validate compile test validate copy list compiler compile testCompile surefire test compile test package ・・・ jar jar test-jar

21. 実行の仕方 mvn [options] [<goal(s)>] [<phase(s)>] Goal Mavenに実行させたいタスクの指定 [プラグイン名]:[ゴール名]で指定する mvn compiler:compile mvn jar:jar Phase ビルドライフサイクルをどのフェーズまで実行するか、という指定各フェーズには、複数のゴールが結びついている

22. Mavenの設定～POM～

23. POM “Project Object Model” プロジェクト情報をXMLで記述する <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>com.example</groupId> <artifactId>hoge-project</artifactId> <version>1.0.0</version>  </project> いくつか紹介しますが、詳しくはWeb で！ http://maven.apache.org/pom.xml

24. dependencies プロジェクト依存ライブラリの設定 <dependencies> <dependency> <groupId>com.example</groupId> <artifactId>hoge</artifactId> <version>1.0.0</version> <scope>compile</scope> </dependency> <dependency>…</dependency> </dependencies> groupId, artifactId, version JARを一意に特定するキー scope いつ必要なのかを指定する compile (デフォルト) provided runtime test system ローカルに無ければ、自動でリポジトリからダウンロードされる Mavenのセントラルリポジトリ以外のリポジトリは repositories に設定する必要あり

25. build ビルドに関する設定（プラグイン等） <build> <defaultGoal>validate</defaultGoal> <resources> <resource>…</resource> </resources> <plugins> <plugin>…</plugin> </plugins> </build> defaultGoal goal/phase指定が無い場合に実行されるgoal/phaseを指定する resources 成果物に含める、含めないリソース (*.properties, *.xml等) を設定する plugins ビルドに使用するプラグイン設定プラグインの追加 phaseにgoalを結びつけプラグインの引数設定ソースディレクトリ、ビルドしたclass ファイルの出力先を変更することもできるでも、基本的にやらない。

26. build - plugin ビルドにプラグインを追加 <plugin> <groupId /> <artifactId /> <version /> <configuration>…</configuration> <executions> <execution> <id>taskname</id> <phase>compile</phase> <goals> <goal>doTask</goal> </goals> <configuration>…</configuration> </execution> </executions> </plugin> groupId, artifactId, version プラグインを特定するキー configuration プラグインの引数設定 execution phaseにgoalを結びつける phase 紐付け先のフェーズ goal フェーズで実行するプラグインのgoal

27. parent (Super POM) 親POMの設定 <parent> <groupId>com.example</groupId> <artifactId>hoge</artifactId> <version>1.0.0</version> <relativePath>…</relativePath> </parent> 依存ライブラリのバージョン、ビルド時のプラグイン設定などを書いた親POMを引き継ぐことができる

28. build - pluginManagement プラグインの一括管理 <pluginManagement> <plugins> <plugin>…</plugin> </plugins> </pluginManagement> 親POMに書いておけば、子モジュールに引き継がれるマルチモジュール構成で活躍

29. dependencyManagement 依存ライブラリの構成管理 <dependencyManagement> <dependencies> <dependency> <groupId /> <artifactId /> <version /> <scope /> </dependency> <dependency>…</dependency> </dependencies> </dependencyManagement> dependencyと同じ JARを一意に特定するキーアーティファクトの属性 (version, scope, exclutions) を設定でき、dependenciesで個別に指定する必要が無くなる

30. profile 環境に応じて設定を切り替えるしくみ <profiles> <profile> <id>production</id> <activation>…</activation> <build>…</build> <dependencies>…</dependencies> </profile> <profile>…</profile> </profiles> activation プロファイルを有効化する条件を設定する build プロファイルごとのビルド設定 dependencies プロファイルごとの依存関係例えば 3つのprofile (本番, 保守, 開発) を用意し、DB接続設定ファイルを切り替える JDKのバージョンに応じたJARを生成するため、コンパイル対象とするソースファイルを差し替える

31. Mavenを使う人が知っておくべき97のこと

32. M2_HOME Mavenインストールディレクトリを指す環境変数 Mavenの実行には、%M2_HOME%の設定と、%M2_HOME%/bin をPATHに通す必要がある

33. ローカルレポジトリ Mavenが自動でダウンロードしたJAR （依存関係、プラグイン）が格納されるディレクトリのこと [ユーザーのホームディレクトリ]/.m2

34. リポジトリのミラーを設定するセントラルリポジトリにあるはずなのにJARがダウンロードできない！セントラルリポジトリが落ちてたよ・・・そんなときはホームディレクトリの.m2/settings.xmlでミラーを設定する <settings> <mirrors> <mirror> <id>UK</id> <name>UK Central</name> <url>http://uk.maven.org/maven2</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors> </settings>

35. リポジトリを追加するセントラルリポジトリに無いライブラリ（Seasar、JBoss、etc…）を利用する場合は、リポジトリの設定をPOMに追加する <repositories> <repository> <id>maven.seasar.org</id> <name>The Seasar Foundation Maven2 Repository</name> <url>http://maven.seasar.org/maven2</url> </repository> </repositories>

36. プラグインリポジトリを追加するビルドで使用するプラグインがセントラルリポジトリに存在しない場合は、プラグインリポジトリの設定をPOMに追加する <pluginRepositories> <pluginRepository> <id>maven.seasar.org</id> <name>The Seasar Foundation Maven2 Repository</name> <url>http://maven.seasar.org/maven2</url> </pluginRepository> </pluginRepositories> Maven 3 はリポジトリの解釈が厳密化され、 repositoriesからプラグインを解決しないようになった

37. 良く使うフェーズ clean targetディレクトリを削除する。ソースから一部のファイルを削除した等の理由でフルビルドしたいときに使う。 package JAR等、最終成果物を生成する。POMを書く人は、このフェーズでリリース物が出来るように設定するつもりで。 install 生成したJARをローカルリポジトリにコピーする。当該プロジェクトを参照する他のプロジェクトから、JARを利用できるようになる。

38. IDE と統合する Eclipse m2e EclipseのMaven統合プラグイン Indigo (3.7) から統合済み、Kepler (4.3) からはm2e-wtpも統合 Mavenに投資しているSonatypeが開発元 maven-eclipse-plugin POMからEclipseの.projectと.classpathを生成する、 MavenのEclipse対応プラグイン dependencyのscopeを解釈できないのでお勧めしない NetBeans 最初からMaven統合済み IntelliJ たぶんイケる（誰か買ってください

39. テストをスキップするもちろんそんなこと有り得ない訳ですが。ソースをチェックアウトしてビルドしてみたら、テストが通らないテストが通らないのでJARができず、関連プロジェクトが全部ビルドできないテストが通ってなくてもいいから、とりあえず JARが欲しいそんなときは mvn install -DskipTests テストクラスのコンパイル自体できない？ mvn install -Dmaven.test.skip

40. 残りの9xのこと Maven2のTipsを集めるWiki http://wiki.fdiary.net/maven2/ 誰でも編集できるので、何かあったら書きましょう

http://fission.dip.jp	19
https://twitter.com	7
http://s.deeeki.com	3
http://192.168.33.10	1

SlideShare for iOS

Views

Actions

Embeds 30

Report content

Transcript