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路径配置不对

 

  完

posted @ 2014-12-08 17:08  sonyi  阅读(3714)  评论(0编辑  收藏  举报