使用 Ant 编译
Jul 10, 2017 10:38:44 AM
简单介绍
如果你不知道怎么从 github 上下载 Nutz 的源代码,请看从 Git 编译 一节
编译通常是个麻烦的问题,依赖关系啊,环境变量啊,等等,全是些没有技术含量的东东,但是却能搞的你非常头疼。虽然编译 Nutz 是一个相对简单的工作 — 它编译的时候不需要依赖第三方 jar 包,但是还是有一些工作要做的。
从我个人的情况来看,我经常在如下三个环境下进行 Nutz 的开发:
- 公司 - Vista
- 家 - Ubuntu
- 笔记本 - Win XP
我这三台机器由于安装的时候不同,加上我是一个比较随意的人,所有依赖库的位置均有所不同,但是我配置编译环境基本上能在5分钟搞定。写这个介绍的目的就是分享我的一些经验,帮助大家远离痛苦,选择欢乐。
Nutz 提供 Ant 编译的脚本,在 Ant 运行前,你需要配置几个环境变量,在你的命令行客户端输入 ant,查看一下你的 ant 安装没有,如果没有请先从它的官方网站下载。你还需要检查:
- Java 是否安装,Nutz 需要至少 1.6 以上版本
- servlet-api,适用 3.x 版本以上的 servlet-api,
- Log4j 在编译时需要它。 当然,运行时,我们不一定需要 Log4j
有了这些我们就可以顺利编译 Nutz 了。
我们提供了两个 ant 脚本:
- build.xml - 快速编译,只编译 nutz.jar
- build2.xml - 全面的编译 nutz 的 jar,文档,并运行单元测试,等等
build.xml - 快速编译脚本
这个是我在开发中最常用到的编译脚本,我其他的基于 Nutz 的项目在,在 Nutz 代码更新时,我就运行一下,其他的项目一刷新,就升级到这个 Jar 文件了。
在 /build 目录下你能看到 build.bat(写给 windows的)以及 build(写给 Linux)的。你可以将其拷贝到你的 PATH 目录下,以便你在控制台执行。执行前,请先打开脚本文件,修改其中的内容。因为 build.xml 需要如下环境变量:
- JAVA_HOME : 你的 JDK 安装目录,这目录下应该有 jre/lib/rt.jar
- DEPS : 第三方 jar 包存放的目录,这个目录下应该有 log4j.jar、servlet-api.jar
- OUTPUT : 成功编译后 nutz 的 jar 包的输出目录
- PROJECT_HOME : Nutz 的项目目录,这个目录下应该有 src 目录
正确的设置这些环境变量后,运行这个脚本,Nutz 的 jar 就会出现在你的输出目录中
build2.xml - 全面编译脚本
每次发布前,我们都会运行一下这个脚本,因为它要运行单元测试,所以你需要更多的依赖包
这个脚本现在只是用作内部使用,Wendal 在里面做了详细的描述,根据我的经验,只要你把需要的 jar 包都放在依赖目录下,它会正常运行的。
本页面的文字允许在知识共享 署名-相同方式共享 3.0协议和GNU自由文档许可证下修改和再使用。