В чем разница между методами configuration.files и configuration.copy в Gradle?

Question

В Gradle руководстве пользователя Chapter 23. Dependency Management, пример показывает разницу между Configuration.copy и Configuration.files методом:

build.gradle 

task copyVsFiles << { 
    configurations.sealife.copyRecursive { dep -> dep.name == 'orca' } 
     .each { file -> println file.name } 
    println() 
    configurations.sealife.files { dep -> dep.name == 'orca' } 
     .each { file -> println file.name } 
} 

Output of gradle -q copyVsFiles 
> gradle -q copyVsFiles 
orca-1.0.jar 
seal-1.0.jar 

orca-1.0.jar 
seal-2.0.jar 

ниже объяснение смутило меня. Я все еще не знаю разницы. Кто-нибудь может мне с этим помочь ?

Answer 1

Ответ на ваш вопрос приведен в параграфе сразу после примера 23.24 в документации по API Gradle Chapter 23 Section 24.

Обратите внимание, как метод configurations.files возвращает версию 2 уплотняющей банки.

В приведенном выше примере, косатка имеет зависимость от уплотнения-1,0, тогда как акула имеет зависимость onseal-2.0. Поэтому исходная конфигурация имеет конфликт версий, который разрешен для более новой версии seal-2.0. Метод файлов поэтому возвращает уплотнение-2.0 в качестве транзитивной зависимости orca. Скопированная конфигурация имеет только orca в качестве зависимости и , поэтому конфликт версий отсутствует, а печать-1.0 возвращается как транзитивная зависимость .

Чтобы понять, почему это происходит, потратите некоторое время на метод конфигурации в Gradle docs.

файлы выполняют следующие действия:

Решает эту конфигурацию. Это находит и загружает файлы , которые составляют эту конфигурацию. Но возвращается только результирующий набор файлов , принадлежащий подмножеству зависимостей, указанному в параметре dependencySpec .

Copy делает следующее:

Создает копию этой конфигурации, который содержит только зависимостей непосредственно в этой конфигурации (без взносов от superconfigurations). Новая конфигурация будет находиться в состоянии UNRESOLVED, но сохранит все остальные атрибуты этой конфигурации , за исключением суперконфигурации. Configuration.getHierarchy() для копии не будет содержать никаких суперконфигураций.

Как это применимо к примеру документации? Configuration.files разрешает конфигурацию, которая, как показано в примере в примере, обрабатывает конфликт версии, введенный shark, который зависит от seal-2.0.jar. Configuration.copy создает копию конфигурации и еще не разрешен, что означает, что у нее еще нет конфликта версий.