现在的位置: 首页 > 综合 > 正文

Android 中的ant文件说明

2013年02月19日 ⁄ 综合 ⁄ 共 7381字 ⁄ 字号 评论关闭

Android本身是支持ant打包项目的,并且SDK中自带一个build.xml文件。  
通过该文件,可以对文件进行编译、打包、安装等。并且支持多种方式打包,如debug或者release。  
一般的,可以按照如下方法进行操作:  


首先创建一个Android工程。  
工程创建好后,需要为工程添加ant支持,即创建相应的build.xml文件。  
这个文件不需要用户自己创建,只需要执行如下命令即可:  
<sdk>/tools/android update project -p <project> -t <target>  


其中:  
sdk为sdk的安装目录,其下的tools/android是我们要使用的命令。  
project为项目目录。  
target为项目所使用的android的target id,也就是项目对应的android的版本。  


可以将sdk的tools目录添加到环境变量 ~/.bashrc 文件中,重启后生效,以后可以直接使用命令了。  
可以通过执行以下命令查看当前sdk中所包含的target以及相应id:  
android list targets  


执行完android update project命令后,会在项目的根目录下生成相应的ant文件。  
主要有build.xml、ant.properties、local.properties三个文件。  
如果没有ant.properties文件,可以自己手动添加。  


其中,build.xml文件是进行ant build的主要文件,它引用了其它的文件。  
在local.properties文件中定义了sdk.dir属性,也就是当前使用的sdk的目录。  
在ant.properties文件中,可以定义自己的一些属性,或者重定义一些属性。  
当然,这两个属性文件可有可无,直接定义到build.xml中也没有关系。  


在build.xml中的最后,引用了sdk目录下的tools/ant/build.xml文件。  
这个是sdk默认的build文件,可以将其内容直接拷贝过来,也可以保持当前的引用方式。  
项目下的build.xml默认执行的target是help,运行后可以看到相关的帮助信息。  
通过帮助信息,可以看到其它可用的target。  
一般的,我们需要修改为debug或者release。  
修改好之后,再运行build.xml文件,就会执行我们需要的编译过程了。  
build.xml文件的执行方法为:右键->Run As->Ant Build。  


如果是debug版的话,默认会使用debug方式签名。  
如果是release版的话,需要指定相应的keystore以及私钥。  
否则,最后只能生成一个没有签名的apk文件。  


设定私钥库的方法是,在ant.properties文件中,添加如下内容:  
key.store=<keystore>  
key.alias=<key>  
key.store.password=<keystore pwd>  
key.alias.password=<key pwd>  


其中:  
keystore为私钥库文件。  
key为签名需要使用的私钥。  
key.store.password为私钥库的密码。  
key.alias.password为私钥的密码。  


两个密码相关的属性也可以不添加,而只添加私钥库及私钥。  
这样的话,执行时会依次弹出相应的输入框,提示用户输入相应的密码。  
这样虽然相对繁琐,但是由于没有明文指定密码,对私钥库的保护会更好一些。  


如果项目引用了第三方库的话,只需要在项目根目录创建libs文件夹并将其放入即可。  
如果是jar库,直接放到libs目录下;如果是so库,需要放到libs的名为armeabi的子目录下。  
也可以通过设定相应的属性来指定第三方库的位置,其默认都是libs文件夹。  
jar.libs.dir为jar类型库所在的目录。  
native.libs.absolute.dir为so类型库所在的目录,即armeabi的父目录。  


如果项目包含了jni代码,希望在打包时自动重新编译so库,可以修改build.xml文件。  
修改方法为,在引用sdk的build.xml文件之前添加如下target:  
<target name="-pre-build" depends="-ndk-build">  
</target>  
<target name="-ndk-build">  
    <exec executable="ndk-build" failonerror="true">  
        <arg value="clean" />  
    </exec>  
    <exec executable="ndk-build" failonerror="true" />  
</target>  


ndk-build为ndk提供的命令,需要将ndk安装目录添加到环境变量中,添加方法同sdk/tools。  
生成的so默认会放到libs/armeabi目录下。  


使用默认的build.xml打包apk时,已经包含了混淆、签名、对齐优化等相关过程。  
如果是使用release的方式,最后生成的apk文件已经可以直接发布了。  


遗留问题:  
目前采用这种方法生成的APK,虽然已经被签名了,但是,安装时错误,提示未签名。  
查看APK包中的签名文件,不是默认的CERT.*,而是<key>.*。  
然后,即使将名称修改成CERT.*,程序仍然不能正常安装。  
如果导出debug版本,则不会有这个问题。  
用ADT插件导出签名APK,也不会有这个问题。  


解决方法:  
产生此问题的根本原因是JDK1.7造成的,只有运行Ant使用jre1.7的版本时,才会发生该问题。  
可以通过设置运行build.xml文件时使用的jre版本来解决,具体方法是:  
选中build.xml->右键->Run As->External Tools Configurations,  
在右侧区域选中JRE标签页,可以看到对jre设定有三个选项:  
Run in the same JRE as the workspace使用与workspace相同版本的jre。  
Execution environment根据相关环境选择一个jre版本。  
Separate JRE使用一个已经安装的jre的当前版本。  

一般项目的jre都会设定为1.7以下的版本,所以建议选择第一个,使其与项目设定保持一致即可。 




如何使用ant编译Android工程

很早就知道Android支持命令行方式创建和编译工程,但大多数情况下我们都是直接使用Eclipse+ADT的方式来处理的。

最近做的项目就是使用ant来编译的,之前也没研究过ant怎么样,所以一直不知道怎么用ant来编译Android工程。

今天在Gentoo下试了下,没有做任何设置ant就可以用了,应该是以前我不知不觉就安装好了。

