ant使用全总结_ant教程_ant打包apk_ant如何使用

其中，build.xml文件是进行ant build的主要文件，它引用了其它文件。

这些被引用的文件有local.properties，ant.properties两个属性文件，

以及在build.xml中的最后，引用了sdk目录下的tools/ant/build.xml文件。

在ant.properties文件中，添加如下内容：

key.store=<keystore>

key.alias=<key>

key.store.password=<keystore pwd>

key.alias.password=<key pwd>

3、如果项目包含了jni代码，希望在打包时自动重新编译so库，可以修改build.xml文件。

修改方法为，在引用sdk的build.xml文件之前添加如下target：

生成的so默认会放到libs/armeabi目录下。

如果没有正确签名，使用ant release打包后无法安装，会报错INSTALL_PARSE_FAILED_NO_CERTIFICATES

签名参考http://blog.csdn.net/fengye810130/article/details/9159419

平时可以ant debug打包运行。

ant的默认生成文件为build.xml；输入ant后，ant会在当前目录下搜索是否有build.xml，如果有，则执行；当然也可以自定义生成文件，通过ant -f a.xml即可指定a.xml为生成文件；

ant的生成文件是xml文件，整体结构为：

1 2 3 4 5 6 7 8 9 10

<? xml version="1.0" encoding="gbk"?> < project default="delete">      < property name="name" value="xiazdong"/>      < target name="delete" depends="mkdir">          < delete dir="${name}"/>      </ target >      < target name="mkdir">          < mkdir dir="${name}"/>      </ target > </ project >

<project default=“target”  basedir=”.”   name=”projectname”>

(1) default表示默认的运行目标，这个属性是必须的。 

(2) basedir表示项目的基准目录，一般都是basedir=”.”当前目录
。 

每个构建文件都对应于一个项目，但是大型项目经常包含大量的子项目，每一个子项目都可以有自己的构建文件。 

2.<target>元素

是project元素的子元素，在project元素中能够有多个target，一个target标签可以依赖其他的target标签。

例如，有一个target用于编译程序，另一个target用于生成可执行文件。在生成可执行文件之前必须先编译该文件，因此可执行文件的target依赖于编译程序的target。

一般形式如下：

(1) name表示名称，这个属性是必须的。 

Ant的depends属性指定了target的执行顺序(可以有多个名称，用逗号分割)
。Ant会依照depends属性中target出现顺序依次执行每个target。在执行之前，首先需要执行它所依赖的target。程序中的名为run的target的depends属性compile，而名为compile的target的depends属性是prepare，所以这几个target执行的顺序是prepare->compile->run。一个target只能被执行一次，即使有多个target依赖于它。
if的值表示一个属性名，只有设置了该属性名，才能执行此target；
unless的值表示一个属性名，只有没有设置该属性名，才能执行此target；如果没有if或unless属性，target总会被执行。 

3.<property>元素

是project的子元素，
用于定义属性，一般形如：

(1)<
property name=”pname”   value=”pvalue”/>

如果要使用此property，则需要${pname}；类似于表达式语言；

(2)<property file=”a.properties”/>
 通过此属性文件导入属性；

如果单纯想使用$，则通过$$表示；

<echo>      </echo>

举例：<echo>hello</echo>

2.<javac>

<javac srcdir=”src”  destdir=”class”  classpath=”libs”/>；

(1).srcdir表示源程序的目录，
编译此文件夹下或子文件夹下的全部java文件
。 

(2).destdir表示class文件的输出目录，
编译后的class文件放置路径
。 

(3).include表示被编译的文件的模式，符合此模式的都会被编译。 

(4).excludes表示被排除的文件的模式，符合此模式的不会编译。 

(5).classpath表示所使用的类路径，指定第三方类库。 

(6).debug表示是否包含调试信息。 

(9).fileonerror表示当碰到错误就自动停止。 

3.<java>

用来执行编译生成的.class文件即运行java类，一般形式如下：

<java classname=” ”  fork=”yes“>

    <arg line=”param1   param2   param3″/>

</java>

(1).classname 表示将执行的类名。 

(3).classpath所表示用到的类路径。 

(4).fork表示在一个新的虚拟机中运行该类，
而不是中断ANT命令,因此fork必须为yes；

(7).append表示追加或者覆盖默认文件。

4.<jar>

用来生成一个JAR文件把class打包成jar包；一般形式如下：

<jar destfile=”main.jar”  basedir=” “>

    <manifest>

        <attribute name=”Main-Class”   value=”classname”/>    <!–指定主类–>

    </manifest>

</jar>

basedir的值是需要打成jar包的目录，一般为${classes}

5.<mkdir>

<mkdir dir=”a\b”/>

6.<delete>

用于删除一个文件或一组文件，一般形式如下：

<delete dir=”a\b”/> 
可以删除a目录下的b目录；

<delete file=”1.txt”/>可以删除文件；

(1).file表示要删除的文件。 

(5).verbose表示指定是否列出所删除的文件，默认值为不列出。 

7.<tstamp>

时间戳，一般形式如下：

<tstamp />

接下来可以使用${DSTAMP}进行调用当前时间；

8.<copy>

用于文件或文件集的拷贝
，一般形式如下：

<copy file=”file1″ tofile=”file2″/>

9.<move>

移动文件，一般形式如下：

<move file=”file1″ tofile=”file2″/>

file是源文件；

tofile是目标文件；

10.<replace>

用于替换字符串，类似于String的replace操作，一般形式如下：

<replace file=”filename” token=”old” value=”new”/>

file表示要执行替换的文件；

token表示被替换的字符串；

value表示替换的字符串；

1. def test (arg):  
2.     to do something  

