Android項目使用Ant多渠道打包(最新sdk)

參考文章:html

http://blog.csdn.net/liuhe688/article/details/6679879java

http://www.eoeandroid.com/thread-323111-1-1.htmllinux

http://yangguangfu.iteye.com/blog/723182android

http://blog.csdn.net/cen616899547/article/details/22225947express

 

1、Android使用Ant的打包流程

  使用ANT來對應用打包,通常會通過如下幾個步驟:apache

    1.用aapt命令生成R.java文件windows

    2.用aidl命令生成相應java文件api

    3.用javac命令編譯java源文件生成class文件app

    4.用dx.bat將class文件轉換成classes.dex文件框架

    5.用aapt命令生成資源包文件resources.ap_

    6.用apkbuilder.bat打包資源和classes.dex文件,生成unsigned.apk

    7.用jarsinger命令對apk認證,生成signed.apk

   

 

2、Ant的下載安裝

  一、下載:

    從阿帕奇的Ant官網(http://ant.apache.org/ )中,找到download,下載apache-ant-1.9.4-bin.zip。(這裏使用的ant不是sdk自帶的ant)。

  二、安裝及環境變量配置:

    1) 解壓Ant,好比解壓到D:\software\apache-ant-1.9.4

    2)個人電腦->屬性->高級->環境變量

    3) 系統變量新建ANT_HOME,變量值爲D:\software\apache-ant-1.9.4

    4)系統變量新建或修改path,變量值爲%ANT_HOME%\bin

    安裝好環境變量後,在控制檯輸入cmd,回車後輸入ant -version,若是安裝成功會出現相應的ant版本號。

    

 

 

3、下載支持文件:

  1、下載ant-contrib-1.0b3:

    點擊連接下載ant-contrib-1.0b3.jar。下載解壓後將文件:ant-contrib-1.0b3.jar放入剛安裝的ant目錄下的bin文件夾中。(也可自行網上下載,而後放入bin目錄下)。

  2、下載apkbuilder.bat:

    點擊連接下載apkbuilder.bat。下載解壓後將文件:apkbuilder.bat放入Android的sdk目錄下的tools文件夾中。(也可網上自行下載,而後放入tools目錄中)。

 

4、簽名文件的生成:

  1)輸入cmd,打開控制檯後,進入安裝的jdk的bin下。如:cd D:\software\Java\jdk1.7.0_71\bin。

  2)輸入命令:keytool -genkey -v -keystore volley.keystore -alias app -keyalg RSA -validity 20000

    解釋:

      -keystore 後面跟的是要生成的簽名文件的名稱。這裏是volley.keystore

      -alias 後面跟的是簽名文件的別名。這裏是app
      -keyalg 是加密方式。這裏是RSA
      -validity 是有效期。這裏是20000
  3)回車後,須要連續兩次輸入密鑰庫口令。這個口令就是簽名文件的密鑰的密碼要記住這個密碼,待會會用到。(這裏我用的是654321)

  4)接下來根據提示輸入一些基本信息,而後回覆y。就會自動生成簽名文件。

  5)接下來會提示輸入別名的密鑰口令。能夠直接回車,與簽名文件的密鑰庫口令同樣,也能夠再輸入一個密碼。這個密碼也要記住,待會會用到(這裏我用的是123456)

  6)這樣就生成好了簽名文件,簽名文件在jdk的bin目錄下。(我這裏是volley.keystore)。

  

 

 

5、在工程中生成build.xml文件:

  1)工程目錄結構:

  直接在工程目錄中新建build.xml文件。

  

  2)將jdk中bin目錄下剛生成的簽名文件volley.keystore放入工程目錄中。

  3)編輯build.xml文件

<project name="Test" default="release" basedir=".">
    <!-- 環境變量 -->
    <property environment="env" />
    <!-- 使用第三方的ant包,使ant支持for循環-->
    <taskdef resource="net/sf/antcontrib/antcontrib.properties">
        <classpath>
            <!-- 修改一:將ant下的路徑改成絕對路徑。也能夠用"${env.ANT_HOME}/lib/ant-contrib-1.0b3.jar",不過我在這裏總是找不到,因此就用絕對路徑了 -->
            <pathelement location="D:/software/apache-ant-1.9.4/lib/ant-contrib-1.0b3.jar" />
        </classpath>
    </taskdef>
    <!-- 應用名稱 -->
    <property name="appName" value="${ant.project.name}" />
    <!--  修改二:SDK目錄的路徑 ,也能夠用"${env.ANDROID_SDK_HOME}",不過我仍是找不到,也改爲絕對路徑了-->
    <property name="sdk-folder" value="D:\software\SDK-20140702\sdk" />
    <!-- 修改三:SDK指定平臺目錄爲platforms/android-20-->
    <property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-20" />
    <!-- SDK中tools目錄 -->
    <property name="sdk-tools" value="${sdk-folder}/tools" />
    <!-- SDK指定平臺中tools目錄 -->
    <property name="sdk-platform-tools" value="${sdk-folder}/platform-tools" />
    
    <!-- 修改四:SDK指定平臺中build-tools目錄爲 build-tools/android-4.4W-->
    <property name="sdk-build-tools" value="${sdk-folder}/build-tools/android-4.4W" />

    <!-- 使用到的命令(當前系統爲windows,若是系統爲linux,可將.bat文件替換成相對應的命令) -->
    <property name="aapt" value="${sdk-build-tools}/aapt" />
    <property name="aidl" value="${sdk-build-tools}/aidl" />
    <property name="dx" value="${sdk-build-tools}/dx.bat" />
    <!-- 修改五:將下載好的apkbuilder.bat文件放入${sdk-folder}/tools目錄下 -->
    <property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />
    <!-- 修改六:若是報錯,就將jdk的路徑改成絕對路徑 -->
    <property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />
    <property name="zipalign" value="${sdk-build-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="1.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}/volley.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">
            <!-- 修改九:若是JDK大於7,須要將下面五行代碼保留,若是是6,就能夠不須要(保留應該也沒問題吧,還沒試),不然,最終的APK安裝會出現「該文件簽名有問題,沒法安裝」 -->
            <arg value="-verbose" />
            <arg value="-digestalg" />
            <arg value="SHA1" />
            <arg value="-sigalg" />
            <arg value="MD5withRSA" />
            
            
            <arg value="-keystore" />
            <arg value="${keystore-file}" />
            <arg value="-storepass" />
            <!-- 修改十:如下密碼替換成你簽名文件密鑰的密碼 -->
            <arg value="654321" />
            <arg value="-keypass" />
            <!-- 修改十一:如下密碼替換成你簽名文件別名的密碼 -->
            <arg value="123456" />
            <arg value="-signedjar" />
            <arg value="${out-signed-package-ospath}" />
            <arg value="${out-unsigned-package-ospath}" />
            <!-- 修改十二:簽名文件的別名 -->
            <arg value="app" />
        </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>

  詳解:

   修改一:將ant下的路徑改成絕對路徑。也能夠用"${env.ANT_HOME}/lib/ant-contrib-1.0b3.jar",不過我在這裏總是找不到,因此就用絕對路徑了。(這裏使用ANT_HOME,前提是在環境變量中有作相應的配置)

