使用Ant打渠道Apk包

桃扇骨 2022-09-24 06:16 295阅读 0赞

Android打包apk时，有时候需要打各种渠道包，例如 豌豆荚、华为手机市场、小米市场、360市场等，那么每一种渠道打包时，都需要配置不同的数据元，如果渠道较多，那么打包也是一个体力活。还有，我们在开发项目中，有测试环境、生产环境、备用环境等，每次打包不同的环境，可能需要修改服务器IP以及端口号，那么打包也有点麻烦。那么针对以上这两种问题，到底有没有一个合适的方案可以解决呢！答案是肯定的！我们可以采用Ant来实现对Android应用的自动打包。  
使用Ant编译打包Apk，IDE是基于Eclipse，如果你使用的是Android Studio，那么[请查看使用Gradle如何打渠道包][Gradle]。  
Ant安装以及配置  
首先需要在Ant官网下载[Ant下载链接][Ant]，下载完成后，解压到磁盘的某一个跟目录下，接着需要在环境变量中配置，

在环境变量Path中添加 ;%ANT_HOME%/bin;%ANT_HOME%/lib;其中ANT_HOME是Ant的解压目录。例如‘E:\ant\apache-ant-1.9.7-bin\apache-ant-1.9.7’

配置成功后，可以在dos中，输入命令 ‘ant -version’,如果输出结果，表示配置成功。展示一下我电脑上的结果截图，  
![输入命令后的结果截图][20160727100521806]  
Ant编译打包  
1. 创建一个Android项目。(具体操作就不多说了)  
**2. 使用Android SDK命令创建Ant的build.xml。命令‘android update project –path .’**  
具体步骤： 打开命令行工具，切换路径到项目所在的目录，然后使用 android update project –path . 命令，在当前目录下面创建build.xml文件，注意不要忘掉后面的 ‘.’，path 前面是两个‘-’。  
![运行命令后的截图][20160727102737289]  
3. 在IDE上刷新工程，可以看到项目根目录下多了build.xml以及local.properties两个文件。  
local.properties指明了我们的android SDK的目录。  
build.xml则是ant构建的脚本，里面其实大部分都是注释，这是因为生成的这个build.xml直接引用了android SDK自带的构建脚本。  
下面列举build.xml文件的标签。  
1.project标签。  
project标签是构建文件的根标签。

它有如下属性：
    name属性：项目名。
    default属性：指定project默认执行时执行的target的名称，表示默认的运行目标。
    basedir属性：指定项目的基准目录。
    description属性：项目的描述。

2.target标签。  
target可以看做是一个任务，一个项 目标签下可以有一个或多个target标签。一个target标签可以依赖其他的target标签。

它有如下属性：
    name属性：指定target元素的名称。
    depends属性：用于描述target之间的依赖关系。
    if属性：用于验证指定的属性是否存在，若不存在，所在target将不会被执行。
    unless 属性：该属性的功能与 if 属性的功能正好相反，它也用于验证指定的属性是否存在，若不存在，所在 target 将会被执行。
    description 属性：该属性是关于 target 功能的简短描述和说明。

3.property 标签  
property 用于定义变量或参数的定义。

它有如下属性：
    name属性：变量名字
    value属性：变量值

4.mkdir标签  
mkdir该标签用于创建一个目录，它有一个属性dir用来指定所创建的目录名。  
5.jar标签  
jar用来生成一个JAR文件。

常用属性有：
    dir : 表示要创建目录的路径（包含要创建的目录）。

6.javac标签  
javac该标签用于编译一个或一组java文件。

常用属性有：
    srcdir ： 表示需要编译的java文件的目标文件夹，一般是项目的src文件夹。
    destdir :   表示编译之后的class文件存放的位置，一般是build/classes。

7.java标签  
java该标签用来执行编译生成的.class文件。  
8.delete标签  
delete该标签用于对文件或目录进行删除。

PS:Ant的depends属性指定了target的执行顺序。Ant会依照depends属性中target出现顺序依次执行每个target。在执行之前，首先需要执行它所依赖的target。一个target只能被执行一次，即使有多个target依赖于它。如果没有if或unless属性，target总会被执行。

build.xml文件内容如下，有两个文件是需要用户自己手动创建的，并存放在当前项目目录下。

