zoukankan      html  css  js  c++  java
  • Andorid进阶7—— Ant自动编译打包&发布 android项目

    http://www.cnblogs.com/tt_mc/p/3891546.html

    Eclipse用起来虽然方便,但是编译打包android项目还是比较慢,尤其将应用打包发布到各个渠道时,用Eclipse手动打包各种渠道包就有点不切实际了,这时候我们用到Ant帮我们自动编译打包了。

    1  Ant自动编译打包android项目

         1.1   Ant安装

      ant的安装比较简单,下载ant压缩包  http://ant.apache.org  (最新的为1.9.3版本),下载之后将其解压到某个目录(本人解压到E:Program Filesapache-ant-1.9.3) ,然后配置环境变量(新建ANT_HOME环境变量,值为ant所在的目录,然后将ANT_HOME/bin添加到path中),如图:        

          

      打开命令行工具,输入 ant  -version ,如果出现如下结果,说明ant 安装成功。

      1.2   为Android项目生成Ant配置build.xml

      打开命令行工具,切换路径到项目所在的目录;输入命令

      android update project --name <project_name> --target <target_ID>--path <path_to_your_project>

      http://developer.android.com/tools/projects/projects-cmdline.html

      项目根目录下多了build.xml,以及local.properties两个文件。

      其中local.properties写明了我们的android SDK的目录(其实是环境变量ANDROID_HOME的值,所以如果环境变量中没有这个的,请增加)。

      build.xml则是ant构建的最重要脚本,打开一看,发现里面其实大部分都是写注释,有用的没几行,这是因为生成的这个build.xml引用了android SDK自带的构建脚本,具体目录是{sdk目录}/tools/ant/build.xml 。

       这样,项目就支持ant编译打包了,但是,有人可能会说了,我的项目有引用第三方的jar包,而且还引用了其他的android library 项目,该怎么办呢?

         1.3   android使用ant打包时,添加第三方jar包

         1.3.1  libs 库中的第三方jar包

      如果项目只是引用了第三方jar包,只要将jar包放在libs文件夹下就ok了,ant会在编译打包过程中会自动将第三方jar加进去的。但是当我们的android 项目参考了其他library项目,这时候我们最初在输入android update 命令的时候应该多一个参数 --subprojects : 

     

      你发现报错了,不要着急,这是因为那个library 还不支持ant自动编译,我们需要先让它也支持。

      进入到library项目所在的目录,输入命令 android update lib-project -p ./  (注意是 lib-project);

       再回到原项目,输入命令” android update project --name MenudrawSample -p ./ --subprojects ",这下就OK了。

          1.3.2  user library库中第三方jar包

      在Android开发中,除了通常在Eclipse中的编译方法之外,有的时候为了进行持续集成,可能还需要用ant进行自动化编译。Android SDK本身已经提供了默认的ant编译脚本,就在每个工程下的build.xml中,其中引用了SDK的编译脚本${sdk_dir}/tools/ant/build.xml 。

      通常情况下,在工程根目录下直接执行 ant debug 即可进行一次正常的build。默认的classpath会包括libs目录下的所有jar文件。但是如果工程中使用了USER LIBRARY,或者引用了外部的jar文件,那么在编译中就可能会遇到问题,因为USER LIBRARY等这些jar文件不会被自动包含在classpath中,这时就要扩展ant的path变量,把自己的jar文件加入到classpath中。

      通过察看sdk提供的build.xml编译脚本,可以发现javac使用的classpath定义如下:

    复制代码
    复制代码
    <path id="project.javac.classpath">
        <path refid="project.all.jars.path"></path>
        <path refid="tested.project.classpath"></path>
    </path>
    <javac encoding="${java.encoding}"
            source="${java.source}" target="${java.target}"
            debug="true" extdirs="" includeantruntime="false"
            destdir="${out.classes.absolute.dir}"
            bootclasspathref="project.target.class.path"
            verbose="${verbose}"
            classpathref="project.javac.classpath"
            fork="${need.javac.fork}">
        <src path="${source.absolute.dir}"></src>
        <src path="${gen.absolute.dir}"></src>
        <compilerarg line="${java.compilerargs}"></compilerarg>
    </javac>
    复制代码
    复制代码

      其中 project.all.jars.path 包含了所有的jar文件,我们可以通过在工程目录下的build.xml中重新定义这个变量来引入其他的jar文件。

      例如在我的工程中,引用了ormlite这个ORM库,为了能够在开发中使用“attach source”察看源码,该jar文件不能放在libs目录中,因为Eclipse不允许对libs目录中的jar文件“attach source”。

      因此我将此文件放到了libs/ormlite目录中,为了能够将这两个jar文件加入到classpath中,就要重新定义 project.all.jars.path 这个元素。

      基本思路是,重新定义 -pre-compile这个target,在其中重新定义 project.all.jars.path 的值。

      这段代码写在哪里呢?在每个项目的build.xml中引用了当前目录下的custom_rules.xml,那么我们就在项目根目录下创建一个custom_rules.xml,内容如下:

    复制代码
    复制代码
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="custom_rules" default="release">
    <target name="-pre-compile">
    <echo message="JARPATH=${toString:project.all.jars.path}"></echo>
    <echo message="JARPATH=${jar.libs.dir}"></echo>
        <property name="ormlite.dir" value="${jar.libs.dir}/ormlite"> </property>
        <path id="ormlite.lib">
            <path path="${toString:project.all.jars.path}"></path>
            <pathelement location="${ormlite.dir}/ormlite-android-4.41.jar"></pathelement>
             <pathelement location="${ormlite.dir}/ormlite-core-4.41.jar"></pathelement>
        </path>
        <path id="project.all.jars.path">
            <path refid="ormlite.lib"></path>
        </path>
        <echo message="JARPATH=${toString:project.all.jars.path}"></echo>
    </target>
    </project>
    复制代码
    复制代码

      http://my.oschina.net/yunfound/blog/169288

          1.4   编译打包项目

      ant debug: 生成一个测试版apk,默认使用 debug key 进行签名,生成的apk(your_project_name-debug.apk)在bin目录下。

      ant release: 生成一个未签名和未aligned的apk包, project_name-release-unsigned.ap和project_name-release-unaligned.apk 在bin目录下。


    2   签名与渠道包

      基于ant自动编译打包现有的android项目,可以在ant打包应用的时候加入签名信息以及自动打包渠道包。

         2.1  加入签名信息

      在项目的根目录下建一个ant.properties文件,输入如下内容,其中keystore密码和alias密码可以不指定(防泄漏),那么在命令执行的过程中会要求你输入。

    复制代码
    复制代码
    #keystore的路径,必须使用正斜杠  
    key.store= "E:/wp_android_sample/me.key" 
    #keystore的密码  
    #key.store.password=*****
    #alias名  
    key.alias=me
    #alias密码  
    #key.alias.password=****** 
    复制代码
    复制代码

      在项目根目录下运行 ant release 命令就会帮你生成一个经过签名和aligned的apk,生成的apk(your_project_name-release.apk)在bin目录下

         2.2   自动打包渠道包

      实现批量循环打包需要一个类似于for循环的功能,在Ant的核心包里没有相关的For循环的Task,即不支持for循环,但是ant支持第三方扩展包,以支持更多的其他功能。

      于是我们要下载相应的支持for循环的扩展包。可以使用开源的Ant-contrib包。下载地址:http://ant-contrib.sourceforge.net/  。

      下载后的解压得到的jar文件放到ant的lib目录。接下来我们就可以打包渠道包了,具体做法是:

      (1) 首先在ant.properties文件中增加属性 market_channels (渠道列表,以逗号分割),version(应用程序版本名)

    #渠道市场列表  
    market_channels=91,360,wandoujia,baidu  
    #版本号  
    version=1.2.1  

      (2)  在我们项目的build.xml中加入如下代码:

    复制代码
    复制代码
    <!-- 渠道包打包脚本  ant deploy-->    
    <taskdef resource="net/sf/antcontrib/antcontrib.properties">  
        <classpath>  
            <pathelement location="lib/ant-contrib-1.0b3.jar"/>  
        </classpath>  
    </taskdef>  
      
    <target name="deploy">  
       <foreach target="modify_manifest" list="${market_channels}" param="channel" delimiter=",">       
       </foreach>  
    </target>  
    
    <target name="modify_manifest">  
        <replaceregexp flags="g" byline="false">  
            <!-- 匹配的内容是 android:value="*****" android:name="UMENG_CHANNEL" -->  
            <regexp pattern='android:value="(.*)" android:name="UMENG_CHANNEL"' />  
            <!-- 匹配之后将其替换为 android:value="渠道名" android:name="UMENG_CHANNEL" -->  
            <substitution expression='android:value="${channel}" android:name="UMENG_CHANNEL"' /> 
            <!-- 正则表达式需要匹配的文件为AndroidManifest.xml -->  
             <fileset dir="" includes="AndroidManifest.xml" />  
        </replaceregexp>  
        <property name="out.release.file" location="${out.absolute.dir}/${ant.project.name}_${channel}.apk" />  
         <!--包 -->  
         <antcall target="release" />  
         <!--输出渠道包到bin/out目录下 -->  
        <copy tofile="${out.absolute.dir}/out/${ant.project.name}v${version}-${channel}.apk" file="bin/${ant.project.name}-release.apk"/>  
    </target>  
    复制代码
    复制代码

      在项目根目录下运行 ant deploy 命令就会帮你各个渠道的签名包了(为了全程可以自动执行,ant.properties文件中的keystore的密码可以指定,这样在执行过程中就不需要手动输入密码了),在bin目录的out目录下。

    在Eclipse中运行ant批量打包工具出错,日志信息如下:
    D:Androidandroid-sdk-windows oolsantuild.xml:601: The following error occurred while executing this line:
    D:Androidandroid-sdk-windows oolsantuild.xml:720: The following error occurred while executing this line:
    D:Androidandroid-sdk-windows oolsantuild.xml:734: Unable to find a javac compiler;
    com.sun.tools.javac.Main is not on the classpath.
    Perhaps JAVA_HOME does not point to the JDK.
    It is currently set to “D:Program FilesJavajre7″

    解决方案:

    1: Eclipse菜单 – Window – Preferences – Java – Installed JREs – 选中栏目表格中的jre项 – Edit – Add External JARs – 选择jdk目录/lib/tools.jar - 确认其加入JRE system libraries– Finish – OK

    2: ant clean

    3: ant release

    ---------------------可爱的分割线------------------------------

    一、按照上面步骤自己实现了下,在此过程中也遇到了很多问题。

    1、配置环境变量android 和 ant,这里不详做解释。

    2、如果你的项目有第三方资源包,则先切换到资源项目的路径将其转换为ant可以编译的。

      执行命令:android update lib-project -p ./

    3、切换到主项目的根目录。

      执行命令 android list target ,可以获取android编译的版本。它的id值就是-t参数后面的值。

      D:project3MiniTools>android update project -n MiniTools -t 7 -p ./ --subprojects

       -n : 项目名称,-t 编译的版本, -p 项目路径,--subprojects 指存在第三方资源项目的引用。

    4、签名文件

       

    1、不签名
        1.1、android update lib-project -p ./ //将第三方库文件编译成ant可以识别的
    
        1.2、android update project -n test -t 7 -p ./ --subprojects  --在主项目中执行
        
        1.3、ant release  --生产未签名的apk.
    2、签名,完成1的步骤,接着配置下面
        2.1、配置keystore
            #keystore的路径,必须使用正斜杠  
            key.store= "E:/wp_android_sample/me.key" 
            keystore的密码  
            key.store.password=*****
            #alias名  
            key.alias=me
            #alias密码  
            key.alias.password=****** 
            #渠道市场列表  
            market_channels=91,360,wandoujia,baidu  
            #版本号  
            version=1.2.1 
        2.2、添加渠道打包代码到build.xml
        2.3、执行ant deploy就可以生成签名的各个渠道包
    5、在CMD命令窗口输入 ant release 执行,在项目的bin目录下生产apk文件。
    6、多渠道包就按照上面的方法去做就可以,在复制多渠道包脚本到build.xml时,放到condition节点下方(之前我放到了最后,打包时有错误,之后包脚本向签名的位置放了就可以了)。
     
    二、遇到的错误及解决方法
      1、错误null returned 1
      
    BUILD FAILED
    D:Androidsdk	oolsantuild.xml:601: The following error occurred while executing this line:
    D:Androidsdk	oolsantuild.xml:653: The following error occurred while executing this line:
    D:Androidsdk	oolsantuild.xml:698: null returned: 1

       解决方法:

      1、在sdk/tools/ant/build.xml文件中找到aapt.ignore.assets,将它的值改为crunch。

      2、在自己项目的根目录下build.xml文件中加入:<property name="aapt.ignore.assets" value="!.svn:!.git:x3Cdirx3E_*:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~:crunch" />  这样子就只对自己的项目生效!为什么会有x3Cdirx3E这个东西,其实就是<dir>,不过ant build.xml中不允许使用'<'字符,所以要转义一下。

    参考

    http://my.oschina.net/bigtiger/blog/201924

    http://bbs.csdn.net/topics/380199724

      

  • 相关阅读:
    48个有用的js函数
    移除input在type="number"时的上下箭头
    Windows安装Node.js报错:2503、2502的解决方法
    module.exports与exports,export与export default之间的关系和区别
    es6中export、export default、import的理解
    javascript 的继承
    JSONP
    将本地项目托管到github 并预览
    如何在Vue2中实现组件props双向绑定
    vue2 broadcast和dispatch的理解
  • 原文地址:https://www.cnblogs.com/lbangel/p/4108927.html
Copyright © 2011-2022 走看看