net.twisterrob.gradle

Plugins de qualité gradle

Plugins qui configurent les plugins intégrés avec des paramètres par défaut SANER (à documenter).

• Camion
• PMD
• Android Lint

L'objectif actuel est de mieux prendre le support Android en raison des types de construction et des saveurs.

---

Pour plus de détails sur ce qui a été changé dans différentes versions, voir Changelog.

Compatibilité

Android Gradle Plugin 3.1.4 - 8.7.3 sur Gradle 4.9 - 8.9 tel que répertorié dans le guide de compatibilité d'AGP est couvert par différentes versions de plugin.

La version actuellement prise en charge est le plugin Android Gradle 7.0.2 - 8.7.3 sur Gradle 7.0 - 8.9 où est 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	souper.
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 - ∞

• ❓ = Je ne sais pas s'il est pris en charge par AGP, jamais testé.
• = incompatible en fonction de la compatibilité AGP.
• souper. = pris en charge en fonction de la compatibilité AGP, mais non testée.
• N / A = Support complet non disponible, seulement un support préliminaire basé sur les versions alpha / bêta d'AGP.
• ∞ = dernière version
• ^ 1 = Gradle 4.4 - 4.9 pour AGP 3.2 n'a jamais été pris en charge, car il est difficile de reporter les API de configuration de la tâche paresseuse.
• ^ 2 = Les plugins de la convention ne prennent en charge qu'AGP 4.0.0 - 4.2.2 sur Gradle 6.1.1+, car il est vraiment difficile de reporter toutes les fonctionnalités à 3.x sans avoir besoin de cela.
• ^ 3 = Version 0.16 Abandonné le support pour AGP 3.x - 4.x sur Gradle 5.x - 7.x, pour faciliter la maintenance de ce projet.

Configuration rapide

Il existe différentes façons d'utiliser un plugin Gradle, choisissez votre poison ci-dessous.

moderne build.gradle (.kts) ( plugins )

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

Normal build.gradle (.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 "

Pour en savoir plus, consultez le dossier Exemples.

Caractéristiques

Rapport de violation HTML

Il existe un rapport HTML intégré qui rassemble tous les résultats de tous les modules en un seul fichier HTML.

gradlew :violationReportHtml

Rapport de violation de la console

Il existe un rapport de console intégré qui rassemble tous les résultats de tous les modules et sorties des résultats de la console.

gradlew :violationReportConsole

Rapport de violation de comptage pour déposer

Il enregistre simplement le nombre de violations dans un dossier. Bon pour l'automatisation.

gradlew :violationCountFile

Échec de la construction sur la violation

Il échoue simplement s'il y a des violations.

gradlew :validateViolations

Rapport de test du projet racine

Rassemble des résultats de sous-modules et échoue en cas d'erreurs.

 gradlew :testReport

Remarque: Cela modifie les tâches de test :*:test pour ne pas échouer, donc un rapport englobant entier peut être généré.

Finalizer mondial :lint

Cela dépend de tous les autres peluches et montre un résumé des échecs pour réduire la nécessité de faire défiler / scanner les journaux de construction. S'il est invoqué explicitement en tant que gradlew :lint il échouera, sinon (par exemple, gradlew lint ), il s'ajoute silencieusement à la liste des tâches lint avec les autres et imprime le résumé à la fin.

Désactiver:

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

Contributions, constructions personnalisées

Voir Development.md sur la façon de définir ce projet.