用Ant和Ivy解析javadoc文件

我想让Ivy获取log4j .jar和JavaDocs。现在，我在一个死胡同里。如果我在ivy.xml中使用这个…

<dependency org="log4j" name="log4j" rev="1.2.16"/>

…然后我就得到了.jar文件。但是当使用这个ivysettings.xml…

<?xml version="1.0" encoding="UTF-8"?>
<ivysettings>
    <settings  
            defaultResolver="default"
            defaultConflictManager="all" />
    <resolvers>
        <url name="default" m2compatible="true">
            <artifact pattern="http://repo1.maven.org/maven2/[organisation]/[module]/[revision]/[artifact]-[revision].[ext]"/>
            <artifact pattern="http://repo2.maven.org/maven2/[organisation]/[module]/[revision]/[artifact]-[revision].[ext]"/>
        </url>
    </resolvers>
</ivysettings>

…这个ivy.xml…

<?xml version="1.0" encoding="UTF-8"?>
<ivy-module version="2.0" 
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:noNamespaceSchemaLocation="http://ant.apache.org/ivy/schemas/ivy.xsd">
    <info organisation="foo" module="bar"/>
    <dependencies>
        <dependency org="log4j" name="log4j" rev="1.2.16">
            <artifact name="log4j" type="jar" ext="jar"/>
            <artifact name="log4j" type="javadoc" ext="jar"/> 
        </dependency>
    </dependencies>
</ivy-module>

…然后我得到这个错误信息: . lang。RuntimeException:模块log4j#log4j;1.2.16的多个工件被检索到同一个文件!更新检索模式以修复此错误。

我在这里错过了什么?我怎样才能让Ivy同时解析JavaDoc和.jar文件?

编辑:感谢到目前为止所有快速和详细的回应。这是我更新的ivy.xml:

<?xml version="1.0" encoding="UTF-8"?>
<ivy-module version="2.0" 
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:noNamespaceSchemaLocation=
                   "http://ant.apache.org/ivy/schemas/ivy.xsd">
    <info organisation="foo" module="bar"/>
    <configurations>
        <conf name="default" visibility="public"/>
        <conf name="compile" visibility="public"/>
        <conf name="master"  visibility="public"/>
        <conf name="javadoc" visibility="public"/>
    </configurations>
    <dependencies>
        <dependency org="log4j"             name="log4j"       rev="1.2.16" conf="default->master,javadoc"/>
        <dependency org="javax.servlet"     name="servlet-api" rev="2.5" />
        <dependency org="com.someother"     name="proprietary-core" rev="1.2.3" force="true"/>
        <dependency org="com.someother"     name="proprietary" rev="1.2.3" force="true"/>
        <dependency org="com.someother"     name="scanner"     rev="1.0"   force="true"/>
    </dependencies>
</ivy-module>

现在我得到这个错误信息:

Buildfile: D:workspacefoobarbuild.xml
resolve:
[ivy:retrieve] :: Ivy 2.2.0 - 20100923230623 :: http://ant.apache.org/ivy/ ::
[ivy:retrieve] :: loading settings :: file = D:workspacefoobarivysettings.xml
[ivy:retrieve] :: resolving dependencies :: foo#bar;working@myhost
[ivy:retrieve]  confs: [default, compile, master, javadoc]
[ivy:retrieve]  found log4j#log4j;1.2.16 in internal
[ivy:retrieve]  found javax.servlet#servlet-api;2.5 in internal
[ivy:retrieve]  found com.someother#proprietary-core;1.2.3 in internal
[ivy:retrieve]  found com.someother#proprietary;1.2.3 in internal
[ivy:retrieve]  found com.someother#scanner;1.0 in internal
[ivy:retrieve] :: resolution report :: resolve 332ms :: artifacts dl 10ms
    ---------------------------------------------------------------------
    |                  |            modules            ||   artifacts   |
    |       conf       | number| search|dwnlded|evicted|| number|dwnlded|
    ---------------------------------------------------------------------
    |      default     |   5   |   0   |   0   |   0   ||   4   |   0   |
    |      compile     |   4   |   0   |   0   |   0   ||   4   |   0   |
    |      master      |   4   |   0   |   0   |   0   ||   4   |   0   |
    |      javadoc     |   4   |   0   |   0   |   0   ||   4   |   0   |
    ---------------------------------------------------------------------
[ivy:retrieve] 
[ivy:retrieve] :: problems summary ::
[ivy:retrieve] :::: WARNINGS
[ivy:retrieve]      ::::::::::::::::::::::::::::::::::::::::::::::
[ivy:retrieve]      ::          UNRESOLVED DEPENDENCIES         ::
[ivy:retrieve]      ::::::::::::::::::::::::::::::::::::::::::::::
[ivy:retrieve]      :: log4j#log4j;1.2.16: configuration not found in log4j#log4j;1.2.16: 'master'. It was required from foo#bar;working@myhost default
[ivy:retrieve]      ::::::::::::::::::::::::::::::::::::::::::::::
[ivy:retrieve] 
[ivy:retrieve] 
[ivy:retrieve] :: USE VERBOSE OR DEBUG MESSAGE LEVEL FOR MORE DETAILS

Maven作用域似乎有问题。但我到底漏掉了什么?

问题在于您在ivy检索任务中使用的模式。它需要包含可选的"classifier"属性，以确保文件名是唯一的:

<ivy:retrieve pattern="lib/[conf]/[artifact](-[classifier]).[ext]"/>

Classifier是Maven的东西，用于识别与Maven模块关联的附加工件。

附加观测

不需要复杂的常春藤设置。配置映射控制从其他模块下载哪些工件。

删除ivysettings.xml文件，并在ivy.xml中尝试以下操作:

<dependency org="log4j" name="log4j" rev="1.2.16" conf="default->master,javadoc"/>

这将导致下载以下文件:

log4j-1.2.16.jar
log4j-1.2.16-javadoc.jar

它是如何工作的?

对于Maven模块，ivy创建一个匹配每个标准Maven作用域的配置:

编译:主jar，加上用于编译的jar(这也是"默认"作用域)
运行时:主jar，加上用于编译的jar，运行时
test:主要的jar，加上用于编译、运行、测试的jar

，并为模块发布的每个附加工件(或分类器)创建一个配置:

javadoc

附加观测

相关内容

最新更新

热门标签：