1. <project name=“test_ant”>  
2.          
3.     <macrodef name=“test”>  
4.         <attribute name=“arg” default=“testssss”/>  
5.         <sequential>  
6.             <echo>to do something</echo>  
7.         </sequential>  
8.     </macrodef>  
9.     <test/>  
10. </project>  

1. ———- ant ———-  
2. Buildfile: D:\workspace\workspace20130318\Z_Frame\test.xml  
3.      [echo] to do something  
4.          
5. BUILD SUCCESSFUL  
6. Total time: 0 seconds  
7.          
8. 输出完成 (耗时 0 秒) – 正常终止  

1. ———- ant ———-  
2. Buildfile: D:\workspace\workspace20130318\Z_Frame\test.xml  
3.      [echo] arg is : i am a param  
4.          
5. BUILD SUCCESSFUL  
6. Total time: 0 seconds  
7.          
8. 输出完成 (耗时 0 秒) – 正常终止  

1. def test (arg):  
2.     print(arg)  
3.          
4. test(‘test’)  

1. <macrodef name=“test”>  
2.     <attribute name=“arg” default=“testssss”/>  
3.     <element name=“print” optional=“yes” />  
4.     <sequential>  
5.         <echo>arg is : @{arg}</echo>  
6.         <print/>  
7.     </sequential>  
8. </macrodef>  

1. <project name=“test_ant”>  
2.          
3.     <macrodef name=“test”>  
4.         <attribute name=“arg” default=“testssss”/>  
5.         <element name=“print” optional=“yes” />  
6.         <sequential>  
7.             <echo>arg is : @{arg}</echo>  
8.             <print/>  
9.         </sequential>  
10.     </macrodef>  
11.     <test arg=“i am a param”>  
12.         <print>  
13.             <echo>i am a function</echo>  
14.         </print>  
15.     </test>  
16. </project>  

1. ———- ant ———-  
2. Buildfile: D:\workspace\workspace20130318\Z_Frame\test.xml  
3.      [echo] arg is : i am a param  
4.      [echo] i am a function  
5.          
6. BUILD SUCCESSFUL  
7. Total time: 0 seconds  
8.          
9. 输出完成 (耗时 0 秒) – 正常终止  

1. <project name=“test” default=“test”>  
2.     <macrodef name=“print”>  
3.         <attribute name=“text”/>  
4.         <element name=“telement” optional=“yes” />  
5.         <sequential>  
6.             <echo>@{text}</echo>  
7.         </sequential>  
8.     </macrodef>  
9.        
10.     <macrodef name=“testing”>  
11.        <attribute name=“v” default=“NOT SET”/>  
12.        <!– 这里就相当于提供了一个接口 –>  
13.        <element name=“some-tasks” optional=“yse”/>  
14.        <sequential>  
15.           <echo>v is @{v}</echo>  
16.           <some-tasks/>  
17.        </sequential>  
18.     </macrodef>  
19.        
20.     <testing v=“This is v”>  
21.        <some-tasks>  
22.           <echo>this is a test</echo>  
23.        </some-tasks>  
24.     </testing>  
25.        
26.     <target name=“telement”>  
27.         <print text=“telement”/>  
28.     </target>  
29.        
30.     <target name=“test”>  
31.         <print text=“print test”/>  
32.     </target>  
33. </project>  

<target name="build_math" depends="base">
    <echo message="... building jck-api-math-cases  now ..."/>
    <javac debug="false"  destdir="bin" source="1.5" target="1.5">
        <src path="./java_math"/>
        <classpath refid="java_jck.classpath"/>
    </javac>
</target>

<target name="make_math" depends="build_math">
    <echo message="... make math jar ...."></echo>
    <jar jarfile="math.jar" basedir="./bin"/>
    <move file="./math.jar" tofile="./lex/math.jar" overwrite="true"/>
</target>

<target name="build_io" depands="base">
    ……
</target>

<target name="make_io" depends="build_io">
    ……
</target>
……

<macrodef name="dealWithTestCases">            //macrodef的定义，定义了name属性
    <attribute name="tarName" />              //参数定义
    <attribute name="srcPath" />
    <!--element name="dex-elements"/-->
    <sequential>               //实际执行的内容在<sequential>里
        <echo message="... building jck-api-@{tarName}-cases  now ...."/>
        <javac debug="false"  destdir="bin" source="1.5" target="1.5" includeantruntime="on">
            <src path="./@{srcPath}"/>
            <classpath refid="java_jck.classpath"/>
            <excludesfile name="exclude.@{tarName}"/>
        </javac>
        <echo message="... make @{tarName} jar ..."></echo>
        <jar jarfile="@{tarName}.jar" basedir="./bin"/>
        <move file="./@{tarName}.jar" tofile="./lex/@{tarName}.jar" overwrite="true"/>
    </sequential>
</macrodef>

<target name="lex" depands="base">
    <dealWithTestCases tarName="math" srcPath="./java_math"/>     //外部调用宏
    <dealWithTestCases tarName="io" srcPath="./java_io"/>    
    ……    
</target>

从例子中可以明显看出，MacroDef的使用不仅仅是减少了重复的工作量，性能影响可能非常显著，并且还可能产生更易读和更易于维护的编译文件。

需要注意的是：

1、在整个build文件里，<macrodef>是和<target>平级的，上例中定义的<dealWithTestCases>若不将其放在<target>里面，执行Ant时，脚本会直接执行这部分的宏代码，而不会去执行<target>中定义的‘depands=”base”‘依赖关系。

作者：jason0539

微博：http://weibo.com/2553717707

博客：http://blog.csdn.net/jason0539（转载请说明出处）