Android项目使用Ant多渠道打包（最新sdk）

参考文章：

http://blog.csdn.net/liuhe688/article/details/6679879

http://www.eoeandroid.com/thread-323111-1-1.html

http://yangguangfu.iteye.com/blog/723182

http://blog.csdn.net/cen616899547/article/details/22225947

 

一、Android使用Ant的打包流程

　　使用ANT来对应用打包，一般会经过以下几个步骤：

　　　　1.用aapt命令生成R.java文件

　　　　2.用aidl命令生成相应java文件

　　　　3.用javac命令编译java源文件生成class文件

　　　　4.用dx.bat将class文件转换成classes.dex文件

　　　　5.用aapt命令生成资源包文件resources.ap_

　　　　6.用apkbuilder.bat打包资源和classes.dex文件,生成unsigned.apk

　　　　7.用jarsinger命令对apk认证,生成signed.apk

 　　

 

二、Ant的下载安装

　　1、下载：

　　　　从阿帕奇的Ant官网（http://ant.apache.org/ ）中，找到download，下载apache-ant-1.9.4-bin.zip。(这里使用的ant不是sdk自带的ant)。

　　2、安装及环境变量配置：

　　　　1) 解压Ant，比如解压到D:\software\apache-ant-1.9.4

　　　　2)我的电脑->属性->高级->环境变量

　　　　3) 系统变量新建ANT_HOME，变量值为D:\software\apache-ant-1.9.4

　　　　4)系统变量新建或修改path，变量值为%ANT_HOME%\bin

　　　　安装好环境变量后，在控制台输入cmd，回车后输入ant -version，如果安装成功会出现相应的ant版本号。

　　　　

 

 

三、下载支持文件：

　　一、下载ant-contrib-1.0b3：

　　　　点击链接下载ant-contrib-1.0b3.jar。下载解压后将文件：ant-contrib-1.0b3.jar放入刚安装的ant目录下的bin文件夹中。(也可自行网上下载，然后放入bin目录下)。

　　二、下载apkbuilder.bat:

　　　　点击链接下载apkbuilder.bat。下载解压后将文件：apkbuilder.bat放入Android的sdk目录下的tools文件夹中。(也可网上自行下载，然后放入tools目录中)。

 

四、签名文件的生成：

　　1）输入cmd，打开控制台后，进入安装的jdk的bin下。如：cd D:\software\Java\jdk1.7.0_71\bin。

　　2）输入命令：keytool -genkey -v -keystore volley.keystore -alias app -keyalg RSA -validity 20000

　　　　解释：

　　　　　　-keystore 后面跟的是要生成的签名文件的名称。这里是volley.keystore

　　　　　　-alias 后面跟的是签名文件的别名。这里是app
　　　　　　-keyalg 是加密方式。这里是RSA
　　　　　　-validity 是有效期。这里是20000
　　3）回车后，需要连续两次输入密钥库口令。这个口令就是签名文件的密钥的密码。要记住这个密码，待会会用到。(这里我用的是654321)

　　4）接下来根据提示输入一些基本信息，然后回复y。就会自动生成签名文件。

　　5）接下来会提示输入别名的密钥口令。可以直接回车，与签名文件的密钥库口令一样，也可以再输入一个密码。这个密码也要记住，待会会用到(这里我用的是123456)

　　6）这样就生成好了签名文件，签名文件在jdk的bin目录下。(我这里是volley.keystore)。

　　

 

 

五、在工程中生成build.xml文件：

　　1）工程目录结构：

　　直接在工程目录中新建build.xml文件。

　　

　　2）将jdk中bin目录下刚生成的签名文件volley.keystore放入工程目录中。

　　3）编辑build.xml文件

