net.twisterrob.gradle

Complementos de calidad de graduación

Complementos que configuran los complementos incorporados con valores predeterminados más sanos (que se documentarán).

• Estilo de control
• PMD
• Pelusa de Android

El objetivo actual es mejorar el soporte de Android, debido a los tipos de compilación y los sabores.

---

Para obtener detalles sobre lo que se cambió en diferentes versiones, consulte ChangeLog.

Compatibilidad

Android Gradle Plugin 3.1.4 - 8.7.3 en Gradle 4.9 - 8.9 tal como se enumera en la guía de compatibilidad de AGP está cubierto por diferentes versiones de complementos.

Actualmente, la versión compatible es Android Gradle Plugin 7.0.2 - 8.7.3 en Gradle 7.0 - 8.9 donde es compatible.

AGP → Gradle ↓	3.1.x	3.2.x	3.3.x	3.4.x	3.5.x	3.6.x	4.0.x	4.1.x	4.2.x ^3	7.0.x	7.1.x	7.2.x	7.3.x	7.4.x	8.0.x	8.1.x	8.2.x	8.3.x	8.4.x
4.4 - 4.8.1	0.5 - 0.7	^1
4.9 - 4.10	0.8 - 0.14	0.7 - 0.14
4.10.1 - 5.1	❓	0.8 - 0.14	0.8 - 0.14
5.1.1 - 5.4	❓	❓	0.9 - 0.14	0.9 - 0.15.1
5.4.1 - 5.6.3	❓	❓	0.9 - 0.15.1	0.9 - 0.15.1	sorber.
5.6.4	❓	❓	❓	❓	0.10 - 0.15.1	0.10 - 0.15.1
6.0 - 6.1	❓	❓	❓	❓	0.11 - 0.15.1	0.11 - 0.15.1
6.1.1 - 6.4.1	❓	❓	❓	❓	0.11 - 0.15.1	0.11 - 0.15.1	0.11 - 0.15.1
6.5 - 6.7	❓	❓	❓	❓	0.11 - 0.15.1	0.11 - 0.15.1	0.11 - 0.15.1	0.11 - 0.15.1
6.7.1 - 6.9.4 ^3	❓	❓	❓	❓	❓	❓	❓	0.11 - 0.15.1	0.11 - 0.15.1
7.0 - 7.1.2	❓	❓	❓	❓	❓	❓	❓	❓	0.13 - 0.15.1	0.13 - ∞
7.2	❓	❓	❓	❓	❓	❓	❓	❓	0.13 - 0.15.1	0.13 - ∞	0.14 - ∞
7.3 - 7.3.3	❓	❓	❓	❓	❓	❓	❓	❓	0.13 - 0.15.1	0.13 - ∞	0.14 - ∞	0.14 - ∞
7.4 - 7.4.2	❓	❓	❓	❓	❓	❓	❓	❓	0.14 - 0.15.1	0.14 - ∞	0.14 - ∞	0.14 - ∞	0.15 - ∞
7.5 - 7.5.1	❓	❓	❓	❓	❓	❓	❓	❓	0.14 - 0.15.1	0.14 - ∞	0.14 - ∞	0.14 - ∞	0.15 - ∞	0.15 - ∞
7.6 - 7.6.1	❓	❓	❓	❓	❓	❓	❓	❓	0.14 - 0.15.1	0.14 - ∞	0.14 - ∞	0.14 - ∞	0.15 - ∞	0.15 - ∞
8.0 - 8.2	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	0.15 - ∞	0.16 - ∞	0.16 - ∞
8.3	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	0.17 - ∞	0.17 - ∞	0.17 - ∞	0.17 - ∞
8.4 - 8.5	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	0.17 - ∞	0.17 - ∞	0.17 - ∞	0.17 - ∞	0.17 - ∞
8.6 - 8.7	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	0.17 - ∞	0.17 - ∞	0.17 - ∞	0.17 - ∞	0.17 - ∞	0.17 - ∞
8.8 - 8.9	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	0.18 - ∞	0.18 - ∞	0.18 - ∞	0.18 - ∞	0.18 - ∞	0.18 - ∞

• ❓ = No estoy seguro si es compatible con AGP, nunca se prueba.
• = incompatible basado en la compatibilidad AGP.
• sorber. = admitido basado en la compatibilidad AGP, pero no probado.
• N/A = soporte completo aún no disponible, solo soporte preliminar basado en construcciones alfa/beta de AGP.
• ∞ = última versión
• ^1 = Gradle 4.4 - 4.9 Para AGP 3.2 nunca fue compatible, porque es difícil respaldar las API de configuración de tareas perezosas.
• ^2 = Los complementos de convenciones solo admiten AGP 4.0.0 - 4.2.2 en el Gradle 6.1.1+, porque es realmente difícil respaldar todas las características a 3.x sin necesidad de esto.
• ^3 = Versión 0.16 Soporte descartado para AGP 3.x - 4.x en el Gradle 5.x - 7.x, para que este proyecto sea más fácil de mantener.

Configuración rápida

Hay diferentes formas de usar un complemento de Gradle, elija su veneno a continuación.

Build Modern.gradle (.kts) ( plugins )

 plugins {
	id( " net.twisterrob.gradle.plugin.quality " ) version " x.y "
}

Build.gradle normal (.kts) ( buildscript )

 buildscript {
	repositories {
		mavenCentral()
	}
	dependencies {
		classpath( " net.twisterrob.gradle:twister-quality:x.y " )
	}
}
// Kotlin
apply(plugin = " net.twisterrob.gradle.plugin.quality " )
// Groovy
apply plugin : " net.twisterrob.gradle.plugin.quality "

BuildSrc classpath

buildSrc/build.gradle(.kts)

 repositories {
	mavenCentral()
}
dependencies {
	implementation( " net.twisterrob.gradle:twister-quality:x.y " )
}

build.gradle(.kts)

 // Kotlin
apply(plugin = " net.twisterrob.gradle.plugin.quality " )
// Groovy
apply plugin : " net.twisterrob.gradle.plugin.quality "

Para más información, vea la carpeta de ejemplos.

Características

Informe de violación de HTML

Hay un informe HTML incorporado que reúne todos los resultados de todos los módulos en un solo archivo HTML.

gradlew :violationReportHtml

Informe de violación de la consola

Hay un informe de la consola incorporado que reúne todos los resultados de todos los módulos y obtiene resultados a la consola.

gradlew :violationReportConsole

Informe de violación de cuenta de cuenta para archivar

Simplemente guarda el número de violaciones en un archivo. Bueno para la automatización.

gradlew :violationCountFile

Fallar en la construcción de la violación

Simplemente falla si hay violaciones.

gradlew :validateViolations

Informe de la prueba del proyecto raíz

Reúne los resultados de los submódulos y falla si hubo errores.

 gradlew :testReport

NOTA: Esto cambia las tareas de prueba :*:test para no fallar, por lo que se puede generar un informe completo que abarca un informe.

Finalizador global :lint

Depende de todas las demás peluches y muestra un resumen de fallas para reducir la necesidad de desplazar/escanear los registros de compilación. Si se invoca explícitamente como gradlew :lint fallará, de lo contrario (por ejemplo, gradlew lint ) se suma en silencio a la lista de tareas lint junto con las otras e imprime el resumen al final.

Para deshabilitar:

 afterEvaluate { tasks . named( " lint " ) . configure { it . enabled = false } }

Contribuciones, compilaciones personalizadas

Vea Development.md sobre cómo configurar este proyecto.