《antx入门指南》由会员分享，可在线阅读，更多相关《antx入门指南（6页珍藏版）》请在金锄头文库上搜索。
1、Antx 新手入门1. Antx 希望解决的问题：a). Buildb). Repository 管理c). 面向 project 而不是 target(task)2. Antx 的安装：a). 前提：安装 JDK，并设置系统环境变量 JAVA_HOME，指向 JDK 安装目录。b). 获取 antx：svn co http:/svn.alibaba- antx，或者使用 TortoiseSVN 获取。c). build antx：执行 build.bat 或 build.sh，执行完之后，会生成 dist/antx 目录。d). 设置环境变量：设置系统环境变量 ANTX_HOME，指向生成的
2、 dist/antx 目录，并将$ANTX_HOME/bin 目录加入到 PATH 环境变量中。e). 获取第二方类库并设置其位置：svn co http:/svn.alibaba- repository.project, repository.project 默认应该放在user.home/.antx 目录下，如果你本地不是放在这个路径下，则修改 user.home 目录下antx.properties 文件，设置 antx.repository.project 属性值为本地的 repository.project 所在目录。如果你还同时希望修改其它 repository 的位置，也可以在此
3、设置。(默认情况下antx.repository.local 位于 user.home/.antx/repository 目录下，antx.repository.external 位于$ANTX_HOME/repository 目录下或者$ANTX_HOME/././repository 目录下)3. 单项目 antx 的使用：a). 创建 antx 项目：antx gen(或者使用 Antx eclipse plugin 的项目创建向导功能，有关Antx eclipse plugin 的使用，详见第 8 节) ，antx gen 创建的目录结构如下：myproject project.jel
4、ly - 项目脚本文件 project.xml - 项目描述文件docs - 文档目录src - 源代码目录java - Java 源代码目录b). 修改生成的 project.xml，修改其项目 id，添加需要的依赖库和其它构建属性，示例如下：c). 编写代码(位于 src/java 目录下)d). 在项目目录下执行 antx jar 或者 antx，输出类似如下：java:compile:mkdir Created dir: C:myprojecttargetclassesjavac Compiling 1 source file to C:myprojecttargetclassesja
5、r:jar:jar Building jar: C:myprojecttargetmy-project.jar说明：antx jar 和 antx 执行效果相同，是因为使用 antx gen 默认产生的 project.jelly 文件中指定了项目的默认目标为 jar。4. 多项目 antx 的使用：对于关系紧密的多个项目，一般会建立 ProjectGroup，ProjectGroup 目录结构一般会类似如下：Hello project.jelly - 总控项目脚本文件 project.xml - 总控项目描述文件biz - biz 层dal - dal 项目user - user 项目bun
6、dle - bundle 层ear - ear 项目war - war 项目ejb - ejb 项目web - web 层user - user 项目home - home 项目deploy - deploy 项目首先总控项目文件会定义所有子项目都会使用的一些属性，例如 build property 以及projects 定义，示例如下： 对于所有的子项目而言，需要指定其 extend 自这个总控项目( 指定相对路径，并且多个./可以压缩为一个./)。对于 ProjectGroup，可以通过 antx reactor 来对于 ProjectGroup 中的每个子项目执行相应目标，并且 antx
7、 reactor 保证按照项目之间的依赖关系顺序构建。5. repository ：为解决不同类型的项目之间的关联关系不同，构建方式也不同的问题，antx 实现了三级 repository。第一级（local, 所谓的 1st party 类库）a) 位置：$HOME.antxrepositoryb) 用于关联关系较紧密的子项目例如：同一个 team 在同一时间开发的若干子项目c) 该 repository 的内容只存在于本地，不需要被共享第二级（project, 所谓的 2nd party 类库）d) 位置（默认）：$HOME.antxrepository.projecte) 用于关联关系较
8、疏远的子项目例如：不同 team 或不同时期开发的子项目f) 该 repository 的内容需要被 team 间共享g) 该 repository 的内容通常需要注明版本号第三级（external, 所谓的 3rd party 类库）h) 位置：antxrepository 或者 antx.repositoryi) 用于定义第三方提供的类库例如：Apache Jakarta 类库j) 该 repository 随着 antx 更新而更新k) 该 repository 中的内容可以被注明版本号，也可以不注6. 常用 antx 命令：antx : 执行当前项目的默认目标，默认目标即为 proje
9、ct.jelly 中的 default 属性值。antx reactor : 对于 Project Group 中的每一个项目执行默认目标。ProjectGroup 中的项目是怎样确定的呢：如果命令行上通过 projects 属性指定，则以这些 projects 为准；否则以总控项目文件中 reactor.group 属性对应的 projects 组中所包含的 project 为准；如果reactor.group 没有指定，或者指定错误，则扫描当前目录下的所有子项目。antx clean : 清除当前项目输出。antx eclipse : 为当前项目产生 eclipse 项目文件，以便导入 e
10、clipse。antx reactor goals=clean,default : 为 ProjectGroup 中的每一个项目先执行 clean，再执行默认目标。antx reactor goals=eclipse,default : 为 ProjectGroup 中的每一个项目先产生 eclipse 项目文件，再执行默认目标。7. antx config：为解决二进制发布包包含一些个性化参数(IP 、域名、目录名等) 问题而实现，实现方式是先发布，后配置，程序员提供配置的模板、变量名、变量的限定条件，配置员（要使用二进制发布的人）提供变量的值，并接受限定条件的检查，系统结合模板和变量值，生
11、成个性化配置文件。使用示例： 创建 src/conf/META-INF/autoconf/auto-config.xml 创建 src/conf/META-INF/autoconf/myconf.xml.vm$myproject_workdirhttp:/www.$myproject_domain:$myproject_port/ Build 并配置 antx jar antx config uris=my/project也可以选择修改脚本，让 antx 执行自己定义的脚本： 修改 project.jelly 修改 project.xml 执行：antx deploy有关 antx confi
12、g 的更多信息可以参看宝宝的专门文档： http:/opentech.alibaba- 8. Antx console 及其注意事项：由于装载 repository 和 POM(即项目的 project.xml 等文件)耗时较长，所以 antx 执行速度上还是有些慢，为了进一步提升 antx 的执行速度，所以推出 antx console 模式，通过antx console 可以将通常不太修改的 repository 和 POM 缓存起来，因此除了第一次装载还需要消耗一定的时间，后面每次 build 的时间会显著减少。使用方法：antx c 进入 antx console 模式，然后即可象普通
13、模式下一样执行 antx 命令。通过 load 命令可以装载某个项目，通过 cd 命令可以在已经装载的项目中进行切换。注意事项：由于 antx console 对于 project.xml 进行了缓存，所以当项目的 project.xml 发生变化时（例如修改了项目依赖关系） ，需要重新启动 antx console，否则 project.xml 的修改是不会生效的。9. Antx eclipse plugin：Antx eclipse plugin 是一系列辅助基于 antx 开发的 eclipse plugin，它目前包括的功能有：a). Antx console for eclipse：
14、可以在 eclipse 的控制台中执行 antx 命令，使用方法同antx console 完全相同。b). 快速部署插件：通常运行一个 J2EE 应用需要经历打包、配置、布署等步骤，这在开发时会浪费很多时间。有了这个 plugin，就像使用 eclipse 即时编译一样，当文件被修改时自动更新到运行环境中，甚至不需要重启服务器就可以立即生效。c). 项目创建向导：在 eclipse 中以 wizard 形式创建符合 antx 和 webx 要求的目录结构、项目文件及配置。d). 项目属性页：可以直接在 eclipse 中可视化的浏览 repository，并修改项目依赖关系。关于 Antx eclipse plugin 的使用可以参见如下资源：http:/opentech.alibaba-