<project name="Test" default="release" basedir=".">
    <!-- 环境变量 -->
    <property environment="env" />
    <!-- 使用第三方的ant包，使ant支持for循环-->
    <taskdef resource="net/sf/antcontrib/antcontrib.properties">
        <classpath>
            <!-- 修改一：将ant下的路径改为绝对路径。也可以用"${env.ANT_HOME}/lib/ant-contrib-1.0b3.jar"，不过我在这里老是找不到，所以就用绝对路径了 -->
            <pathelement location="D:/software/apache-ant-1.9.4/lib/ant-contrib-1.0b3.jar" />
        </classpath>
    </taskdef>
    <!-- 应用名称 -->
    <property name="appName" value="${ant.project.name}" />
    <!--  修改二：SDK目录的路径 ，也可以用"${env.ANDROID_SDK_HOME}"，不过我还是找不到，也改成绝对路径了-->
    <property name="sdk-folder" value="D:\software\SDK-20140702\sdk" />
    <!-- 修改三：SDK指定平台目录为platforms/android-20-->
    <property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-20" />
    <!-- SDK中tools目录 -->
    <property name="sdk-tools" value="${sdk-folder}/tools" />
    <!-- SDK指定平台中tools目录 -->
    <property name="sdk-platform-tools" value="${sdk-folder}/platform-tools" />
    
    <!-- 修改四：SDK指定平台中build-tools目录为 build-tools/android-4.4W-->
    <property name="sdk-build-tools" value="${sdk-folder}/build-tools/android-4.4W" />

    <!-- 使用到的命令(当前系统为windows,如果系统为linux,可将.bat文件替换成相对应的命令) -->
    <property name="aapt" value="${sdk-build-tools}/aapt" />
    <property name="aidl" value="${sdk-build-tools}/aidl" />
    <property name="dx" value="${sdk-build-tools}/dx.bat" />
    <!-- 修改五：将下载好的apkbuilder.bat文件放入${sdk-folder}/tools目录下 -->
    <property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />
    <!-- 修改六：如果报错，就将jdk的路径改为绝对路径 -->
    <property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />
    <property name="zipalign" value="${sdk-build-tools}/zipalign.exe" />

    <!-- 编译需要的jar; 如果项目使用到地图服务则需要maps.jar -->
    <property name="android-jar" value="${sdk-platform-folder}/android.jar" />
    <property name="android-maps-jar" value="${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar" />

    <!--渠道 -->
    <property name="channelname" value="" />
    <property name="channelkey" value="" />
    <!-- 渠道名:渠道号 -->
    <property name="key" value="UM:aaaaaa,BAI:bbbb" />
    
    <!-- 编译aidl文件所需的预处理框架文件framework.aidl -->
    <property name="framework-aidl" value="${sdk-platform-folder}/framework.aidl" />
    <!-- 清单文件 -->
    <property name="manifest-xml" value="AndroidManifest.xml" />
    <!-- 源文件目录 -->
    <property name="resource-dir" value="res" />
    <property name="asset-dir" value="assets" />
    <!-- java源文件目录 -->
    <property name="srcdir" value="src" />
    <property name="srcdir-ospath" value="${basedir}/${srcdir}" />
    
    <!-- 外部类库所在目录 -->
    <property name="external-lib" value="libs" />
    <property name="external-lib-ospath" value="${basedir}/${external-lib}" />

    <!-- 修改七：修改版本号 -->
    <property name="version" value="1.0" />
    
    <!--循环打包 -->
        <target name="deploy">
            <foreach target="modify_manifest" list="${key}" param="nameandchannel" delimiter=",">
            </foreach>
        </target>
        <target name="modify_manifest">
            <!-- 获取渠道名字 -->
            <propertyregex override="true" property="channelname" input="${nameandchannel}" regexp="(.*):" select="\1" />
            <!-- 获取渠道号码 -->
            <propertyregex override="true" property="channelkey" input="${nameandchannel}" regexp=":(.*)" select="\1" />
            <!-- 正则匹配替换渠道号 -->
            <replaceregexp flags="g" byline="false" encoding="UTF-8">
                <regexp pattern='meta-data android:value="(.*)" android:name="app_key"' />
                <substitution expression='meta-data android:value="${channelkey}" android:name="app_key"' />
                <fileset dir="" includes="AndroidManifest.xml" />
            </replaceregexp>
            <antcall target="zipalign" />
        </target>
    
    <!-- 初始化工作 -->
    <target name="init">
        <echo>目录初始化....</echo>
        <!-- 生成R文件的相对目录 -->
        <var name="outdir-gen" value="gen" />
        <!-- 编译后的文件放置目录 -->
        <var name="outdir-bin" value="bin-${channelname}" />
        <!-- 生成class目录 -->
        <var name="outdir-classes" value="${outdir-bin}" />
        <var name="outdir-classes-ospath" value="${basedir}/${outdir-classes}" />

        <!-- classes.dex相关变量 -->
        <var name="dex-file" value="classes.dex" />
        <var name="dex-path" value="${outdir-bin}/${dex-file}" />
        <var name="dex-ospath" value="${basedir}/${dex-path}" />

        <!-- 经过aapt生成的资源包文件 -->
        <var name="resources-package" value="${outdir-bin}/resources.ap_" />
        <var name="resources-package-ospath" value="${basedir}/${resources-package}" />

        <!-- 未认证apk包 -->
        <var name="out-unsigned-package" value="${outdir-bin}/${appName}-unsigned.apk" />
        <var name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" />

        <!-- 修改八：修改对应的签名文件的文件名 -->
        <var name="keystore-file" value="${basedir}/volley.keystore" />

        <!-- 已认证apk包 -->
        <var name="out-signed-package" value="${outdir-bin}/${appName}-${channelname}-${version}.apk" />
        <var name="out-signed-package-ospath" value="${basedir}/${out-signed-package}" />
        <delete dir="${outdir-bin}" />
        <mkdir dir="${outdir-bin}" />
        <mkdir dir="${outdir-classes}" />
    </target>

    <!-- 根据工程中的资源文件生成R.java文件  -->
    <target name="gen-R" depends="init">
        <echo>生成R.java文件....</echo>
        <exec executable="${aapt}" failonerror="true">
            <arg value="package" />
            <arg value="-f" />
            <arg value="-m" />
            <arg value="-J" />
            <arg value="${outdir-gen}" />
            <arg value="-S" />
            <arg value="${resource-dir}" />
            <arg value="-M" />
            <arg value="${manifest-xml}" />
            <arg value="-I" />
            <arg value="${android-jar}" />
        </exec>
    </target>

    <!-- 编译aidl文件 -->
    <target name="aidl" depends="gen-R">
        <echo>编译aidl文件....</echo>
        <apply executable="${aidl}" failonerror="true">
            <!-- 指定预处理文件 -->
            <arg value="-p${framework-aidl}" />
            <!-- aidl声明的目录 -->
            <arg value="-I${srcdir}" />
            <!-- 目标文件目录 -->
            <arg value="-o${outdir-gen}" />
            <!-- 指定哪些文件需要编译 -->
            <fileset dir="${srcdir}">
                <include name="**/*.aidl" />
            </fileset>
        </apply>
    </target>

    <!-- 将工程中的java源文件编译成class文件 -->
    <target name="compile" depends="aidl">
        <echo>java源文件编译成class文件....</echo>
        <javac encoding="utf-8" target="1.5" srcdir="." destdir="${outdir-classes}" bootclasspath="${android-jar}" verbose="false">
            <compilerarg line="-encoding GBK " />
            <classpath>
                <fileset dir="${external-lib}" includes="*.jar" />
            </classpath>
        </javac>
    </target>


    <!-- 将.class文件转化成.dex文件 -->
    <target name="dex" depends="compile">
        <echo>将.class文件转化成.dex文件....</echo>
        <exec executable="${dx}" failonerror="true">
            <arg value="--dex" />
            <!-- 输出文件 -->
            <arg value="--output=${dex-ospath}" />
            <!-- 要生成.dex文件的源classes和libraries -->
            <arg value="${outdir-classes-ospath}" />
            <arg value="${external-lib-ospath}" />
        </exec>
    </target>

    <!-- 将资源文件放进输出目录 -->
    <target name="package-res-and-assets">
        <echo>将资源文件放进输出目录....</echo>
        <exec executable="${aapt}" failonerror="true">
            <arg value="package" />
            <arg value="-f" />
            <arg value="-M" />
            <arg value="${manifest-xml}" />
            <arg value="-S" />
            <arg value="${resource-dir}" />
            <arg value="-A" />
            <arg value="${asset-dir}" />
            <arg value="-I" />
            <arg value="${android-jar}" />
            <arg value="-F" />
            <arg value="${resources-package}" />
        </exec>
    </target>

    <!-- 打包成未签证的apk -->
    <target name="package" depends="dex, package-res-and-assets">
        <echo>打包成未签证的apk....</echo>
        <exec executable="${apkbuilder}" failonerror="true">
            <arg value="${out-unsigned-package-ospath}" />
            <arg value="-u" />
            <arg value="-z" />
            <arg value="${resources-package-ospath}" />
            <arg value="-f" />
            <arg value="${dex-ospath}" />
            <arg value="-rf" />
            <arg value="${srcdir-ospath}" />
        </exec>
    </target>

    <!-- 对apk进行签证 -->
    <target name="jarsigner" depends="package">
        <echo>Packaging signed apk for release...</echo>
        <exec executable="${jarsigner}" failonerror="true">
            <!-- 修改九：如果JDK大于7，需要将下面五行代码保留，如果是6，就可以不需要(保留应该也没问题吧，还没试)，否则，最终的APK安装会出现“该文件签名有问题，无法安装” -->
            <arg value="-verbose" />
            <arg value="-digestalg" />
            <arg value="SHA1" />
            <arg value="-sigalg" />
            <arg value="MD5withRSA" />
            
            
            <arg value="-keystore" />
            <arg value="${keystore-file}" />
            <arg value="-storepass" />
            <!-- 修改十：以下密码替换成你签名文件密钥的密码 -->
            <arg value="654321" />
            <arg value="-keypass" />
            <!-- 修改十一：以下密码替换成你签名文件别名的密码 -->
            <arg value="123456" />
            <arg value="-signedjar" />
            <arg value="${out-signed-package-ospath}" />
            <arg value="${out-unsigned-package-ospath}" />
            <!-- 修改十二：签名文件的别名 -->
            <arg value="app" />
        </exec>
    </target>

    <!-- 发布 -->
    <target name="release" depends="jarsigner">
        <!-- 删除未签证apk -->
        <delete file="${out-unsigned-package-ospath}" />
        <echo>APK is released. path:${out-signed-package-ospath}</echo>
    </target>
    <!-- 打包的应用程序进行优化 -->
    
    <target name="zipalign" depends="release">
        <exec executable="${zipalign}" failonerror="true">
            <arg value="-v" />
            <arg value="4" />
            <arg value="${out-signed-package-ospath}" />
            <arg value="${out-signed-package-ospath}-zipaligned.apk" />
        </exec>
    </target>
