mirror of https://github.com/apache/ant-ivy
94 lines
2.9 KiB
Plaintext
94 lines
2.9 KiB
Plaintext
////
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you under the Apache License, Version 2.0 (the
|
|
"License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License at
|
|
|
|
https://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing,
|
|
software distributed under the License is distributed on an
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
KIND, either express or implied. See the License for the
|
|
specific language governing permissions and limitations
|
|
under the License.
|
|
////
|
|
|
|
[*__since 2.3__*] (*__Ant 1.7 required__*)
|
|
|
|
`ivy:resources` is an Ant link:https://ant.apache.org/manual/Types/resources.html#collection[resource collection], containing files found by an Ivy resolve, which then can be used with any task working with resources like `copy` or `import`.
|
|
|
|
This datatype shares the same attributes, child elements and behaviour of a link:../use/postresolvetask{outfilesuffix}[post resolve task]. It is not expected to be used as an Ant task though, only as a resource collection.
|
|
|
|
== Examples
|
|
|
|
[source,xml]
|
|
----
|
|
<ivy:resources file="path/to/ivy.xml"/>
|
|
----
|
|
|
|
Build a resource collection of every artifacts of all dependencies declared in `path/to/ivy.xml` file.
|
|
|
|
'''
|
|
|
|
[source,xml]
|
|
----
|
|
<ivy:resources file="path/to/ivy.xml" transitive="false"/>
|
|
----
|
|
|
|
Same as above, but with transitive dependencies disabled.
|
|
|
|
'''
|
|
|
|
[source,xml]
|
|
----
|
|
<ivy:resources file="path/to/ivy.xml" conf="default, test"/>
|
|
----
|
|
|
|
Build a resource collection of every artifacts of the dependencies declared in the configuration default and test of the `path/to/ivy.xml` file.
|
|
|
|
'''
|
|
|
|
[source,xml]
|
|
----
|
|
<ivy:resources file="path/to/ivy.xml" type="jar"/>
|
|
----
|
|
|
|
Build a resource collection of every `jar` artifact of all dependencies declared in `path/to/ivy.xml` file.
|
|
|
|
'''
|
|
|
|
[source,xml]
|
|
----
|
|
<ivy:resources organisation="apache" module="commons-lang" revision="2+" inline="true"/>
|
|
----
|
|
|
|
Build a resource collection of every artifacts of `commons-lang` module revision 2+ from the repository, with its dependencies.
|
|
|
|
'''
|
|
|
|
[source,xml]
|
|
----
|
|
<ivy:resources>
|
|
<dependency org="apache" module="commons-lang" rev="2+"/>
|
|
<dependency org="apache" module="commons-logging" rev="1.1"/>
|
|
<exclude org="apache" module="log4j"/>
|
|
</ivy:resources>
|
|
----
|
|
|
|
Build a resource collection of every artifacts of both `commons-lang` and `commons-logging`, with their dependencies but not `log4j`.
|
|
|
|
'''
|
|
|
|
[source,xml]
|
|
----
|
|
<ivy:resources>
|
|
<dependency org="org.slf4j" module="slf4j" rev="1.6" conf="api,log4j"/>
|
|
</ivy:resources>
|
|
----
|
|
|
|
Build a resource collection of every artifacts of the configurations `api` and `log4j` of `slf4j`.
|