怎么用jenkins+ant构建非maven项目

发布时间：2021-07-09 17:08:28 作者：chen
来源：亿速云阅读：216

# 怎么用Jenkins+Ant构建非Maven项目

## 前言

在Java项目构建领域，Maven和Gradle已成为主流工具，但仍有大量遗留项目或特定场景使用Ant作为构建工具。本文将详细介绍如何通过Jenkins集成Ant实现非Maven项目的自动化构建，涵盖环境配置、构建脚本编写、Jenkins任务设置等全流程。

## 一、环境准备

### 1.1 软件安装清单
- **Jenkins**：持续集成服务器（推荐LTS版本）
- **Java JDK**：建议JDK 8或11（需与项目兼容）
- **Ant**：1.9.x或更高版本
- **版本控制工具**：Git/SVN（根据项目实际使用）

### 1.2 环境配置步骤

#### 安装Ant
```bash
# Linux示例
wget https://downloads.apache.org/ant/binaries/apache-ant-1.10.12-bin.zip
unzip apache-ant-1.10.12-bin.zip
sudo mv apache-ant-1.10.12 /opt/ant
export ANT_HOME=/opt/ant
export PATH=$PATH:$ANT_HOME/bin

Jenkins插件安装

登录Jenkins后台
进入【Manage Jenkins】>【Manage Plugins】
安装必需插件：
- Ant Plugin
- Git plugin（如使用Git）
- Subversion Plugin（如使用SVN）

二、Ant构建脚本编写

2.1 基础build.xml示例

<project name="MyNonMavenProject" default="compile" basedir=".">
    
    <!-- 属性定义 -->
    <property name="src.dir" value="src"/>
    <property name="build.dir" value="build"/>
    <property name="classes.dir" value="${build.dir}/classes"/>
    <property name="lib.dir" value="lib"/>
    
    <!-- 初始化目录 -->
    <target name="init">
        <mkdir dir="${build.dir}"/>
        <mkdir dir="${classes.dir}"/>
    </target>
    
    <!-- 编译Java代码 -->
    <target name="compile" depends="init">
        <javac srcdir="${src.dir}" destdir="${classes.dir}" includeantruntime="false">
            <classpath>
                <fileset dir="${lib.dir}" includes="**/*.jar"/>
            </classpath>
        </javac>
    </target>
    
    <!-- 打包JAR文件 -->
    <target name="jar" depends="compile">
        <jar destfile="${build.dir}/${ant.project.name}.jar" basedir="${classes.dir}"/>
    </target>
    
    <!-- 清理构建产物 -->
    <target name="clean">
        <delete dir="${build.dir}"/>
    </target>
</project>

2.2 关键元素说明

property：定义可重用变量
target：构建任务单元，可设置依赖关系（depends）
javac：Java编译任务
jar：打包任务
classpath：管理第三方依赖库

三、Jenkins任务配置

3.1 新建自由风格项目

点击【新建Item】> 输入任务名称
选择【Freestyle project】

3.2 源码管理配置

Git仓库示例

Repository URL: https://github.com/username/project.git
Credentials: 添加Git访问凭证
Branches to build: */main

SVN仓库示例

Repository URL: https://svn.example.com/svn/project/trunk
Credentials: 添加SVN认证

3.3 构建触发器设置

定时构建：H/15 * * * *（每15分钟）
SCM轮询：H/5 * * * *（每5分钟检查代码变更）
Webhook触发（推荐）：需配置Git/SVN服务器

3.4 Ant构建配置

在【Build】部分选择【Invoke Ant】
关键参数：
- Ant Version：选择系统中配置的Ant版本
- Targets：输入要执行的Ant目标（如 clean jar）
- Build File：如使用非标准build.xml需指定路径

3.5 高级配置示例

# 使用自定义属性文件
Ant Properties: -Dconfig.file=build.properties

# 多模块构建
Targets: clean compile module1:jar module2:jar

四、构建后操作

4.1 归档构建产物

Files to archive: build/*.jar, build/reports/**/*

4.2 JUnit测试报告

<!-- build.xml中需配置JUnit任务 -->
<target name="test" depends="compile">
    <junit printsummary="yes">
        <classpath>
            <pathelement location="${classes.dir}"/>
            <fileset dir="${lib.dir}" includes="**/*.jar"/>
        </classpath>
        <formatter type="xml"/>
        <batchtest todir="${build.dir}/test-reports">
            <fileset dir="${src.dir}" includes="**/*Test.java"/>
        </batchtest>
    </junit>
</target>

Jenkins配置：

Publish JUnit test result report: build/test-reports/*.xml

4.3 邮件通知

安装Email Extension Plugin
配置SMTP服务器
设置构建失败时发送警报邮件

五、常见问题解决

5.1 类路径问题

症状：ClassNotFoundException 或 NoClassDefFoundError 解决方案： - 检查lib目录是否包含所有依赖JAR - 确认build.xml中classpath配置正确

5.2 构建超时

症状：长时间无响应后失败 解决方案： 1. 在Jenkins任务中增加超时设置：

Build Environment -> Abort the build if it's stuck

优化Ant脚本，减少不必要的任务

5.3 环境变量问题

症状：JAVA_HOME not found 解决方案： 1. 在Jenkins全局工具中配置JDK路径 2. 或在build.xml中硬编码JDK路径：

<property name="java.home" value="/usr/lib/jvm/java-11-openjdk"/>

六、最佳实践建议

版本控制：
- 将build.xml纳入代码仓库
- 为不同分支维护不同的构建配置
依赖管理：
- 使用Ivy（Ant的依赖管理工具）管理第三方库
- 或建立规范的lib目录结构
构建优化：
- 增量编译：仅编译变更文件
- 并行任务：利用Ant的parallel任务
日志管理：
- 为每个target添加<record>日志
- 在Jenkins中配置日志轮转

结语

通过Jenkins与Ant的集成，即使是传统的非Maven项目也能实现现代化持续集成。关键点在于规范的Ant脚本编写和合理的Jenkins任务配置。随着项目发展，建议逐步引入更先进的依赖管理和构建工具，但本文方案已能满足大多数传统项目的自动化构建需求。 “`

注：实际使用时可根据具体项目需求调整： 1. 修改build.xml中的路径配置 2. 补充项目特定的构建步骤（如数据库迁移） 3. 添加适合项目的质量检查工具（Checkstyle/PMD等）