原創地址:http://blog.csdn.net/tl792814781/article/details/51426481
原創作者:迷途開發者的博客
最近研究Android裏用ant打多個渠道的apk包,終於搞出頭緒!!走了很多錯路,希望大家不要這樣子!!下面就是個人的幾點總結,希望對大家有幫助:
首先說的是我用的ant不是eclipse和Android SDk裏面自帶的ant,而是從這裏下載的 -- Ant官網http://ant.apache.org/ , 下載Ant,當然第一步就是安裝ant了,步驟如下:
第一步:安裝 ant ,解壓並配置環境變量
1) 解壓Ant,比如解壓到D:\ant
2) 我的電腦->屬性->高級->環境變量
3) 系統變量新建ANT_HOME,變量值爲d:\ant
4) 系統變量新建或修改path,變量值爲%ANT_HOME%\bin
大家一定要把ant配置好,否則下面的都是扯淡了,無法順利完成,測試ant是否成功,你可以在控制檯輸入Cmd 回車, ant 回車
如果出現
Buildfile: build.xml does not exist!
Build failed
恭喜你已經ant安裝完畢了!!
第二步:簡單瞭解Android打包步驟就行了,其他的都是扯淡,咱們直奔主題,打包前的準備
利用Ant批量打包的基本思想是,每次打包後自動替換渠道號,然後再次打包
從而實現多渠道打包的目的
這樣帶來了一個問題:Ant不支持循環,怎樣循環打包?
擴展包Ant-contrib能輕鬆解決這個問題
可以翻牆的同學可以到http://ant-contrib.sourceforge.net/自行下載
另外Ant-contrib的<var>標籤使用也比原來的變量方便
從而達到僅使用build.xml來實現批量打包
安裝方法:直接把ant-contrib-1.0b3.jar放到Ant的lib文件夾即可
第三步:編寫build.xml,直接上代碼!!
- <project name="Test" default="release">
- <!-- ANT環境變量 -->
- <property environment="env" />
- <!-- 使用第三方的ant包,使ant支持for循環-->
- <taskdef resource="net/sf/antcontrib/antcontrib.properties">
- <classpath>
- <pathelement location="${env.ANT_HOME}/lib/ant-contrib-1.0b3.jar" />
- </classpath>
- </taskdef>
- <!-- 應用名稱 -->
- <property name="appName" value="${ant.project.name}" />
- <!-- SDK目錄(獲取操作系統環境變量ANDROID_SDK_HOME的值) -->
- <property name="sdk-folder" value="${env.ANDROID_SDK_HOME}" />
- <!-- SDK指定平臺目錄 -->
- <property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-8" />
- <!-- SDK中tools目錄 -->
- <property name="sdk-tools" value="${sdk-folder}/tools" />
- <!-- SDK指定平臺中tools目錄 -->
- <property name="sdk-platform-tools" value="${sdk-folder}/platform-tools" />
- <!-- 使用到的命令(當前系統爲windows,如果系統爲linux,可將.bat文件替換成相對應的命令) -->
- <property name="aapt" value="${sdk-platform-tools}/aapt" />
- <property name="aidl" value="${sdk-platform-tools}/aidl" />
- <property name="dx" value="${sdk-platform-tools}/dx.bat" />
- <property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />
- <property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />
- <property name="zipalign" value="${sdk-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="3.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}/test.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}" failοnerrοr="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}" failοnerrοr="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}" failοnerrοr="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}" failοnerrοr="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}" failοnerrοr="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}" failοnerrοr="true">
- <arg value="-keystore" />
- <arg value="${keystore-file}" />
- <arg value="-storepass" />
- <arg value="123456" />
- <arg value="-keypass" />
- <arg value="123456" />
- <arg value="-signedjar" />
- <arg value="${out-signed-package-ospath}" />
- <arg value="${out-unsigned-package-ospath}" />
- <!-- 不要忘了證書的別名 -->
- <arg value="test.keystore" />
- </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}" failοnerrοr="true">
- <arg value="-v" />
- <arg value="4" />
- <arg value="${out-signed-package-ospath}" />
- <arg value="${out-signed-package-ospath}-zipaligned.apk" />
- </exec>
- </target>
- </project>
具體操作:
首先,定義渠道名字和號碼的固定格式爲 渠道名字:渠道號 這樣可以利用:做一個正則匹配分別獲取渠道名字和渠道號,好處是最後能根據渠道名字來修改打出來的jar包名字 然後利用正則替換來替換渠道號爲上面獲取的渠道號,再執行一次打包動作。
根據以上的build.xml 讀者只需要進行以下修改即可:
1.第一行的 <project name="Test" default="release"> name換成你自己的工程名字
2.SDK目錄(獲取操作系統環境變量ANDROID_SDK_HOME的值),這裏的ANDROID_SDK_HOME是你的android SDK的環境變量 因爲env.ANT_HOME 調用的就是你配置好的系統的環境變量,我的 ANDROID_SDK_HOME 爲:E:\android\android-sdk-windows-1.5_r11\android-sdk-windows-1.5_r11 記住這裏的目錄一直到你的 android SDK 裏很多子目錄爲止!因爲,舉個例子說吧 ,你也看到了在build.xml中用到了 ${sdk-folder}/platforms/android-8 這個就是指 在你定義的ANDROID_SDK_HOME對應的目錄下去找 platforms 文件夾,所以這個目錄層次很重要!!
3.<property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" /> 這句話 相信大家都知道了吧,因爲 android 編譯需要 Java編譯器支持,所以 JAVA_HOME 是定義的java的環境變量 ,我的電腦右鍵--屬性 ---高級裏的環境變量---新建環境變量---變量名:JAVA_HOME ,變量值:E:\Program Files\Java\jdk1.6.0_02
4.<!-- 渠道名:渠道號 --> <property name="key" value="UM:aaaaaa,BAI:bbbb" /> 我例子是:友盟和百度的兩個渠道的
5.<!-- 版本 --> <property name="version" value="3.0" /> 版本號
6.重點來了 循環打包:它是怎麼循環的呢? 這句話:<target name="deploy">
<foreach target="modify_manifest" list="${key}" param="nameandchannel" delimiter=",">
</foreach>
</target>
就是循環了,將 ${key}對應的值(也就是前面定義的<property name="key" value="UM:aaaaaa,BAI:bbbb" />) 按照delimiter="," 來分隔,進行分別打包,在modify_manifest裏,這樣做的:
<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>
注意:我們還得需要在 AndroidManifest.xml 中默認頂一個meta節點,因爲咱們再ant中是不斷去替換AndroidManifest.xml中的渠道號來,達到打很多包的,所以我們還必須這樣在AndroidManifest.xml中 <meta-data android:value="bbbb" android:name="app_key"></meta-data> 寫一個默認的渠道,注意 app_key 這裏是渠道號,一般無關緊要不需要改,只要改value="bbbb"值就可以了。
7.到這裏 差不多了就,但是呢很多人打包呢,感覺不對啊,呵呵因爲很多時候咱們直接運行build.xml是第一個默認運行的target不是咱們需要的,你可以仔細看看這個 build.xml的依賴關係,你就能知道了,咱們這個build.xml需要第一個運行的是 deploy的這個target,所以 需要這麼做: build.xml右鍵,run as , 這時候不是選擇運行 而是 最後那個選項: external tools configurations ,然後進去一個界面
然後接着如下圖操作:
最後一下:run 搞定!!
最後還要說的就是:不同的渠道生成不同的目錄,在同一渠道你會發現有兩個apk ,例如:一個是Test-BAI-3.0.apk , Test-BAI-3.0.apk-zipaligned.apk ,我個人認爲一個是 沒有優化的,另一個是優化過的!!用優化過的吧 也就是Test-BAI-3.0.apk-zipaligned.apk 吧!
就寫到這裏吧!!希望對大家有些幫助!!謝謝!