yiwai 发表于 2017-1-11 11:07:21

使用Apache Ant及SVN进行自动化构建

详见我的博客:http://www.zawaliang.com/2013/04/319.html
 

在团队里,一个项目通常对应多个开发人员,基于对性能优化的考虑,上线前往往需要对js、css等资源进行压缩、合并、修改时间戳,然后再按团队规范提交SVN,最后由SVN导出增量zip发布包进行发布。

传统的做法可能需要手工对一个个修改过的文件进行YUI压缩,然后更新相应的时间戳,最后根据SVN log提取文件打包。

既然工作流程都是基本固化的,作为懒人,就需要省时省力点的做法。

Apache Ant,一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具。没有了解过的同学自己Google学习,下面我就以一个Demo为例,给大家介绍下Ant的大部分常用功能,并达到自动压缩、合并、SVN提交、生成增量zip包的目的。

 

Demo

假设我们的目录架构如下,html5为根目录,app里放了一个lottery的应用,app.json.tpl为统一的版本号文件,build.xml为Ant的入口文件;res为资源目录,里面也放了lottery的资源文件。
我们现在需要把每个xx.js压缩为xx.min.js,xx.css压缩为xx_min.css,并将更改版本号应用到app.json文件里。

html5/---
|---app/
|---lottery/
|---a/
|---a.html
|---b/
|---b.html
|---index.html
|---app.json
|---app.json.tpl
|---build.xml
|---res/
|---app/
|---lottery/
|---css/
|---global/
|---global.css
|---index/
|---index.css
|---js/
|---common/
|---zepto.js
|---touch.js
|---app.js
|---index/
|---index.js
 

第三方库

因需要用到SVN、xpath、for循环等功能,需要引入第三方库,点击这里下载并解压到Ant的lib目录即可。

Ant-Contrib Tasks

http://ant-contrib.sourceforge.net/tasks/tasks/index.html

 

svnant

http://subclipse.tigris.org/svnant.html

 

svnant不支持svn1.7.x版本,这里使用svnkit1.7的版本

http://svnkit.com/download.php

 

其他支持svn1.7.x的方案,未验证


[*]svnant不支持SVN1.7.X版本,所以这里使用优化过的svntask
[*]https://github.com/opticyclic/svntask
[*]svntask (功能比svnant少,但支持svn1.7.x)
[*]http://code.google.com/p/svntask/

 

build.xml

详细请参考:https://github.com/zawaliang/AntSvnDemo
下面说明一些需要注意的点:


