Настройка Gradle зависимостей для исключения logback-android только в тестах

Для исключения пакета из зависимости в Gradle используется синтаксис exclude. Вот несколько способов:

1. Исключение в секции зависимостей:

dependencies {
 compile('rhino:js:1.7.7') {
 exclude group: 'com.github.tony19', module: 'logback-android'
 }
}

2. Глобальное исключение через конфигурации:

configurations {
 all {
 exclude group: "com.github.tony19", module: "logback-android"
 }
}

3. Исключение для определенной конфигурации:

configurations {
 compile {
 exclude group: "com.github.tony19", module: "logback-android"
 }
}

Важно понимать, что exclude удаляет только транзитивные зависимости. Если пакет является прямой зависимостью, его нужно исключать через transitive = false.

Различия между Gradle конфигурациями зависимостей:

Особенности testRuntimeOnly:

• Объявляет зависимости, которые требуются только во время выполнения тестов
• Не требуются во время компиляции тестов
• Используется для тестовых рантайм зависимостей, таких как движки тестирования

Разница между implementation, API, compile и runtimeOnly в Gradle:

1. implementation:

• Зависимость доступна только внутри текущего модуля
• Не экспортируется для других модулей
• Изменение API такой зависимости не вызовет перекомпиляцию зависимых модулей
• Повышает скорость сборки за счет изоляции зависимостей

2. api:

• Зависимость доступна внутри текущего модуля и экспортируется
• Изменение API такой зависимости вызовет перекомпиляцию всех зависимых модулей
• Используется для библиотек, которые являются частью публичного API

3. compile (устаревшая):

• В Gradle 7.0 заменена на implementation и api
• Имела те же возможности, что и api

4. runtimeOnly:

• Зависимость доступна только на рантайме
• Не требуется для компиляции
• Используется для зависимостей, которые нужны только при запуске приложения

Для тестовых конфигураций:

• testImplementation: зависимости для компиляции тестов
• testRuntimeOnly: зависимости для выполнения тестов

Важно правильно выбирать конфигурации для оптимизации сборки и избежания конфликтов зависимостей.

Проблема с конфигурацией testRuntimeOnly в Gradle 7:

После обновления до Gradle 7 и замены testRuntime на testRuntimeOnly в build.gradle возникает ошибка:

“Resolving dependency configuration ‘testRuntimeOnly’ is not allowed as it is defined as ‘canBeResolved=false’”

Причина:

• В Gradle 7 testRuntimeOnly настроен как ‘canBeResolved=false’
• Это означает, что конфигурация не может быть разрешена напрямую
• Вместо этого нужно использовать резолвимую конфигурацию, которая наследует testRuntimeOnly

Решение:

configurations {
 testRuntimeClasspath {
 extendsFrom testRuntimeOnly
 }
}

Или использовать существующую конфигурацию testRuntimeClasspath вместо testRuntimeOnly.

Testing in Java & JVM projects:

Gradle автоматически создает конфигурации зависимостей для тестовых исходников:

• testImplementation: зависимости, требуемые для компиляции тестов
• testRuntimeOnly: зависимости, требуемые только во время выполнения тестов

Важно понимать, что тестовый исходный набор автоматически создает соответствующие конфигурации зависимостей, из которых наиболее полезными являются testImplementation и testRuntimeOnly, которые плагины интегрируют в путь к классам тестовой задачи.

Пример настройки тестовых зависимостей:

dependencies {
 testImplementation 'junit:junit:4.12'
 testRuntimeOnly 'org.junit.vintage:junit-vintage-engine:5.2.0'
}

Эти конфигурации позволяют разделять зависимости, необходимые для компиляции тестов, и зависимости, необходимые только для их выполнения.

Пример использования testRuntimeOnly в контексте JUnit 5:

//(Required) Writing and executing Unit Tests on the JUnit Platform
testImplementation "org.junit.jupiter:junit-jupiter-api:5.2.0"
testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:5.2.0"

// (Optional) If you need "Parameterized Tests"
testImplementation "org.junit.jupiter:junit-jupiter-params:5.2.0"

// (Optional) If you also have JUnit 4-based tests
testImplementation "junit:junit:4.12"
testRuntimeOnly "org.junit.vintage:junit-vintage-engine:5.2.0"

testImplementation "io.mockk:mockk:1.8.5"

Здесь:

• testImplementation используется для API и параметризованных тестов
• testRuntimeOnly используется для движков выполнения тестов
• Это позволяет избежать включения движков в compile classpath