<?xml version="1.0" encoding="UTF-8"?>
    <project name="ant_app" default="help">
    
        
        <property file="local.properties" />
    
        
             
        <property file="ant.properties" />
    
        
        <property environment="env" />
        <condition property="sdk.dir" value="${env.ANDROID_HOME}">
            <isset property="env.ANDROID_HOME" />
        </condition>
    
        
        <loadproperties srcFile="project.properties" />
    
        
        <fail
                message="sdk.dir is missing. Make sure to generate local.properties using 'android update project' or to inject it through the ANDROID_HOME environment variable."
                unless="sdk.dir"
        />
    
        
        
        <import file="custom_rules.xml" optional="true" />
    
        
        
        
        <import file="${sdk.dir}/tools/ant/build.xml" />
    
    </project>

ant.properties文件定义一些变量例如keystore密码，apk存放目录等；而custom\_rules.xml这个文件就是用户自定义的编译规则文件。（ant.properties文件和custom\_rules.xml文件需要我们手动创建）  
ant.properties文件的内容大致如下所示，其中keystore密码和alias密码可以不指定（防泄漏），那么在命令执行的过程中会要求你输入，

#keystore文件存放目录
    key.store=E:\\me.keystore
    #keystore别名
    key.alias=me_keystore
    #keystore密码
    key.store.password=xxxxxxx
    #组织密码
    key.alias.password=xxxxxxx
    #apk.dir表示存放最终生成apk的目录
    apk.dir=./apk
    #定义项目名称
    app.name=ant_app
    #渠道号，多个渠道号用逗号分隔
    market_channels=91,360,wandoujia,baidu
    #测试环境服务器配置
    test.server.url=192.168.1.110:8080/xinxing
    #生产环境服务器配置
    rel.server.url=188.132.121.121:9000/xinxing
    #测试环境标识 给apk命名的时候用
    test.tag.name=test
    #生产环境标识 给apk命名的时候用
    release.tag.name=release
    #版本号
    version=1.2.1

ant.properties文件，我们创建好以后，其他项目是可以通用的。下面看看最复杂的、也是最难的custom\_rules.xml文件的内容，

<?xml version="1.0" encoding="UTF-8"?>
    <project name="custom_rules" >
    
        
    
        <taskdef resource="net/sf/antcontrib/antcontrib.properties" >
    
            <classpath>
                <pathelement location="${ant.ANT_HOME}/lib/ant-contrib-1.0b3.jar" />
            </classpath>
        </taskdef>
    
        
    
        <tstamp>
            <format pattern="yyyyMMddhhmm" property="pktime" unit="hour" />
        </tstamp>
        
        <property name="version" value="${test.server.url}" />
    
    
        
        <mkdir dir="${apk.dir}" >
        </mkdir>
        
    
        <target name="replace_parameter" >
    
            
    
            <replaceregexp byline="false" encoding="UTF-8" flags="g" >
                
                <regexp pattern="server>(.*)</server" />
                <substitution expression="server>${server_url}</server" />
                <fileset dir="" includes="res/xml/hostconfig.xml" />
            </replaceregexp>
        </target>
        
    
        <target name="deploytest" >
    
            
    
            <antcall target="replace_parameter" >
    
                <param name="server_url" value="${test.server.url}" />
            </antcall>
    
            <antcall target="foreach_replacechannel" >
    
                
    
                <param name="deploy_environment" value="${test.tag.name}" />
            </antcall>
        </target>
        
    
        <target name="deployrel" >
            
            <antcall target="replace_parameter" >
                <param name="server_url" value="${rel.server.url}" />
            </antcall>
    
            <antcall target="foreach_replacechannel" >
    
                
    
                <param name="deploy_environment" value="${release.tag.name}" />
            </antcall>
        </target>
    
        
    
        <target name="foreach_replacechannel" >
    
            
    
            <foreach delimiter="," list="${market_channels}" param="channel" target="modify_manifest" >
            </foreach>
        </target>
    
        <target name="modify_manifest" >
    
            <replaceregexp byline="false" encoding="UTF-8" flags="g" >
                <regexp pattern="android:value="(.*)" android:name="UMENG_CHANNEL"" />
                <substitution expression="android:value="${channel}" android:name="UMENG_CHANNEL"" />
                <fileset dir="" includes="AndroidManifest.xml" />
            </replaceregexp>
            
    
            <property name="out.final.file" location="${apk.dir}/${app.name}_${channel}_${deploy_environment}_${pktime}_${version}.apk" />
    
            <antcall target="clean" />
    
            <antcall target="release" />
        </target>
    
    </project>