</project>

　　详解：

　　 修改一：将ant下的路径改为绝对路径。也可以用"${env.ANT_HOME}/lib/ant-contrib-1.0b3.jar"，不过我在这里老是找不到，所以就用绝对路径了。(这里使用ANT_HOME，前提是在环境变量中有做相应的配置)

<taskdef resource="net/sf/antcontrib/antcontrib.properties">
        <classpath>
            <!-- 修改一：将ant下的路径改为绝对路径。也可以用"${env.ANT_HOME}/lib/ant-contrib-1.0b3.jar"，不过我在这里老是找不到，所以就用绝对路径了 -->
            <pathelement location="D:/software/apache-ant-1.9.4/lib/ant-contrib-1.0b3.jar" />
        </classpath>
    </taskdef>

　　修改二：SDK目录的路径 ，也可以用"${env.ANDROID_SDK_HOME}"，不过我还是找不到，也改成绝对路径了。(这里使用ANDROID_SDK_HOME，前提是在环境变量中有做相应的配置)

<property name="sdk-folder" value="D:\software\SDK-20140702\sdk" />

　　修改三：SDK指定平台目录为platforms/android-20

<property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-20" />

　 修改四：SDK指定平台中build-tools目录为 build-tools/android-4.4W

<property name="sdk-build-tools" value="${sdk-folder}/build-tools/android-4.4W" />

