目前国内的安卓渠道有几百家,我们要根据不同的渠道打不同渠道的apk来统计每个渠道带来的用户数,统计每个渠道用户的存活率和活跃度等等信息,但是手动对每个渠道的APK进行签名打包实在是让人感到厌烦且低效,这时我们需要一个全自动化的打包工具----ant。Android SDK的tools中已经包括了ant的打包工具,那么我们该如何运用它达到我们的要求呢?之前卤煮做这块的时候也参考了很多前辈的文章,首先向前辈们致敬,下面说下卤煮的方法,有什么不对的地方或者疑问欢迎大家留言交流。(以下步骤均在MAC系统下完成)
一.打包前准备工作
1.首先确定你的JDK版本为1.6!
2.在AndroidManifest.xml中application标签下添加一个用来识别渠道的标签:
- <meta-data android:name="qudao" android:value="channel" />
3.为了让ant支持循环功能,我们要在Android SDK/tools/lib下放一个ant-contrib-1.0b3.jar包
4.项目中放置第三方jar包的文件夹必须叫libs而不是lib
二.build.xml等文件的生成和配置
1.通过终端(cmd)命令自动生成build.xml和local.properties两个文件,方法如下:
- <sdk>/tools/android update project -p <project> -t <target>
例如:
- /Users/moushou/Downloads/AndroidSDK/tools/android update project -p /Users/moushou/Documents/workspace/HelloWorld -t 14
其中<sdk>为SDK全路径,<project>为项目全路径,<target>为API版本。
执行完成截图如下:
执行完成后,Refresh你的项目就会发现项目的根目录下多了两个文件:build.xml和local.properties
其中local.properties的内容是:
- # This file is automatically generated by Android Tools.
- # Do not modify this file -- YOUR CHANGES WILL BE ERASED!
- #
- # This file must *NOT* be checked into Version Control Systems,
- # as it contains information specific to your local configuration.
- # location of the SDK. This is only used by Ant
- # For customization when using a Version Control System, please read the
- # header note.
- sdk.dir=/Users/moushou/Downloads/AndroidSDK
project.properties的内容如下:
- # This file is automatically generated by Android Tools.
- # Do not modify this file -- YOUR CHANGES WILL BE ERASED!
- #
- # This file must be checked in Version Control Systems.
- #
- # To customize properties used by the Ant build system use,
- # "ant.properties", and override values to adapt the script to your
- # project structure.
- #proguard.config=proguard.cfg
- # Project target.
- target=Google Inc.:Google APIs:14
- proguard.config=proguard.cfg
项目的目录结构如下图所示:
注:project.properties中target=GoogleInc.:GoogleAPIs:14代表所使用的SDK的版本,可进行手动修改。
2.手动为项目新建一个File,该文件名为:ant.properties,创建完成项目的目录结构如下图:
创建完成后在ant.properties中添加如下内容:
- key.store=<keystore>
- key.alias=<key>
- key.store.password=<keystore pwd>
- key.alias.password=<key pwd>
- market_channels=xx,yy,zz
- app_version=1_0_build_0
例如:
- key.store=/Users/moushou/Desktop/qianming
- key.alias=meilihuaduo
- key.store.password=123456xx
- key.alias.password=123456xx
- market_channels=anzhuoshichang,jifengshichang,baiduyingyongzhongxin
- app_version=1_0_build_0
其中:
keystore为签名文件的全路径。
key.alias为签名需要使用的私钥。
key.store.password为私钥库的密码。
key.alias.password为私钥的密码。
market_channels为渠道集合。
app_version为apk的版本(此字段可根据自己喜好编写)。
三.下面我来说下build.xml的编写方法:
1.修改build.xml的第二行,修改方法如下:
- <project name="HelloWorld" default="release">
其中name为你项目的名称,default设置为release。
2.循环替换AndroidManifest.xml中qudao的value值并进行自动签名打包,方法如下:
- <import file="${sdk.dir}/tools/ant/build.xml" />
- <property name="out.unaligned.dir" value="/Users/moushou/Desktop/HelloWorld_${app_version}/" />
- <mkdir dir="${out.unaligned.dir}" />
- <target name="modify_update_file">
- <echo>*********************** make channel ${channel}</echo>
- <replaceregexp file="AndroidManifest.xml"
- match='channel'
- replace='${channel}'
- byline="false"
- encoding="utf-8"
- />
- <property name="out.unaligned.file" location="${out.unaligned.dir}/HelloWorld_${app_version}_${channel}_android.apk"/>
- </target>
- <target name="make_one_channels" depends="savemanifest,modify_update_file,release,replacemanifest,deletebin" description="description">
- </target>
- <target name="replacemanifest">
- <echo>*********************** replacemanifest</echo>
- <delete file="${basedir}\AndroidManifest.xml"/>
- <copy file="..\temp\build\META-INF\AndroidManifest.xml" todir="${basedir}" encoding="utf-8"/>
- </target>
- <target name="savemanifest">
- <echo>*********************** savemanifest</echo>
- <copy file="${basedir}\AndroidManifest.xml" todir="..\temp\build\META-INF" encoding="utf-8" />
- </target>
- <target name="deletebin">
- <delete dir="${basedir}\bin" />
- </target>
- <taskdef name="foreach" classname="net.sf.antcontrib.logic.ForEach" classpath="/Users/moushou/Downloads/AndroidSDK/tools/lib/ant-contrib-1.0b3.jar" />
- <target name="make_channels">
- <foreach target="make_one_channels" list="${market_channels}" delimiter="," param="channel">
- </foreach>
- </target>
其中:
1.out.unaligned.dir的value值为apk输出文件夹的绝对路径,文件夹采用HelloWorld结合app_version命名,app_version为ant.properties中的app_version
2.out.unaligned.file的location为apk最终的输出路径,apk命名采用HelloWorld加app_version加当前的channel加android方式
3.说一下打包的过程:
(1)第36行make_channels的target是ant的入口,该target中使用foreach循环调用名为make_one_channels的target(第17行)并把market_channels集合中的每个值替换给channel
(2)make_one_channels的target指定了每次打包的过程:
savemanifest:打包前先将原始的AndroidManifest.xml复制到与项目同一层级目录下的temp下build下META-INF中
modify_update_file:匹配到AndroidManifest.xml中的channel并将其替换
release:自动编译加签名
replacemanifest:删除AndroidManifest.xml,将temp/build/META-INF中的原始AndroidManifest.xml复制回项目根目录下
deletebin:删除bin文件(注:这步很重要,否则只能打出一个渠道的APK,当时做这块的时候碰到的问题)
4.第35行taskdef标签下的classpath是ant-contrib-1.0b3.jar的绝对路径
四.打包方法的使用
打开终端(cmd),执行:
- cd /Users/moushou/Documents/workspace/HelloWorld
然后执行:
- ant make_channels
此时,打包就开始进行啦!当出现BUILD SUCCESSFUL代表打包成功!如下图所示:
此时你会发现你输出的文件夹中多了三个APK,如下图:
注:1.每次打包前一定要删除掉temp/build/META-INF中的AndroidManifest.xml,特别是在给不同项目做打包时
2.打包前请检查AndroidManifest.xml中qudao的value值是否为channel,特别是打包失败后再次重新打包的时候一定要将value值改为channel
3.如果打包时出现Cannot recover key错误导致BUILD FAILD的话,请检查ant.properties中
key.alias.password的值后面是否有多余的空格!有的话请把空格删除掉!
五.在代码中获取渠道值,方法如下:
- public static String getAppChannel(Context context) {
- String channel = "dudao";
- try {
- ApplicationInfo appInfo = context.getPackageManager()
- .getApplicationInfo(context.getPackageName(),
- PackageManager.GET_META_DATA);
- channel = appInfo.metaData.getString("dudao");
- } catch (NameNotFoundException e) {
- e.printStackTrace();
- }
- return channel;
- }
相关代码注解:
<?xml version="1.0" encoding="UTF-8"?> <project name="custom_rules" > <!-- 声明ant loop ,这里直接用ant的循环功能,批处理什么的又要多写代码,而且我也不熟 --> <taskdef resource="net/sf/antcontrib/antcontrib.properties" > <classpath> <pathelement location="lib/ant-contrib-1.0b3.jar" /> </classpath> </taskdef> <!-- 这里相当于一个方法把,(表示ant不会,只能看懂= =) ,以后可以用命令行 ant deploy 来表示批量打包 --> <!-- ${market_channels} 要在local.properties里声明,并用,来分隔你要打包的channel名 --> <!-- 比如我的local.properties里是这样写的 market_channels=Google,Gfan,AnZhi,MuMayi --> <target name="deploy" > <foreach delimiter="," list="${market_channels}" param="channel" target="modify_manifest" > </foreach> </target> <!-- 修改manifest.xml里的渠道名,如果你要改其他文件,举一反三把 --> <!-- regexp pattern是正则匹配,这里双引号要用"而不是\ --> <!-- substitution expression 是你要替换的的channel名--> <!-- 打包完毕后要把apk移动到一个指定的目录把,你可以在sdk/tools/ant/build.xml搜下out.final.file这个property在哪用到的--> <!-- <property name="out.final.file" location="${apk.dir}/XXX_${channel}.apk" /> ${apk.dir}表示你要指定的apk目录 XXX表示你要定义apk名和${channel}渠道号--> <!-- <antcall target="clean" /> <antcall target="release" /> release之前要调下clean,不然以后改的channel名不生效,你懂得--> <target name="modify_manifest" > <replaceregexp flags="g" byline="false"> <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}/XXX_${channel}.apk" /> <antcall target="clean" /> <antcall target="release" /> </target> </project>