以上每一段代码都有注释，相信仔细看几遍的，就会看懂。  
经过以上几部操作，我们就可以使用命令打包了。  
PS：  
1.其中hostconfig.xml是服务地址配置文件，位于‘res/xml’中，打包不同的环境时，就需要修改这个文件。  
2.可能有好几个渠道包，那么就需要循环打包，ant没有提供类似for循环这样的功能，所以，我们需要一个拓展包即ant-contrib-1.0b3.jar，[ant-contrib-1.0b3.jar][]下载后，将该jar包放到ant的lib包中即可。  
下面就是打包了！  
首先在命令行下，定位到项目所在的目录，输入打包命令‘ant deploytest’ （测试环境），等一会，提示如下截图所示，说明打包成功，  
![这里写图片描述][20160801170637747]  
在项目的工作目录下，有一个‘apk’文件夹，我们打开该文件夹，便会看到，各个渠道包了！截图如下所示：  
![ant 测试环境渠道包][ant]

我们打生产环境，输入命名‘ant deployrel’，然后在‘apk’文件夹中，各个渠道包了！截图如下所示：  
![ant 生产环境渠道包][ant 1]  
到这儿，有个疑问，打包是成功了，但是hostconfig.xml和渠道名称是不是真的和我们所配置的一致？那么我们就检验一下，反编译生成的apk,看看里面的数据。  
需要查看apk的xml文件，我们需要apktool.jar，具体操作，详见[Android安全攻防战，反编译与混淆技术完全解析][Android]  
我反编译了ant\_app\_baidu\_release\_201608010442.apk和ant\_app\_baidu\_test\_201608010421.apk，分别对比他们中的内容，截图如下所示：  
hostconfig.xml文件对比  
![hostconfig.xml文件对比][hostconfig.xml]  
AndroidManifest.xml文件对比  
![AndroidManifest.xml文件对比][AndroidManifest.xml]  
可以看出，使用ant打的包和我们的配置是一致的！  
补充：当Android项目依赖了其他项目(library)时，在使用ant 打包，需要注意，首先需要进入到library项目所在的目录，输入命令 android update lib-project -p ./ （注意是 lib-project）；  
执行完之后，你会发现第三方工程目录下多了build.xml文件和local.properties文件。然后你再执行打包命令就可以成功打包了。  
总结  
使用Android SDK命令生成来build.xml和local.properties，custom\_rules.xml和ant.properties任何项目中都可以通用。  
PS：文章参考了[windows下Android利用ant自动编译、修改配置文件、批量多渠道，打包生成apk文件][windows_Android_ant_apk]  
ant-contrib-1.0b3.jar的下载链接  
[ant-contrib-1.0b3.jar ][ant-contrib-1.0b3.jar]

[Gradle]: http://blog.csdn.net/zxw136511485/article/details/52251353
[Ant]: http://ant.apache.org/
[20160727100521806]: /images/20220719/296ed59908434c90ae0e5be207d86d05.png
[20160727102737289]: /images/20220719/d781b90bf695406984de20892d74729e.png
[ant-contrib-1.0b3.jar]: http://download.csdn.net/detail/zxw136511485/9588477
[20160801170637747]: /images/20220719/fbd2dbfdf0454d12850accec5d7dd2d1.png
[ant]: /images/20220719/90f9193ae1b743be9471f5f5f533a2e7.png
[ant 1]: /images/20220719/fde15fafd8f3496ab2b26cf6aa661f20.png
[Android]: http://blog.csdn.net/zxw136511485/article/details/51393490
[hostconfig.xml]: /images/20220719/fdfe6ea9fd934d709471ee113bab3290.png
[AndroidManifest.xml]: /images/20220719/e2d7079f9d1f4c40ba1ae7ed25c55241.png
[windows_Android_ant_apk]: http://www.cnblogs.com/ycxyyzw/p/4535459.html