　　修改五：将下载好的apkbuilder.bat文件放入${sdk-folder}/tools目录下

<property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />

　　修改六：如果报错，就将jdk的路径改为绝对路径

<property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />

　　修改七：修改版本号

<property name="version" value="1.0" />

　　修改八：修改对应的签名文件的文件名

<var name="keystore-file" value="${basedir}/volley.keystore" />

　　修改九：如果JDK大于7，需要将下面五行代码保留，如果是6，就可以不需要(保留应该也没问题吧，还没试)，否则，最终的APK安装会出现“该文件签名有问题，无法安装”

　 修改十：以下密码替换成你签名文件密钥的密码

　 修改十一：以下密码替换成你签名文件别名的密码

　 修改十二：签名文件的别名

<!-- 对apk进行签证 -->
    <target name="jarsigner" depends="package">
        <echo>Packaging signed apk for release...</echo>
        <exec executable="${jarsigner}" failonerror="true">
            <!-- 修改九：如果JDK大于7，需要将下面五行代码保留，如果是6，就可以不需要(保留应该也没问题吧，还没试)，否则，最终的APK安装会出现“该文件签名有问题，无法安装” -->
            <arg value="-verbose" />
            <arg value="-digestalg" />
            <arg value="SHA1" />
            <arg value="-sigalg" />
            <arg value="MD5withRSA" />
            
            
            <arg value="-keystore" />
            <arg value="${keystore-file}" />
            <arg value="-storepass" />
            <!-- 修改十：以下密码替换成你签名文件密钥的密码 -->
            <arg value="654321" />
            <arg value="-keypass" />
            <!-- 修改十一：以下密码替换成你签名文件别名的密码 -->
            <arg value="123456" />
            <arg value="-signedjar" />
            <arg value="${out-signed-package-ospath}" />
            <arg value="${out-unsigned-package-ospath}" />
            <!-- 修改十二：签名文件的别名 -->
            <arg value="app" />
        </exec>
    </target>

　　

