Konfigurieren von Ivy für Ant build

Zuerst müssen Sie definieren eine <taskdef> auf die Ivy-tasks.

<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>

Werden, die Ihnen Zugriff auf die Ivy-tasks. Sie würde mit diesen Aufgaben wie diese:

<cachepath pathid="main.classpath" conf="compile"/>

Das problem ist, dass Ihr Efeu Aufgaben-Namen kollidieren könnten, mit anderen Ant-tasks. Es gibt zum Beispiel ein Efeu Aufgabe <report>. Um dieses Problem zu lösen, können Sie eine Ivy-namespace. Das zu tun, setzen Sie eine Referenz in Ihrer namespace in der <project> Person wie diese:

<project name="my.proj" default="package" basedir="."
    xmlns:ivy="antlib:org.apache.ivy.ant"/>

Nun, wenn Sie definieren die Ivy-tasks, die Sie verwenden können, dass antlib:org.apache.ivy.ant Verweis auf Ihre ivy namespace. Gleiche taskdef wie vorher, aber mit uri Feld:

<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>

Durch die Art und Weise, es gibt nichts besonderes darüber, dass uri. Ich konnte dies getan haben:

<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>

Der Punkt ist, jetzt können Sie Präfix Ihre Aufgabe-Namen mit ivy:. Stattdessen:

<cachepath pathid="main.classpath" conf="compile"/>

Können Sie jetzt tun:

<ivy:cachepath pathid="main.classpath" conf="compile"/>

Und das ist, wie Sie Zugang zu Ihrem Ivy Ant-tasks.

Nun, Sie haben Zugriff auf Ihre Ivy Ant-tasks, die Sie brauchen, um zu definieren, eine ivysettings.xml Datei und verwenden Sie die <ivy:settings/> Aufgabe zu Punkt gibt es noch:

 <ivy:settings file="${ivy.home}/ivysettings.xml"/>

Gibt es einen Standard - ivysettings.xml - Datei eingebettet sind, in Ivy, die Sie auf das world wide Maven-repository-system. Wenn Sie nicht über eine unternehmensweite Maven-repository, dann können Sie die Standardeinstellung ivysettings.xml Datei:

<ivy:settings/>

Das ist ziemlich einfach.

Sobald Sie das getan haben, müssen Sie zum Lesen und beheben Ihre ivy.xml - Datei, die sitzt meist in der Wurzel von Ihrem Projekt im selben Verzeichnis wie Ihre build.xml Datei.

Grundsätzlich Ihre ivy.xml - Datei enthält Verweise auf die Dritten Gläser Sie mitnehmen möchten, in Ihr Projekt. Zum Beispiel:

<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>

Was dies sagt, ist, ich brauche die log4j.jar (Version 1.2.17) für die Zusammenstellung (und für die Zusammenstellung der tests auch) und ich brauche junit.jar (revision.4.10) für die Zusammenstellung von meinem test-code.

Den compile->default ist eine Zuordnung von meine compile Konfiguration von Maven ist default Konfiguration (die sagt, ich will einfach nur die Jar und andere Gläser, es könnte davon abhängen.

Wo ist nicht meine compile Konfiguration kommen? Ich definiere es in meinem ivy.xml. Es gibt zehn standard-Konfigurationen. Dies gilt auch in Ihrem ivy.xml Datei:

<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>

Können Sie alle Namen der Konfiguration, die Sie wollen, aber diese Karte, um die Standard-Maven-Konfigurationen und sind weit verbreitet.

Sobald Sie Ihre ivy.xml - Datei definiert, die Sie verwenden können <ivy.resolve> zu lösen, Abhängigkeiten:

<ivy:resolve/>

Wir haben also die folgenden:

1. Wie zu verwenden <taskdef> in Ihrem build.xml zu übernehmen Ivy Ant-tasks in Ihrem build.
2. Wie die Ivy Ant-task <ivy:settings> zu konfigurieren Ivy.
3. Wie zu verwenden <ivy:resolve/> zu Lesen in Ihrem ivy.xml - Datei und lösen Sie Ihre Drittanbieter-jar-Abhängigkeiten.

Nun, werden Sie wahrscheinlich wollen, um tatsächlich mit diesen jar-Dateien. Es gibt drei Möglichkeiten, dies zu tun:

 <ivy:cachepath pathid="main.classpath" conf="compile"/>

Den <ivy:cachepath/> Aufgabe erstellen Sie eine classpath (in diesem Fall genannt main.classpath), dass Punkte auf die Gläser, die Sie in Ihrem ivy.xml Datei compile Konfiguration. Dies wird verwendet, die meisten der Zeit.

Wenn Sie ein fileset, können Sie diese verwenden:

 <ivy:cachefileset setid="compile.fileset" conf="compile"/>

In diesem Fall, es wird ein fileset mit refid von compile.fileset.

Manchmal haben Sie, um die Gläser in Ihrem Projekt. Zum Beispiel, wenn Sie eine war-oder ear-Datei, die Sie möchten, schließen Sie die Gläser. In diesem Fall können Sie verwenden:

<property name="lib.dir" value="${target.dir}/lib"/>
<ivy:retrieve pattern="${lib.dir}/[artifact].[ext]"
     conf="runtime"/>

Holt Ihre Gläser in die ${lib.dir} - Verzeichnis, damit Sie Sie einfügen können, die in kriegen oder Ohren.

Sorry für die lange Antwort, aber es gibt eine Menge von Schritten zu decken. Ich empfehle Manning Buch Ameise in Aktiondie hat ein ganzes Kapitel über Ivy.

InformationsquelleAutor der Antwort David W.