android Ant 批量多渠道打包 總結!

yangxi_001發表於2014-03-18

最近研究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/自行下載,或者去我的blog裡的資源裡下載,

另外Ant-contrib的<var>標籤使用也比原來的變數方便

從而達到僅使用build.xml來實現批量打包

安裝方法:直接把ant-contrib-1.0b3.jar放到Ant的lib資料夾即可

第三步:編寫build.xml,直接上程式碼!!

  1. <project name="Test" default="release">  
  2.     <!-- ANT環境變數 -->  
  3.     <property environment="env" />  
  4.     <!-- 使用第三方的ant包,使ant支援for迴圈-->  
  5.     <taskdef resource="net/sf/antcontrib/antcontrib.properties">  
  6.         <classpath>  
  7.             <pathelement location="${env.ANT_HOME}/lib/ant-contrib-1.0b3.jar" />  
  8.         </classpath>  
  9.     </taskdef>  
  10.     <!-- 應用名稱 -->  
  11.     <property name="appName" value="${ant.project.name}" />  
  12.     <!-- SDK目錄(獲取作業系統環境變數ANDROID_SDK_HOME的值) -->  
  13.     <property name="sdk-folder" value="${env.ANDROID_SDK_HOME}" />  
  14.     <!-- SDK指定平臺目錄 -->  
  15.     <property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-8" />  
  16.     <!-- SDK中tools目錄 -->  
  17.     <property name="sdk-tools" value="${sdk-folder}/tools" />  
  18.     <!-- SDK指定平臺中tools目錄 -->  
  19.     <property name="sdk-platform-tools" value="${sdk-folder}/platform-tools" />  
  20.   
  21.     <!-- 使用到的命令(當前系統為windows,如果系統為linux,可將.bat檔案替換成相對應的命令) -->  
  22.     <property name="aapt" value="${sdk-platform-tools}/aapt" />  
  23.     <property name="aidl" value="${sdk-platform-tools}/aidl" />  
  24.     <property name="dx" value="${sdk-platform-tools}/dx.bat" />  
  25.     <property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />  
  26.     <property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />  
  27.     <property name="zipalign" value="${sdk-tools}/zipalign.exe" />  
  28.   
  29.     <!-- 編譯需要的jar; 如果專案使用到地圖服務則需要maps.jar -->  
  30.     <property name="android-jar" value="${sdk-platform-folder}/android.jar" />  
  31.     <property name="android-maps-jar" value="${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar" />  
  32.   
  33.     <!-- -->  
  34.     <property name="channelname" value="" />  
  35.     <property name="channelkey" value="" />  
  36.     <!-- 渠道名:渠道號 -->  
  37.     <property name="key" value="UM:aaaaaa,BAI:bbbb" />  
  38.       
  39.     <!-- 編譯aidl檔案所需的預處理框架檔案framework.aidl -->  
  40.     <property name="framework-aidl" value="${sdk-platform-folder}/framework.aidl" />  
  41.     <!-- 清單檔案 -->  
  42.     <property name="manifest-xml" value="AndroidManifest.xml" />  
  43.     <!-- 原始檔目錄 -->  
  44.     <property name="resource-dir" value="res" />  
  45.     <property name="asset-dir" value="assets" />  
  46.     <!-- java原始檔目錄 -->  
  47.     <property name="srcdir" value="src" />  
  48.     <property name="srcdir-ospath" value="${basedir}/${srcdir}" />  
  49.     <!-- 外部類庫所在目錄 -->  
  50.     <property name="external-lib" value="libs" />  
  51.     <property name="external-lib-ospath" value="${basedir}/${external-lib}" />  
  52.   
  53.     <!-- 版本 -->  
  54.     <property name="version" value="3.0" />  
  55.       
  56.     <!--迴圈打包 -->  
  57.         <target name="deploy">  
  58.             <foreach target="modify_manifest" list="${key}" param="nameandchannel" delimiter=",">  
  59.             </foreach>  
  60.         </target>  
  61.         <target name="modify_manifest">  
  62.             <!-- 獲取渠道名字 -->  
  63.             <propertyregex override="true" property="channelname" input="${nameandchannel}" regexp="(.*):" select="\1" />  
  64.             <!-- 獲取渠道號碼 -->  
  65.             <propertyregex override="true" property="channelkey" input="${nameandchannel}" regexp=":(.*)" select="\1" />  
  66.             <!-- 正則匹配替換渠道號 -->  
  67.             <replaceregexp flags="g" byline="false" encoding="UTF-8">  
  68.                 <regexp pattern='meta-data android:value="(.*)" android:name="app_key"' />  
  69.                 <substitution expression='meta-data android:value="${channelkey}" android:name="app_key"' />  
  70.                 <fileset dir="" includes="AndroidManifest.xml" />  
  71.             </replaceregexp>  
  72.             <antcall target="zipalign" />  
  73.         </target>  
  74.       
  75.     <!-- 初始化工作 -->  
  76.     <target name="init">  
  77.         <echo>目錄初始化....</echo>  
  78.         <!-- 生成R檔案的相對目錄 -->  
  79.         <var name="outdir-gen" value="gen" />  
  80.         <!-- 編譯後的檔案放置目錄 -->  
  81.         <var name="outdir-bin" value="bin-${channelname}" />  
  82.         <!-- 生成class目錄 -->  
  83.         <var name="outdir-classes" value="${outdir-bin}" />  
  84.         <var name="outdir-classes-ospath" value="${basedir}/${outdir-classes}" />  
  85.   
  86.         <!-- classes.dex相關變數 -->  
  87.         <var name="dex-file" value="classes.dex" />  
  88.         <var name="dex-path" value="${outdir-bin}/${dex-file}" />  
  89.         <var name="dex-ospath" value="${basedir}/${dex-path}" />  
  90.   
  91.         <!-- 經過aapt生成的資源包檔案 -->  
  92.         <var name="resources-package" value="${outdir-bin}/resources.ap_" />  
  93.         <var name="resources-package-ospath" value="${basedir}/${resources-package}" />  
  94.   
  95.         <!-- 未認證apk包 -->  
  96.         <var name="out-unsigned-package" value="${outdir-bin}/${appName}-unsigned.apk" />  
  97.         <var name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" />  
  98.   
  99.         <!-- 證照檔案 -->  
  100.         <var name="keystore-file" value="${basedir}/test.keystore" />  
  101.   
  102.         <!-- 已認證apk包 -->  
  103.         <var name="out-signed-package" value="${outdir-bin}/${appName}-${channelname}-${version}.apk" />  
  104.         <var name="out-signed-package-ospath" value="${basedir}/${out-signed-package}" />  
  105.         <delete dir="${outdir-bin}" />  
  106.         <mkdir dir="${outdir-bin}" />  
  107.         <mkdir dir="${outdir-classes}" />  
  108.     </target>  
  109.   
  110.     <!-- 根據工程中的資原始檔生成R.java檔案  -->  
  111.     <target name="gen-R" depends="init">  
  112.         <echo>生成R.java檔案....</echo>  
  113.         <exec executable="${aapt}" failonerror="true">  
  114.             <arg value="package" />  
  115.             <arg value="-f" />  
  116.             <arg value="-m" />  
  117.             <arg value="-J" />  
  118.             <arg value="${outdir-gen}" />  
  119.             <arg value="-S" />  
  120.             <arg value="${resource-dir}" />  
  121.             <arg value="-M" />  
  122.             <arg value="${manifest-xml}" />  
  123.             <arg value="-I" />  
  124.             <arg value="${android-jar}" />  
  125.         </exec>  
  126.     </target>  
  127.   
  128.     <!-- 編譯aidl檔案 -->  
  129.     <target name="aidl" depends="gen-R">  
  130.         <echo>編譯aidl檔案....</echo>  
  131.         <apply executable="${aidl}" failonerror="true">  
  132.             <!-- 指定預處理檔案 -->  
  133.             <arg value="-p${framework-aidl}" />  
  134.             <!-- aidl宣告的目錄 -->  
  135.             <arg value="-I${srcdir}" />  
  136.             <!-- 目標檔案目錄 -->  
  137.             <arg value="-o${outdir-gen}" />  
  138.             <!-- 指定哪些檔案需要編譯 -->  
  139.             <fileset dir="${srcdir}">  
  140.                 <include name="**/*.aidl" />  
  141.             </fileset>  
  142.         </apply>  
  143.     </target>  
  144.   
  145.     <!-- 將工程中的java原始檔編譯成class檔案 -->  
  146.     <target name="compile" depends="aidl">  
  147.         <echo>java原始檔編譯成class檔案....</echo>  
  148.         <javac encoding="utf-8" target="1.5" srcdir="." destdir="${outdir-classes}" bootclasspath="${android-jar}" verbose="false">  
  149.             <compilerarg line="-encoding GBK " />  
  150.             <classpath>  
  151.                 <fileset dir="${external-lib}" includes="*.jar" />  
  152.             </classpath>  
  153.         </javac>  
  154.     </target>  
  155.   
  156.   
  157.     <!-- 將.class檔案轉化成.dex檔案 -->  
  158.     <target name="dex" depends="compile">  
  159.         <echo>將.class檔案轉化成.dex檔案....</echo>  
  160.         <exec executable="${dx}" failonerror="true">  
  161.             <arg value="--dex" />  
  162.             <!-- 輸出檔案 -->  
  163.             <arg value="--output=${dex-ospath}" />  
  164.             <!-- 要生成.dex檔案的源classes和libraries -->  
  165.             <arg value="${outdir-classes-ospath}" />  
  166.             <arg value="${external-lib-ospath}" />  
  167.         </exec>  
  168.     </target>  
  169.   
  170.     <!-- 將資原始檔放進輸出目錄 -->  
  171.     <target name="package-res-and-assets">  
  172.         <echo>將資原始檔放進輸出目錄....</echo>  
  173.         <exec executable="${aapt}" failonerror="true">  
  174.             <arg value="package" />  
  175.             <arg value="-f" />  
  176.             <arg value="-M" />  
  177.             <arg value="${manifest-xml}" />  
  178.             <arg value="-S" />  
  179.             <arg value="${resource-dir}" />  
  180.             <arg value="-A" />  
  181.             <arg value="${asset-dir}" />  
  182.             <arg value="-I" />  
  183.             <arg value="${android-jar}" />  
  184.             <arg value="-F" />  
  185.             <arg value="${resources-package}" />  
  186.         </exec>  
  187.     </target>  
  188.   
  189.     <!-- 打包成未簽證的apk -->  
  190.     <target name="package" depends="dex, package-res-and-assets">  
  191.         <echo>打包成未簽證的apk....</echo>  
  192.         <exec executable="${apkbuilder}" failonerror="true">  
  193.             <arg value="${out-unsigned-package-ospath}" />  
  194.             <arg value="-u" />  
  195.             <arg value="-z" />  
  196.             <arg value="${resources-package-ospath}" />  
  197.             <arg value="-f" />  
  198.             <arg value="${dex-ospath}" />  
  199.             <arg value="-rf" />  
  200.             <arg value="${srcdir-ospath}" />  
  201.         </exec>  
  202.     </target>  
  203.   
  204.     <!-- 對apk進行簽證 -->  
  205.     <target name="jarsigner" depends="package">  
  206.         <echo>Packaging signed apk for release...</echo>  
  207.         <exec executable="${jarsigner}" failonerror="true">  
  208.             <arg value="-keystore" />  
  209.             <arg value="${keystore-file}" />  
  210.             <arg value="-storepass" />  
  211.             <arg value="123456" />  
  212.             <arg value="-keypass" />  
  213.             <arg value="123456" />  
  214.             <arg value="-signedjar" />  
  215.             <arg value="${out-signed-package-ospath}" />  
  216.             <arg value="${out-unsigned-package-ospath}" />  
  217.             <!-- 不要忘了證照的別名 -->  
  218.             <arg value="test.keystore" />  
  219.         </exec>  
  220.     </target>  
  221.   
  222.     <!-- 釋出 -->  
  223.     <target name="release" depends="jarsigner">  
  224.         <!-- 刪除未簽證apk -->  
  225.         <delete file="${out-unsigned-package-ospath}" />  
  226.         <echo>APK is released. path:${out-signed-package-ospath}</echo>  
  227.     </target>  
  228.     <!-- 打包的應用程式進行優化 -->  
  229.       
  230.     <target name="zipalign" depends="release">  
  231.         <exec executable="${zipalign}" failonerror="true">  
  232.             <arg value="-v" />  
  233.             <arg value="4" />  
  234.             <arg value="${out-signed-package-ospath}" />  
  235.             <arg value="${out-signed-package-ospath}-zipaligned.apk" />  
  236.         </exec>  
  237.     </target>  
  238. </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 吧!

 

就寫到這裡吧!!希望對大家有些幫助!!謝謝!!

相關文章