net.twisterrob.gradle

Plugins de qualidade gradle

Plugins que configuram os plugins embutidos com padrões SANER (a serem documentados).

• Checkstyle
• PMD
• Android fiado

O objetivo atual é melhorar o suporte do Android, devido aos tipos de construção e sabores.

---

Para detalhes sobre o que foi alterado em diferentes versões, consulte Changelog.

Compatibilidade

Android Gradle Plugin 3.1.4 - 8.7.3 No Gradle 4.9 - 8.9, conforme listado no Guia de Compatibilidade da AGP, são cobertos por diferentes versões do plug -in.

A versão atualmente suportada são o plug -in Android Gradle 7.0.2 - 8.7.3 no Gradle 7.0 - 8.9, onde compatível.

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	e aí.
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 - ∞

• ❓ = Não tenho certeza se é suportado pelo AGP, nunca testado.
• = incompatível com base na compatibilidade do AGP.
• e aí. = suportado com base na compatibilidade do AGP, mas não testado.
• N/A = Suporte completo ainda não está disponível, apenas suporte preliminar com base nas compilações alfa/beta do AGP.
• ∞ = versão mais recente
• ^1 = Gradle 4.4 - 4.9 para AGP 3.2 nunca foi suportado, porque é difícil apoiar as APIs de configuração de tarefas preguiçosas.
• ^2 = Os plug -ins de convenção suportam apenas o AGP 4.0.0 - 4.2.2 no gradle 6.1.1+, porque é realmente difícil fazer backport todos os recursos para 3.x sem necessidade disso.
• ^3 = Versão 0.16 Suporte descartado para AGP 3.x - 4.x no gradle 5.x - 7.x, para facilitar a manutenção deste projeto.

Configuração rápida

Existem diferentes maneiras de usar um plug -in gradle, escolha seu veneno abaixo.

Modern 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 "

Para mais informações, consulte a pasta Exemplos.

Características

Relatório de violação HTML

Há um relatório HTML interno que reúne todos os resultados de todos os módulos em um único arquivo HTML.

gradlew :violationReportHtml

Relatório de violação do console

Há um relatório de console interno que reúne todos os resultados de todos os resultados dos módulos e saídas para o console.

gradlew :violationReportConsole

Relatório de violação da contagem para arquivo

Isso apenas salva o número de violações em um arquivo. Bom para automação.

gradlew :violationCountFile

Falhar na construção de violação

Apenas falha se houver violações.

gradlew :validateViolations

Relatório de teste do projeto raiz

Os resultados dos fundos de submódulos e falham se houver erros.

 gradlew :testReport

NOTA: Isso altera as tarefas :*:test de teste para não falhar para que um projeto inteiro que abrange o relatório possa ser gerado.

Finalizador global :lint

Depende de todos os outros fiapos e mostra um resumo das falhas para reduzir a necessidade de rolar/digitalizar os logs de construção. Se chamado explicitamente como gradlew :lint ele falhará, caso contrário (por exemplo, gradlew lint ), ele se adicionará silenciosamente à lista de tarefas lint junto com os outros e imprime o resumo no final.

Para desativar:

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

Contribuições, construções personalizadas

Consulte Development.md sobre como definir este projeto.