android Ant 批量多渠道打包 總結!
最近研究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能輕鬆解決這個問題
另外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}" 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"> <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}" 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>
具體操作:
首先,定義渠道名字和號碼的固定格式為 渠道名字:渠道號 這樣可以利用:做一個正則匹配分別獲取渠道名字和渠道號,好處是最後能根據渠道名字來修改打出來的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 吧!
就寫到這裡吧!!希望對大家有些幫助!!謝謝!!
不明白的隨時留言!!!祝好!
PS:對於apk的混淆,這裡附加加介紹!--->點這裡跳轉