使用命令行开发管理Android

创建项目

Creating a new project with build.xml

If you've already created your project and followedthe above instructions, you can skip this section. If not, you can may eithercreate a new Android project using the regular Eclipse method (via New >Other... > Android Project), and follow the instructions in the abovesection, or you can use the command line as described here.

androidcreate project --name YourProjectName --path C:\dev\YourProject --targetandroid-3 --package com.company.testproject --activity MainActivity

 

生成目录：src/  res/ bin/ libs/

生成文件：

AndroidManifest.xml

build.properties  由开发人员在其中配置build时的参数，Android-tools不会修改它。

default.properites 由android-tools创建和更新，必须checkin到Version ControlSystem。

local.properties  包含本地的SDK路径，不应该checkin VersionControl System。

build.xml 

proguard.cfg 

 

Note: To see theavailable targets, use android list target and you should see something like:

>android list target
id: 1 or "android-3"
     Name: Android 1.5
     Type: Platform
     API level: 3
     Revision: 4
     Skins: HVGA (default), HVGA-L, HVGA-P, QVGA-L, QVGA-P

In the above case, you can use either 1 or android-3as the target ID.

 

创建完成后，根目录下会生成build.xml，默认task为help，执行ant会显示可以使用的target。其中ant release将会编译后生成一个未签名的apk。

 

build.xml 利用的android项目的自定义task setup（com.android.ant.SetupTask）来完成一系列的编译、打包、执行的操作。所以初始的build.xml所有工作都是<setup />完成的。而setup实际上是import一系列实际干事的target来完成工作的。可以在<setup />前后添加target来完成自定的工作。

 

在Eclipse项目中使用build.xml

默认生成的build.xml在Eclipse中被认为有错误，因为build.xml中没有定义任何target，default target help 是被<setup/> import进来的。所以删除project default target定义就好了。

在bat脚本启动ant，可能需要在命令行中指明build.xml的绝对位置，可能项目中bat脚本的运行目录、eclipse运行目录、ant运行目录不一致。

 

自动签名

默认build.xml不知道签名的配置信息，所以ant release只能生成unsigned的apk包。在同目录下的build.properties添加一下配置信息，并将签名文件拷贝到同目录下就行了。

配置信息：

key.store=《keystored的文件名》
key.alias=《key alias》

如果添加下面的密码信息，就需要在执行ant的时候输入密码了：

key.store.password=《password》

key.alias.password=《password》

配置完成后，再执行ant release就会自动生成signed的apk包了。

 

自动安装签名后的apk

在build.xml的<setup />后面添加target install-r，执行ant install-r就可以直接安装release package到默认设备或浏览器上。

    <targetname="install-r" depends="release">

               <exec executable="${adb}"failοnerrοr="true">

                   <arg line="${adb.device.arg}"/>

                   <arg value="install"/>

                   <arg value="-r" />

                   <argpath="${out.release.file}" />

               </exec>

</target>

NOTE 安装到目标设备

tools/ant/main_rules.xml中<propertyname="adb.device.arg" value="" />，所以安装到默认的设备或浏览器上。来指定安装目标，可以在ant命令执行时定义，如：ant –Dadb.device.arg=[-d|-e|-s<serialNumber>]，或者在build.xml的<setup />之前设置property adb.device.arg。

 

自动安装后，自动启动

可以利用ant，实现“自动启动”的target，发在“自动安装”的target之后运行，实现和eclipse中安装运行debug apk一样的效果。

1. 从Manifest文件中获取包名和Activity名称

    <!-- Name of the application packageextracted from manifest file -->

    <xpathinput="AndroidManifest.xml" expression="/manifest/@package"

                output="manifest.package" />

    <xpath input="AndroidManifest.xml" expression="/manifest/application/activity/@android:name"

                output="manifest.activity" />

2. 获取启动Activity的名称

从Manifest文件中获取的启动Activity名称形式多样，例如，

android:name=”.MainActivity”

或者，没有点，android:name=”.MainActivity”

或者，包名都也好的，android:name=”com.test.MainActivity”

需要在ant中使用字符处理task来处理从Manifest文件中获取的名称，

第三方的扩展ant-contrib提供这样的task，在sourceforge上可以下载到。

<taskdefname="propertyregex"

    classname="net.sf.antcontrib.property.RegexTask">

    <classpath>

        <pathelementlocation="D:\\wihome\\projects\\android\\HelloCmd\\ant-contrib-1.0b3.jar"/>

    </classpath>

</taskdef>

<propertyregexproperty="manifest.activity.name"

    input="${manifest.activity}"

    regexp="[.]*[\.]*([^\.]*)$"

    select="\1" />

3. 利用命令adb shell am start -n<package-name>/<package-name>.<activity-name>启动已经安装的application。

<targetname="run-r" depends="install-r">

    <exec executable="${adb}"failοnerrοr="true">

        <arg line="${adb.device.arg}" />

        <arg line="shell am start -n" />

        <argvalue="${manifest.package}/${manifest.package}.${manifest.activity.name}"/>

    </exec>

</target>

 

利用Config文件控制文件中常量内容

参看《Using Ant to Automate Building AndroidApplications》 >>  Usinga Java configuration file

 

在Eclipse项目中使用ant

1. 在Eclipse项目的根目录（AndroidManifest.xml同目录）执行

android update project –path.

执行完之后会在目录下生成build.xml

 

2. 修改build.xml

默认的build.xml只包含target，target都被<setup />隐藏起来。eclipse ant plugin 认不出来隐藏的target就没法执行。所以需要做如下修改：

1）<setup />改为<setupimport="false"/>

2）将rules文件（如，sdk.dir/tools/ant/main_rules.xml，一般都是main rules）手动import进来。

将rules文件的project标签的内容，也即那些隐藏的target，拷贝到setup标签之后。

 

3. 在Eclipse中右键点击build.xml，选择run as >> ant build…，配置需要执行的target，就可以run了。

 

4. 将签名keystore文件拷贝到project根目录，配置build.properties文件，就可以自动生成签名好的apk了，如何配置，参见本文其他部分。

 

Note build.xml的执行需要Eclipse ant plugin的ant版本在1.8以上。最新的eclipse 3.7（indigo）中的ant已经达到1.8。

 

Ant启动

 

 

 

 

[Reference]

SDK DOC >> Developing >> Managing Projects>> From the Command Line

SDK DOC >> Developing >> Building andRunning

Online DOC >> Using Ant to Automate BuildingAndroid Applications