<taskdef resource="net/sf/antcontrib/antcontrib.properties">
        <classpath>
            <!-- 修改一:將ant下的路徑改成絕對路徑。也能夠用"${env.ANT_HOME}/lib/ant-contrib-1.0b3.jar",不過我在這裏總是找不到,因此就用絕對路徑了 -->
            <pathelement location="D:/software/apache-ant-1.9.4/lib/ant-contrib-1.0b3.jar" />
        </classpath>
    </taskdef>

  修改二:SDK目錄的路徑 ,也能夠用"${env.ANDROID_SDK_HOME}",不過我仍是找不到,也改爲絕對路徑了。(這裏使用ANDROID_SDK_HOME,前提是在環境變量中有作相應的配置)

<property name="sdk-folder" value="D:\software\SDK-20140702\sdk" />

  修改三:SDK指定平臺目錄爲platforms/android-20

<property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-20" />

  修改四:SDK指定平臺中build-tools目錄爲 build-tools/android-4.4W

<property name="sdk-build-tools" value="${sdk-folder}/build-tools/android-4.4W" />

  修改五:將下載好的apkbuilder.bat文件放入${sdk-folder}/tools目錄下

<property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />

  修改六:若是報錯,就將jdk的路徑改成絕對路徑

<property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />

  修改七:修改版本號

<property name="version" value="1.0" />

  修改八:修改對應的簽名文件的文件名

<var name="keystore-file" value="${basedir}/volley.keystore" />

  修改九:若是JDK大於7,須要將下面五行代碼保留,若是是6,就能夠不須要(保留應該也沒問題吧,還沒試),不然,最終的APK安裝會出現「該文件簽名有問題,沒法安裝」

  修改十:如下密碼替換成你簽名文件密鑰的密碼

  修改十一:如下密碼替換成你簽名文件別名的密碼

  修改十二:簽名文件的別名

<!-- 對apk進行簽證 -->
    <target name="jarsigner" depends="package">
        <echo>Packaging signed apk for release...</echo>
        <exec executable="${jarsigner}" failonerror="true">
            <!-- 修改九:若是JDK大於7,須要將下面五行代碼保留,若是是6,就能夠不須要(保留應該也沒問題吧,還沒試),不然,最終的APK安裝會出現「該文件簽名有問題,沒法安裝」 -->
            <arg value="-verbose" />
            <arg value="-digestalg" />
            <arg value="SHA1" />
            <arg value="-sigalg" />
            <arg value="MD5withRSA" />
            
            
            <arg value="-keystore" />
            <arg value="${keystore-file}" />
            <arg value="-storepass" />
            <!-- 修改十:如下密碼替換成你簽名文件密鑰的密碼 -->
            <arg value="654321" />
            <arg value="-keypass" />
            <!-- 修改十一:如下密碼替換成你簽名文件別名的密碼 -->
            <arg value="123456" />
            <arg value="-signedjar" />
            <arg value="${out-signed-package-ospath}" />
            <arg value="${out-unsigned-package-ospath}" />
            <!-- 修改十二:簽名文件的別名 -->
            <arg value="app" />
        </exec>
    </target>

  

   循環打包:

  1)在這句話裏面循環:

 

    <target name="deploy">
            <foreach target="modify_manifest" list="${key}" param="nameandchannel" delimiter=",">
            </foreach>
        </target>

 

  2)在modify_manifest裏,將 ${key}對應的值(也就是前面定義的<property name="key" value="UM:aaaaaa,BAI:bbbb" />) 按照delimiter="," 來分隔,進行分別打包。

<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>

 

6、運行:

  1)打開ant

 

  2)選中deploy,去掉選中release[default],點擊運行

 

  

  提示:Android官網下載的adt連帶Eclipse和sdk。查看過sdk後發現有ant插件,可是在eclipse中的showview沒有相應的插件界面。因此我就下載了一個純版的Eclipse再安裝sdk,這樣就有ant插件了,不知道有沒有更好的方法,看起來這樣解決笨笨的。

 

7、常見異常:

  1)ant的路徑配置不對

  2)sdk路徑配置不對

 

  完

相關文章
相關標籤/搜索