- Documentation (2.5.0)
- Release Notes
- Settings Files
- Ivy Files
- Ant Tasks
- post resolve tasks
- Using standalone
- Developer doc
Tag: conf Parent: configurations
Declares a configuration of this module. As described in the reference page, a configuration is a way to use or construct a module. Some modules may be used in different ways (think about hibernate which can be used inside or outside an application server), and this way may alter the artifacts you need (in the case of hibernate, jta.jar is needed only if it is used outside an application server). Moreover, a module may need some other modules and artifacts only at build time, and some others at runtime. All those different ways to use or build a module are called module configurations in Ivy.
conf element in the configurations section declares one configuration. This declaration gives the name of the configuration declared, its visibility and the other configurations of the module it extends.
visibility is used to indicate whether or not a configuration can be used from other modules depending on this one. Thus a private configuration is only used for internal purpose (maybe at build time), and other modules cannot declare to depend on it.
A configuration can also extend one or several other ones of the same module. When a configuration extends another one, then all artifacts required in the extended configuration will also be required in the configuration that extends the other one. For instance, if configuration B extends configuration A, and if artifacts art1 and art2 are required in configuration A, then they will be automatically required in configuration B. On the other hand, artifacts required in configuration B are not necessarily required in configuration A.
This notion is very helpful to define configurations which are similar with some differences.
The extends attribute can use the following wildcards:
all other configurations
all other public configurations
all other private configurations
A whole configuration can be declared as non transitive, so that all dependencies resolved in this configuration will be resolved with transitivity disabled. Note that the transitivity is disabled for all the configuration dependencies (including those obtained because this conf extends other ones), and only for this configuration (which means that a conf extending this one with transitivity enabled will get transitive dependencies even for dependencies being part of the non transitive configuration). This is very useful to build a compile configuration, for instance, forcing the dependency declaration on each direct dependency, with no risk to forget some because of transitivity.
This tag supports extra attributes.
the name of the declared configuration
a description for the declared configuration
the visibility of the declared configuration.
No, defaults to
a comma separated list of configurations of this module that the current configuration extends
No, defaults to none
a boolean to indicate if this conf is transitive or not (since 1.4)
No, defaults to
indicates that this conf has been deprecated by giving the date of the deprecation.
It should be given in this format:
No, by default the conf is not deprecated
<conf name="core" visibility="private"/> <conf name="compile" extends="core" transitive="false" visibility="private"/> <conf name="runtime" extends="compile" description="everything needed to run this module"/>
Declares three configurations,
runtime, with only the
runtime one accessible from other modules, and with the
compile one being non transitive.
core configuration will only be composed of dependencies declared in the
core configuration itself, the
compile configuration will be composed of all dependencies required in either
compile configuration, but without transitivity (neither for core nor compile dependencies), and
runtime will be composed of all dependencies, all transitively, including the dependencies declared only in