　　 循环打包：

　　1）在这句话里面循环：

 

　　　　<target name="deploy">
            <foreach target="modify_manifest" list="${key}" param="nameandchannel" delimiter=",">
            </foreach>
        </target>

 

　　2）在modify_manifest里，将 ${key}对应的值（也就是前面定义的<property name="key" value="UM:aaaaaa,BAI:bbbb" />） 按照delimiter="," 来分隔，进行分别打包。

<target name="modify_manifest">
            <!-- 获取渠道名字 -->
            <propertyregex override="true" property="channelname" input="${nameandchannel}" regexp="(.*):" select="\1" />
            <!-- 获取渠道号码 -->
            <propertyregex override="true" property="channelkey" input="${nameandchannel}" regexp=":(.*)" select="\1" />
            <!-- 正则匹配替换渠道号 -->
            <replaceregexp flags="g" byline="false" encoding="UTF-8">
                <regexp pattern='meta-data android:value="(.*)" android:name="app_key"' />
                <substitution expression='meta-data android:value="${channelkey}" android:name="app_key"' />
                <fileset dir="" includes="AndroidManifest.xml" />
            </replaceregexp>
            <antcall target="zipalign" />
        </target>

 

六、运行：

　　1）打开ant

 

　　2）选中deploy，去掉选中release[default]，点击运行

 

　　

　　提示：Android官网下载的adt连带Eclipse和sdk。查看过sdk后发现有ant插件，但是在eclipse中的showview没有相应的插件界面。所以我就下载了一个纯版的Eclipse再安装sdk，这样就有ant插件了，不知道有没有更好的方法，看起来这样解决笨笨的。

 

七、常见异常：

　　1）ant的路径配置不对

　　2）sdk路径配置不对

 

　　完