安装ant

如果是在Windows下,需要到网站上去下载:http://ant.apache.org/bindownload.cgi

再设置好环境变量,这个就不说了。

使用android命令创建工程

ant编译需要依赖于build.xml文件,如果是用Eclipse生成的工程,是没有这个文件的。显然Google支持ant编译自然不会让我们去手动生成的文件了,她为我们准备了android命令:

输入android create project查看如何创建一个Android工程:

pjq@gentoo-pjq ~/android/workspace $ android create project
Error: The parameters --target, --path, --package, --activity must be defined for action 'create project'

Usage:
  android [global options] action [action options]

Global options:
  -v --verbose  Verbose mode: errors, warnings and informational messages are printed.
  -h --help     Help on a specific command.
  -s --silent   Silent mode: only errors are printed out.

Action "create project":
  Creates a new Android Project.
Options:
  -n --name     Project name
  -t --target   Target id of the new project [required]
  -p --path     Location path of new project [required]
  -k --package  Package name [required]
  -a --activity Activity name [required]

使用命令:

android create project -n AndroidAnt -t android-8 -p ./AndroidAnt -k net.impjq.androidant -a HelloAndroidAnt
Created project directory: ./AndroidAnt
Created directory /home/pjq/android/workspace/AndroidAnt/src/net/impjq/androidant
Added file ./AndroidAnt/src/net/impjq/androidant/HelloAndroidAnt.java
Created directory /home/pjq/android/workspace/AndroidAnt/res
Created directory /home/pjq/android/workspace/AndroidAnt/bin
Created directory /home/pjq/android/workspace/AndroidAnt/libs
Created directory /home/pjq/android/workspace/AndroidAnt/res/values
Added file ./AndroidAnt/res/values/strings.xml
Created directory /home/pjq/android/workspace/AndroidAnt/res/layout
Added file ./AndroidAnt/res/layout/main.xml
Created directory /home/pjq/android/workspace/AndroidAnt/res/drawable-hdpi
Created directory /home/pjq/android/workspace/AndroidAnt/res/drawable-mdpi
Created directory /home/pjq/android/workspace/AndroidAnt/res/drawable-ldpi
Added file ./AndroidAnt/AndroidManifest.xml
Added file ./AndroidAnt/build.xml

很明显目录结构和用Eclipse生成的一样,只是多了build.xml,这个就是为了在命令行用ant编译而准备的。

使用ant编译Android工程

编译这个新生成的工程

pjq@gentoo-pjq ~/android/workspace $ cd AndroidAnt/
pjq@gentoo-pjq ~/android/workspace/AndroidAnt $ ls
AndroidManifest.xml  build.xml           local.properties
bin                  default.properties  res
build.properties     libs                src
pjq@gentoo-pjq ~/android/workspace/AndroidAnt $ ant
Buildfile: /home/pjq/android/workspace/AndroidAnt/build.xml
    [setup] Android SDK Tools Revision 6
    [setup] Project Target: Android 2.2
    [setup] API level: 8
    [setup] WARNING: No minSdkVersion value set. Application will install on all Android versions.
    [setup] Importing rules file: platforms/android-8/ant/ant_rules_r2.xml

help:
     [echo] Android Ant Build. Available targets:
     [echo]    help:      Displays this help.
     [echo]    clean:     Removes output files created by other targets.
     [echo]    compile:   Compiles project's .java files into .class files.
     [echo]    debug:     Builds the application and signs it with a debug key.
     [echo]    release:   Builds the application. The generated apk file must be
     [echo]               signed before it is published.
     [echo]    install:   Installs/reinstalls the debug package onto a running
     [echo]               emulator or device.
     [echo]               If the application was previously installed, the
     [echo]               signatures must match.
     [echo]    uninstall: Uninstalls the application from a running emulator or
     [echo]               device.

BUILD SUCCESSFUL
Total time: 2 seconds

使用ant debug来生成用debug key签名的APK。

ant debug
pjq@gentoo-pjq ~/android/workspace/AndroidAnt $ ant debug
Buildfile: /home/pjq/android/workspace/AndroidAnt/build.xml
    [setup] Android SDK Tools Revision 6
    [setup] Project Target: Android 2.2
    [setup] API level: 8
    [setup] WARNING: No minSdkVersion value set. Application will install on all Android versions.
    [setup] Importing rules file: platforms/android-8/ant/ant_rules_r2.xml

-compile-tested-if-test:

-dirs:
     [echo] Creating output directories if needed...
    [mkdir] Created dir: /home/pjq/android/workspace/AndroidAnt/gen
    [mkdir] Created dir: /home/pjq/android/workspace/AndroidAnt/bin/classes

-resource-src:
     [echo] Generating R.java / Manifest.java from the resources...

-aidl:
     [echo] Compiling aidl files into Java classes...

compile:
    [javac] /home/pjq/android/android-sdk-linux_86/platforms/android-8/ant/ant_rules_r2.xml:255: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
    [javac] Compiling 2 source files to /home/pjq/android/workspace/AndroidAnt/bin/classes

-dex:
     [echo] Converting compiled files and external libraries into /home/pjq/android/workspace/AndroidAnt/bin/classes.dex...

-package-resources:
     [echo] Packaging resources
 [aaptexec] Creating full resource package...

-package-debug-sign:
[apkbuilder] Creating AndroidAnt-debug-unaligned.apk and signing it with a debug key...
[apkbuilder] Using keystore: /home/pjq/.android/debug.keystore

debug:
     [echo] Running zip align on final apk...
     [echo] Debug Package: /home/pjq/android/workspace/AndroidAnt/bin/AndroidAnt-debug.apk

BUILD SUCCESSFUL
Total time: 8 seconds



抱歉!评论已关闭.