首先,您需要定义一个
<taskdef>
来指向Ivy任务。
<property environment="env"/>
<property name="ivy.home" value="${env_IVY_HOME}"/>
<taskdef resource="org/apache/ivy/ant/antlib.xml">
<classpath>
<fileset dir="${ivy.home}">
<include name="*.jar"/>
</fileset>
</classpath>
</taskdef>
那将使您可以访问Ivy任务。您可以像这样使用这些任务:
<cachepath pathid="main.classpath" conf="compile"/>
问题在于你的Ivy任务名称可能会与其他Ant任务冲突。例如,有一个Ivy任务
<report>
。为了解决这个问题,你可以创建一个Ivy命名空间。要做到这一点,你需要在
<project>
实体中放置一个引用来指向你的命名空间,就像这样:
<project name="my.proj" default="package" basedir="."
xmlns:ivy="antlib:org.apache.ivy.ant"/>
现在,当你定义Ivy任务时,可以使用antlib:org.apache.ivy.ant
引用你的ivy
命名空间。与之前相同的taskdef,但需要加上一个uri
字段:
<property environment="env"/>
<property name="ivy.home" value="${env_IVY_HOME}"/>
<taskdef resource="org/apache/ivy/ant/antlib.xml"
uri="antlib:org.apache.ivy.ant">
<classpath>
<fileset dir="${ivy.home}">
<include name="*.jar"/>
</fileset>
</classpath>
</taskdef>
顺便说一下,那个uri
没有什么特别的。我也可以这样做:
<project name="my.proj" default="package" basename="."
xmlns:ivy="pastrami:with.mustard">
[...]
<taskdef resource="org/apache/ivy/ant/antlib.xml"
uri="pastrami:with.mustard">
<classpath>
<fileset dir="${ivy.home}">
<include name="*.jar"/>
</fileset>
</classpath>
</taskdef>
现在你可以在任务名前加上“ivy:”。这样做代替了原来的方式:
<cachepath pathid="main.classpath" conf="compile"/>
您现在可以这样做:
<ivy:cachepath pathid="main.classpath" conf="compile"/>
这就是如何获取您的Ivy Ant任务的方法。
现在,您已经可以访问您的Ivy Ant任务,您需要定义一个ivysettings.xml文件,并使用任务指向它:
<ivy:settings file="${ivy.home}/ivysettings.xml"/>
在Ivy中有一个默认的ivysettings.xml
文件,它会将您指向全球范围内的Maven存储库系统。如果您没有公司级别的Maven存储库,则可以使用默认的ivysettings.xml
文件:
<ivy:settings/>
这很简单。
完成上述步骤后,您需要读取并解析您的ivy.xml
文件,该文件通常位于项目根目录中,与build.xml
文件在同一目录中。
基本上,您的ivy.xml
文件包含了您想要引入项目中的第三方jar包的引用。例如:
<dependencies>
<dependency org="log4j" name="log4j" rev="1.2.17" conf="compile->default"/>
<dependency org="junit" name="junit" rev="4.10" conf="test->default"/>
</dependencies>
这段话的意思是,我需要
log4j.jar
(版本为1.2.17)进行编译(包括编译测试代码),还需要
junit.jar
(版本为4.10)用于测试代码的编译。
compile->default
将我的
compile
配置映射到 Maven 的
default
配置(表示我只需要 Jar 包及其可能依赖的其他 Jar 包)。
我的
compile
配置从哪里来?我在
ivy.xml
中定义了它。有十个标准配置,也要写入你的
ivy.xml
文件。
<configurations>
<conf name="default" visibility="public" description="runtime dependencies and master artifact can be used with this conf" extends="runtime,master"/>
<conf name="master" visibility="public" description="contains only the artifact published by this module itself, with no transitive dependencies"/>
<conf name="compile" visibility="public" description="this is the default scope, used if none is specified. Compile dependencies are available in all classpaths."/>
<conf name="provided" visibility="public" description="this is much like compile, but indicates you expect the JDK or a container to provide it. It is only available on the compilation classpath, and is not transitive."/>
<conf name="runtime" visibility="public" description="this scope indicates that the dependency is not required for compilation, but is for execution. It is in the runtime and test classpaths, but not the compile classpath." extends="compile"/>
<conf name="test" visibility="private" description="this scope indicates that the dependency is not required for normal use of the application, and is only available for the test compilation and execution phases." extends="runtime"/>
<conf name="system" visibility="public" description="this scope is similar to provided except that you have to provide the JAR which contains it explicitly. The artifact is always available and is not looked up in a repository."/>
<conf name="sources" visibility="public" description="this configuration contains the source artifact of this module, if any."/>
<conf name="javadoc" visibility="public" description="this configuration contains the javadoc artifact of this module, if any."/>
<conf name="optional" visibility="public" description="contains all optional dependencies"/>
</configurations>
你可以使用任何配置名称,但这些名称对应于默认的Maven配置,并且被广泛使用。
一旦你定义了你的ivy.xml文件,你可以使用来解决你的依赖关系:
<ivy:resolve/>
所以,我们有以下内容:
- 如何在您的
build.xml
中使用<taskdef>
来将Ivy Ant任务合并到您的构建中。
- 如何使用Ivy Ant任务
<ivy:settings>
来配置Ivy。
- 如何使用
<ivy:resolve/>
读取您的ivy.xml
文件并解析第三方jar依赖项。
现在,您可能想要实际使用这些jar文件。有三种方法可以做到这一点:
<ivy:cachepath pathid="main.classpath" conf="compile"/>
<ivy:retrieve/>
任务将下载您在
ivy.xml
文件的
compile
配置中定义的所有依赖项。 如果您需要一个文件集,可以使用此任务。 通常与
<copy>
任务一起使用以将文件复制到目标位置。
示例:
<ivy:retrieve pattern="lib/[artifact].[ext]"/>
这将下载所有依赖项并将它们放置在lib/
目录下。
<ivy:cachefileset setid="compile.fileset" conf="compile"/>
在这种情况下,它将创建一个具有
compile.fileset
refid 的文件集。
有时您需要将jar包引入您的项目中。例如,如果您创建了一个war或ear文件,您想要将您的jar包封装起来。在这种情况下,您可以使用以下方法:
<property name="lib.dir" value="${target.dir}/lib"/>
<ivy:retrieve pattern="${lib.dir}/[artifact].[ext]"
conf="runtime"/>
那将把你的jar文件获取到
${lib.dir}
目录中,这样你就可以在wars或ears中包含它们。
抱歉回答比较长,但需要涵盖很多步骤。我强烈推荐Manning出版社的书籍
Ant in Action,其中有一整章介绍了Ivy。
conf
属性定义为conf="*->*"
或conf=compile->default
,但似乎没有人清楚这些内容的作用和原因... - IAmYourFajaivy.xml
)和解决对应仓库之间的映射,甚至还慷慨地展示了compile
配置可能看起来像什么(与test
配置相比)。但是在存储库端(“箭头”操作符的右侧)呢? "*->*
"映射到什么?“default
”呢?只是好奇,因为无论我读多少次Ivy文档,都似乎无法理解。再次感谢您的所有帮助! - IAmYourFajaivy.xml
文件中定义您的配置文件。我在文章中提到的标准配置映射到Maven的_scopes_。 我可以在我的“ivy.xml”中定义一个单独的配置,或者我可以添加我上面没有提到的配置。例如,有些人在“ivy.xml”中添加了“generated-sources”配置文件,用于axis2和WSDL文件等。问题在于您必须将您的配置映射到存储库的配置。我从未尝试过*->*
。我猜它会将您“ivy.xml”中的所有配置文件映射到所有存储库配置文件中。我得试试看。 - David W.