Ant コマンドライン 引数
Antにはさまざまな引数があります。
公式なドキュメントはAnt Manual(英語)
使用例1
ファイルを指定して実行します
ant -f build.xml
使用例2
あるいはファイルとターゲットを指定して実行します
ant -f build.xml target1 target2
ターゲットは複数指定することが可能です。ターゲットが一つもないない場合はdefaultのターゲットを実行します。defaultのターゲットはAntファイル中のprojectタグで指定しています
<project name="test" <span id="redcode">default="target1"</span> <target name="target1"> </target> <target name="target2"> </target> </project>
引数詳細
-help 又は -h
ヘルプメッセージを表示します
ant [options] [target [target2 [target3] ...]]
Options:
-help, -h print this message
-projecthelp, -p print project help information
-version print the version information and exit
-diagnostics print information that might be helpful to
diagnose or report problems.
-quiet, -q be extra quiet
-verbose, -v be extra verbose
-debug, -d print debugging information
-emacs, -e produce logging information without adornments
-lib <path> specifies a path to search for jars and classes
-logfile <file> use given file for log
-l <file> ''
-logger <classname> the class which is to perform logging
-listener <classname> add an instance of class as a project listener
-noinput do not allow interactive input
-buildfile <file> use given buildfile
-file <file> ''
-f <file> ''
-D<property>=<value> use value for given property
-keep-going, -k execute all targets that do not depend
on failed target(s)
-propertyfile <name> load all properties from file with -D
properties taking precedence
-inputhandler <class> the class which will handle input requests
-find <file> (s)earch for buildfile towards the root of
-s <file> the filesystem and use it
-projecthelp 又は -p
プロジェクトのヘルプを表示します
-version
バージョンを表示します
Apache Ant version 1.6.1 compiled on February 12 2004
-diagnostics#text
さまざまな情報を表示してくれます。
ライブラリー情報・パーサーの情報・プロパティー情報等です。
どのクラスを使ってるかなど確認するときに便利かも
------- Ant diagnostics report ------- Apache Ant version 1.6.1 compiled on February 12 2004 ------------------------------------------- Implementation Version (JDK1.2+ only) ------------------------------------------- core tasks : 1.6.1 optional tasks : 1.6.1 ------------------------------------------- ANT_HOME/lib jar listing ------------------------------------------- ant.home: C:\java\ant ant-antlr.jar (5650 bytes) ant-apache-bsf.jar (12483 bytes) ant-apache-resolver.jar (4079 bytes) ant-commons-logging.jar (3845 bytes) ant-commons-net.jar (34888 bytes) ant-icontract.jar (9667 bytes) ant-jai.jar (21505 bytes) ant-jakarta-bcel.jar (8625 bytes) ant-jakarta-log4j.jar (3025 bytes) ant-jakarta-oro.jar (48101 bytes) ant-jakarta-regexp.jar (3708 bytes) ant-javamail.jar (6737 bytes) ant-jdepend.jar (7969 bytes) ant-jmf.jar (6609 bytes) ant-jsch.jar (21397 bytes) ant-junit.jar (67280 bytes) ant-launcher.jar (8412 bytes) ant-netrexx.jar (9898 bytes) ant-nodeps.jar (406788 bytes) ant-starteam.jar (35511 bytes) ant-stylebook.jar (2314 bytes) ant-swing.jar (6822 bytes) ant-trax.jar (66977 bytes) ant-vaj.jar (48313 bytes) ant-weblogic.jar (14410 bytes) ant-xalan1.jar (3932 bytes) ant-xalan2.jar (2489 bytes) ant-xslp.jar (2236 bytes) ant.jar (958858 bytes) xercesImpl.jar (959247 bytes) xml-apis.jar (124724 bytes) ------------------------------------------- Tasks availability ------------------------------------------- image : Missing dependency com.sun.media.jai.codec.FileSeekableStream sshexec : Missing dependency com.jcraft.jsch.UserInfo scp : Missing dependency com.jcraft.jsch.UserInfo rexec : Missing dependency org.apache.commons.net.SocketClient cvsversion : Not Available stlist : Missing dependency com.starbase.starteam.Item telnet : Missing dependency org.apache.commons.net.SocketClient ftp : Missing dependency org.apache.commons.net.ftp.FTP jdepend : Missing dependency jdepend.xmlui.JDepend junit : Missing dependency junit.framework.TestListener stcheckin : Missing dependency com.starbase.starteam.Item stcheckout : Missing dependency com.starbase.starteam.Item ------------------------------------------- org.apache.env.Which diagnostics ------------------------------------------- Not available. Download it at http://xml.apache.org/commons/ ------------------------------------------- XML Parser information ------------------------------------------- XML Parser : org.apache.xerces.jaxp.SAXParserImpl XML Parser Location: C:\java\ant\lib\xercesImpl.jar ------------------------------------------- System properties ------------------------------------------- java.runtime.name : Java(TM) 2 Runtime Environment, Standard Edition sun.boot.library.path : C:\j2sdk1.4.2_02\jre\bin java.vm.version : 1.4.2_02-b03 ant.library.dir : C:\java\ant\lib java.vm.vendor : Sun Microsystems Inc. java.vendor.url : http://java.sun.com/ path.separator : ; java.vm.name : Java HotSpot(TM) Client VM file.encoding.pkg : sun.io user.country : JP sun.os.patch.level : Service Pack 1 java.vm.specification.name : Java Virtual Machine Specification user.dir : C:\Documents and Settings\xxxx\workspace\aLinkParser java.runtime.version : 1.4.2_02-b03 java.awt.graphicsenv : sun.awt.Win32GraphicsEnvironment java.endorsed.dirs : C:\j2sdk1.4.2_02\jre\lib\endorsed os.arch : x86 java.io.tmpdir : C:\DOCUME~1\xxxx\LOCALS~1\Temp\ line.separator : java.vm.specification.vendor : Sun Microsystems Inc. user.variant : os.name : Windows XP ant.home : C:\java\ant sun.java2d.fontpath : java.library.path : C:\j2sdk1.4.2_02\bin;.;C:\WINDOWS\System32;C:\WINDOWS;C:\Perl\bin\;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\Program Files\cvsnt;c:\j2sdk1.4.2_02\bin; java.specification.name : Java Platform API Specification java.class.version : 48.0 java.util.prefs.PreferencesFactory : java.util.prefs.WindowsPreferencesFactory os.version : 5.1 user.home : C:\Documents and Settings\xxxx user.timezone : Asia/Tokyo java.awt.printerjob : sun.awt.windows.WPrinterJob file.encoding : MS932 java.specification.version : 1.4 java.class.path : C:\java\ant\lib\ant-launcher.jar;C:\java\ant\lib\ant-antlr.jar;C:\java\ant\lib\ant-apache-bsf.jar;C:\java\ant\lib\ant-apache-resolver.jar;C:\java\ant\lib\ant-commons-logging.jar;C:\java\ant\lib\ant-commons-net.jar;C:\java\ant\lib\ant-icontract.jar;C:\java\ant\lib\ant-jai.jar;C:\java\ant\lib\ant-jakarta-bcel.jar;C:\java\ant\lib\ant-jakarta-log4j.jar;C:\java\ant\lib\ant-jakarta-oro.jar;C:\java\ant\lib\ant-jakarta-regexp.jar;C:\java\ant\lib\ant-javamail.jar;C:\java\ant\lib\ant-jdepend.jar;C:\java\ant\lib\ant-jmf.jar;C:\java\ant\lib\ant-jsch.jar;C:\java\ant\lib\ant-junit.jar;C:\java\ant\lib\ant-launcher.jar;C:\java\ant\lib\ant-netrexx.jar;C:\java\ant\lib\ant-nodeps.jar;C:\java\ant\lib\ant-starteam.jar;C:\java\ant\lib\ant-stylebook.jar;C:\java\ant\lib\ant-swing.jar;C:\java\ant\lib\ant-trax.jar;C:\java\ant\lib\ant-vaj.jar;C:\java\ant\lib\ant-weblogic.jar;C:\java\ant\lib\ant-xalan1.jar;C:\java\ant\lib\ant-xalan2.jar;C:\java\ant\lib\ant-xslp.jar;C:\java\ant\lib\ant.jar;C:\java\ant\lib\xercesImpl.jar;C:\java\ant\lib\xml-apis.jar;C:\j2sdk1.4.2_02\lib\tools.jar user.name : xxxx java.vm.specification.version : 1.0 java.home : C:\j2sdk1.4.2_02\jre sun.arch.data.model : 32 user.language : ja java.specification.vendor : Sun Microsystems Inc. awt.toolkit : sun.awt.windows.WToolkit java.vm.info : mixed mode java.version : 1.4.2_02 java.ext.dirs : C:\j2sdk1.4.2_02\jre\lib\ext sun.boot.class.path : C:\j2sdk1.4.2_02\jre\lib\rt.jar;C:\j2sdk1.4.2_02\jre\lib\i18n.jar;C:\j2sdk1.4.2_02\jre\lib\sunrsasign.jar;C:\j2sdk1.4.2_02\jre\lib\jsse.jar;C:\j2sdk1.4.2_02\jre\lib\jce.jar;C:\j2sdk1.4.2_02\jre\lib\charsets.jar;C:\j2sdk1.4.2_02\jre\classes java.vendor : Sun Microsystems Inc. file.separator : \ java.vendor.url.bug : http://java.sun.com/cgi-bin/bugreport.cgi sun.io.unicode.encoding : UnicodeLittle sun.cpu.endian : little sun.cpu.isalist : pentium i486 i386
-quiete 又は -q
なるべく出力を減らします。
-verbose 又は -q
quietとは逆になるべく出力を増やします。
-debug 又は -d
debugメッセージを表示するようにします。
-emacs 又は -e
ログ情報をレイアウト文字列なしで出力します
-lib 又は -l
クラスファイルやクラスを参照するパスを指定します。
-logfile 又は -l
ログファイルを指定します。
-propertyfile
プロパティーをファイルから読み込みます。
しかし引数-Dでのプロパティーを優先させます。
-logger
-listener
-noinput
インプットさせません。
つまりinputTaskが無効になります。
サーバーサイド等inputがありえない環境で使うといいかも知れません。
-buildfile 又は -file 又は -f
antファイルを指定します。
一番使う引数になると思います。
-D=
プロパティーを渡します。
他にpropertyを渡す方法として、ファイルを使って渡す方法や、環境変数を使う方法もあります
-keep-going 又は -k
依存するターゲット(depends)で実行が失敗しても、元となるターゲットは実行を続けます。
-inputhandler
-find 又は -s
指定されたファイル位置から、buildファイルを検索し見つけたら実行します。
たぶん、build.xml 検索じゃないでしょうか。
