Skip navigation.

Ivy Files

Ivy use is entirely based on what is called ivy files. Ivy files are xml files, usually called ivy.xml, containing the description of the dependencies of a module, its published artifacts and its configurations.

Here is the simplest ivy file you can write:

<ivy-module version="1.3">
  <info organisation="myorg"
        module="mymodule"
        />
</ivy-module>

Since version 0.8, ivy publishes an xslt which help make ivy files more readable. You just have to add
a line like this one in your ivy file:

<?xml-stylesheet type="text/xsl" href="http://www.ivyrep.org/ivy-doc.xsl"?>

However, all information is not presented with the xslt (dependency configurations, in particular).
And due to security issues, it only works if the ivy file is in the same domain as the xsl... But they are particularly useful to browse the ivy repository.

If you want to see a sample file using almost all possibilities of ivy files, check this one, with or without xslt.

Before beginning the reference itself, it is required to have in mind the terminology defined in the main page of this reference documentation.

For those familiar with xml schema, the schema used to validate ivy files can be found here. For those using xsd aware IDE, you can declare the xsd in your ivy files to benefit from code completion / validation:

<?xml version="1.0" encoding="UTF-8"?>
<ivy-module version="1.3"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:noNamespaceSchemaLocation=
                  "http://www.jayasoft.org/misc/ivy/ivy.xsd">
  <info organisation="myorg"
        module="mymodule"
        />
</ivy-module>

Hierarchical Index

ivy-module
    info
        license
        ivyauthor
        repository
        description
    configurations
        conf
    publications
        artifact
            conf
    dependencies
        dependency
            conf
                mapped
            artifact
                conf
            include
                conf
            exclude
                conf
    conflicts
        manager

ivy-module

Tag: ivy-module

Root tag of any ivy-file.

Attributes

Attribute Description Required
version the version of the ivy file specification - should be '1.3' with current version of ivy Yes

Child elements

Element Description Cardinality
info contains information about the described module 1
configurations container for configuration elements 0..1
publications container for published artifact elements 0..1
dependencies container for dependency elements 0..1
conflicts section to configure the conflict managers to use 0..1