[*]project的basedir需要定位到根目录,这也是取SVN基准地址的前提
<project name="lottery" default="build" basedir="../../" xmlns:ac="antlib:net.sf.antcontrib">
[*]基于SVN Commit Message进行提取需要根据指定的规则进行,这里以“ abcde”的格式提取,最后生成的zip包命名为“xxx_v1.0.zip”
<property name="svn.version-regexp" value=".*(\[(.+)\]).*" />
[*]app.json.tpl为版本号文件,这里需要替换的token格式为:{/html5/res/app/lottery/js/common/zepto.min.js},其中的地址为文件相对根目录的地址,这个token最终会被替换为文件校验和(MD5值)
[*]SVN日志数限制是一个经验值,由于不能指定某个revision区间,这里取的是所有日志,但限定提取的条数,这个请根据实际项目的经验值调整。
<property name="svn.log-limit" value="100" />
[*]文件压缩
<apply executable="java" verbose="true" dest="${path.build.js}" failonerror="true" parallel="false">
<fileset dir="${path.build.js}" includes="**/*.js" excludes="**/*${suffix.js}" />
<arg line="-jar" />
<arg path="${path.yuicompressor}" />
<arg line="--charset ${encode.js}" />
<arg value="--type" />
<arg value="js" />
<arg value="-o" />
<targetfile />
<mapper type="regexp" from="^(.*)\.js$" to="\1${suffix.js}"/>
</apply>
[*]文件合并
<concat encoding="${encode.js}" outputencoding="${encode.js}" destfile="${path.build.js}/common/lottery${suffix.js}">
<header trimleading="yes">${copyright.zepto}</header>
<path path="${path.build.js}/common/zepto${suffix.js}" />
<path path="${path.build.js}/common/touch${suffix.js}" />
<path path="${path.build.js}/common/app${suffix.js}" />
</concat>
[*]SVN初始化,由于写作时svnant官方还不支持svn1.7.x的版本,所以这里需要更新svnkit到1.7.9的版本方可
<target name="svn-init">
<echo level="info" message="正在初始化SVN..." />
<path id="path.svnant">
<pathelement location="${ant.library.dir}/svnant/svnant.jar" />
<pathelement location="${ant.library.dir}/svnant/svnClientAdapter.jar" />
<pathelement location="${ant.library.dir}/svnant/ganymed.jar" />
<!-- svnkit-1.7.9 支持svn1.7.x -->
<pathelement location="${ant.library.dir}/svnkit-1.7.9/svnkit-1.7.9.jar" />
<pathelement location="${ant.library.dir}/svnkit-1.7.9/svnkit-javahl16-1.7.9.jar" />
<pathelement location="${ant.library.dir}/svnkit-1.7.9/sqljet-1.1.7.jar" />
<pathelement location="${ant.library.dir}/svnkit-1.7.9/antlr-runtime-3.4.jar" />
<pathelement location="${ant.library.dir}/svnkit-1.7.9/sequence-library-1.0.2.jar" />
</path>
<typedef resource="org/tigris/subversion/svnant/svnantlib.xml" classpathref="path.svnant" />
<svnSetting id="svn.settings" svnkit="true" javahl="false" username="${svn.user}" password="${svn.password}" failonerror="true" />
</target>
[*]关于SVN基准路径的获取,基于svn内部变量来自动获取当前工作副本的svn映射路径
<ac:propertyregex property="repourl" override="true" casesensitive="true" global="true" input="${svn.info.repourl}" regexp="\\" replace="\\\\\\\\" defaultValue="${svn.info.repourl}" />
<ac:propertyregex property="repourl" override="true" casesensitive="true" global="true" input="${repourl}" regexp="\:" replace="\\\\:" defaultValue="${repourl}" />
<ac:propertyregex property="repourl" override="true" casesensitive="true" global="true" input="${repourl}" regexp="\." replace="\\\\." defaultValue="${repourl}" />
<ac:propertyregex property="svn.basedir" override="true" casesensitive="true" global="true" input="${svn.info.url}" regexp="${repourl}(.*)" select="\1" />
[*]提交新增的文件到SVN时注意不要使用fileset,否则会出现告警
<!-- 使用fileset会导致失败 http://stackoverflow.com/questions/11402891/svn-ant-add-task-with-force-option-gives-is-already-under-version-control -->
<add force="true" dir="${path.js}" />
<add force="true" dir="${path.css}" />
<add force="true" dir="${path.app}" />
[*]SVN日志解析,文件路径提取及zip包处理
<!-- 1. 查询commit message含指定版本号的节点 -->
<!-- 2. 排除Action=Deleted的目录或文件 -->
<copy property="log.paths" path="/log/logentry/paths/path[@action!='D']/text()" append="true" trim="true" propertySeparator="|" />
先提取含指定版本号的节点,同时排除action为deleted的操作。在处理zip包时,对svnlog获取到的路径再加以判断,以排除那些delete操作的文件(夹)。

<ac:var name="zip.isfile" unset="true" />
<available file="${zip.file}" type="file" property="zip.isfile" />
<ac:if>
<isset property="zip.isfile" />
<ac:then>
<ac:if>
<!-- ant build.xml不处理 -->
<equals arg1="${zip.file}" arg2="${ant.file}" />
<ac:else>
<echo level="info" message="File: ${zip.file}" />
<copy file="${zip.file}" tofile="${zip.tofile}" overwrite="true" preservelastmodified="true" />
</ac:else>
</ac:if>
</ac:then>
<ac:else>
<!-- 不存在,有可能是svn deleted的目录或文件 -->
<ac:var name="zip.isdir" unset="true" />
<available file="${zip.file}" type="dir" property="zip.isdir" />
<ac:if>
<isset property="zip.isdir" />
<ac:then>
<!-- 空目录处理 -->
<echo level="info" message="Dir: ${zip.file}" />
<mkdir dir="${zip.tofile}" />
</ac:then>
<ac:else>
<!-- 表明当前路径为svn deleted的文件或目录,不需要处理 -->
</ac:else>
</ac:if>
</ac:else>
</ac:if>

完整版请参考:https://github.com/zawaliang/AntSvnDemo
 
 
详见我的博客:http://www.zawaliang.com/2013/04/319.html
页: [1]
查看完整版本: 使用Apache Ant及SVN进行自动化构建