|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ResolutionStrategy
Defines the strategies around dependency resolution. For example, forcing certain dependency versions, conflict resolutions or snapshot timeouts.
Examples:
configurations.all { resolutionStrategy { // fail eagerly on version conflict (includes transitive dependencies) // e.g. multiple different versions of the same dependency (group and name are equal) failOnVersionConflict() // force certain versions of dependencies (including transitive) // *append new forced modules: force 'asm:asm-all:3.3.1', 'commons-io:commons-io:1.4' // *replace existing forced modules with new ones: forcedModules = ['asm:asm-all:3.3.1'] // cache dynamic versions for 10 minutes cacheDynamicVersionsFor 10, 'minutes' // don't cache changing modules at all cacheChangingModulesFor 0, 'seconds' } }
Method Summary | |
---|---|
void |
cacheChangingModulesFor(int value,
String units)
Sets the length of time that changing modules will be cached, with units expressed as a String. |
void |
cacheChangingModulesFor(int value,
TimeUnit units)
Sets the length of time that changing modules will be cached. |
void |
cacheDynamicVersionsFor(int value,
String units)
Sets the length of time that dynamic versions will be cached, with units expressed as a String. |
void |
cacheDynamicVersionsFor(int value,
TimeUnit units)
Sets the length of time that dynamic versions will be cached. |
ResolutionStrategy |
failOnVersionConflict()
In case of conflict, Gradle by default uses the newest of conflicting versions. |
ResolutionStrategy |
force(Object... forcedModuleNotations)
Allows forcing certain versions of dependencies, including transitive dependencies. |
Set<ModuleVersionSelector> |
getForcedModules()
Returns currently configured forced modules. |
ResolutionStrategy |
setForcedModules(Object... forcedModuleNotations)
Allows forcing certain versions of dependencies, including transitive dependencies. |
Method Detail |
---|
ResolutionStrategy failOnVersionConflict()
Configuration
.
The check includes both first level and transitive dependencies. See example below:
configurations.all { resolutionStrategy.failOnVersionConflict() }
ResolutionStrategy force(Object... forcedModuleNotations)
It accepts following notations:
ModuleVersionSelector
configurations.all { resolutionStrategy.force 'asm:asm-all:3.3.1', 'commons-io:commons-io:1.4' }
forcedModuleNotations
- typically group:name:version notations to append
ResolutionStrategy setForcedModules(Object... forcedModuleNotations)
For information on notations see force(Object...)
Example:
configurations.all { resolutionStrategy.forcedModules = ['asm:asm-all:3.3.1', 'commons-io:commons-io:1.4'] }
forcedModuleNotations
- typically group:name:version notations to set
Set<ModuleVersionSelector> getForcedModules()
force(Object...)
void cacheDynamicVersionsFor(int value, String units)
A convenience method for cacheDynamicVersionsFor(int, java.util.concurrent.TimeUnit)
with units expressed as a String.
Units are resolved by calling the valueOf(String)
method of TimeUnit
with the upper-cased string value.
value
- The number of time unitsunits
- The unitsvoid cacheDynamicVersionsFor(int value, TimeUnit units)
Gradle keeps a cache of dynamic version => resolved version (ie 2.+ => 2.3). By default, these cached values are kept for 24 hours, after which the cached entry is expired and the dynamic version is resolved again.
Use this method to provide a custom expiry time after which the cached value for any dynamic version will be expired.
value
- The number of time unitsunits
- The unitsvoid cacheChangingModulesFor(int value, String units)
A convenience method for cacheChangingModulesFor(int, java.util.concurrent.TimeUnit)
with units expressed as a String.
Units are resolved by calling the valueOf(String)
method of TimeUnit
with the upper-cased string value.
value
- The number of time unitsunits
- The unitsvoid cacheChangingModulesFor(int value, TimeUnit units)
Gradle caches the contents and artifacts of changing modules. By default, these cached values are kept for 24 hours, after which the cached entry is expired and the module is resolved again.
Use this method to provide a custom expiry time after which the cached entries for any changing module will be expired.
value
- The number of time unitsunits
- The units
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |