Building

Clickをビルドする

JARファイルやWARファイルなどのClick関連の生成物は、Antをベースにしたビルドシステムを使って生成されます。

• ビルド構成
• 用意されているAntターゲット
• Click Frameworkの依存関係
• Click Extrasの依存関係

 ビルド構成

ClickのAntによるビルド構成の詳細は以下になります。

+--[build]                      Ant ビルドディレクトリ
|   |
|   +---build.xml               Ant ビルドスクリプト
|   |
|   +---build.properties        Ant ビルドプロパティファイル
|   
+--[dist]                       JAR 及び WAR ファイルの出力ディレクトリ
|
+--[documentation]              Click ドキュメント
|
+--[examples]                   Click Examples　アプリケーション
|   |
|   +---build.xml               Ant ビルドスクリプト
|   |  
|   +---README.txt              Click Examples Readme ファイル
|
+--[extras]                     Click Extras ソースディレクトリ
|
+--[framework]                  Click framework ソースディレクトリ
|
+--[lib]                        依存する JAR ライブラリ　ディレクトリ
|
+--[mock]                       Mock オブジェクトのソースディレクトリ

ビルドの前準備

ビルドを実行する前に、以下の準備を完了させてください。

1. 環境変数JAVA_HOMEでＪＤＫ（1.4以降）のインストール先を指定してください

2. 環境変数ANT_HOMEで、Ant（1.6.5以降）のインストール先を指定してください

3. junit.jarをANT_HOME/libディレクトリに置いてください

 用意されているAntターゲット

ant help
Buildfile: build.xml

help:
     [echo] Click web application framework
     [echo] ===============================

     [echo] Main targets:

     [echo] build-all             build framework, extras, examples
     [echo] build-distribution    build distribution ZIP file
     [echo] build-examples        build click-examples WAR file
     [echo] build-extras          build click-extras JAR file
     [echo] build-framework       build click framework JAR file
     [echo] build-maven-bundles   build Maven repository upload bundles
     [echo] build-sources         build source ZIP files for use with IDEs
     [echo] deploy-examples       copy examples WAR files to app server
     [echo] get-deps              download JAR dependencies
     [echo] get-deps-proxy        download JAR dependencies via proxy
     [echo] help                  display the Help message
     [echo] javadoc               create Javadoc HTML files
     [echo] project-quick-start   build application template	

     [echo] Please ensure you have configured build.properties


BUILD SUCCESSFUL 

依存ファイルの入手

1. Antのターゲットであるget-depsを実行し、ibilio Mavenリポジトリから依存するJARファイルをダウンロードします。

      ant get-deps 

もし、ファイアウォールなどで直接ダウンロードできない場合には、build.propertiesファイルでプロキシの設定を行なった上で、get-deps-proxyターゲットを使用してください。

      # Proxy hostname used by Ant target 'get-deps-proxy'
      proxy.host=192.168.0.3

      # Proxy port for by Ant target 'get-deps-proxy'
      proxy.port=3128 

Click Frameworkをビルドする

Click Frameworkをビルドしてclick.jarを作成するには、以下の手順を行ってください。

1. ここまでの設定と、ant get-depsの実行が完了していることを確認してください。

2. build-frameworkターゲットを実施し、frameworkをビルドします。

      ant build-framework 

Click Extrasをビルドする

Click Extras をビルドしてclick-extras.jarを作成するには、以下の手順を行ってください。

1. ここまでの設定と、ant get-depsの実行が完了していることを確認してください。

2. build-frameworkターゲット及びbuild-extrasターゲットを実施します。

     ant build-framework build-extras 

Examplesをビルドする

Click Exapmles及びClick QuickStartのWARファイルを作成するには、以下の手順を行ってください。

1. examples/README.txtを確認し、必要な設定及び依存ファイルのダウンロードをexamplesフォルダにて実施します。

2. buildフォルダにて必要な設定とget-depsの実行が完了していることを確認します。

3. build-allターゲットを実行します。

      ant build-all 

 Click Frameworkの依存関係

Click framework は以下のランタイム依存性があります。

＊印のついたライブラリとソースは、click.jarに含まれています。

標準のclick-xx.jarは、これら依存ファイルすべてを含みます。対してclick-nodeps-xx.jarは、依存関係を全く含みません。

 Click Extrasの依存関係

Click Extras は framework本体の依存関係に加え、以下のランタイム依存性があります。