net.twisterrob.gradle

Gradle Quality Plugins

الإضافات التي تقوم بتكوين المكونات الإضافية المدمجة مع Saner Defaults (المراد توثيقها).

• CheckStyle
• PMD
• Android Lint

الهدف الحالي هو جعل دعم Android أفضل ، بسبب أنواع البناء والنكهات.

---

للحصول على تفاصيل حول ما تم تغييره في إصدارات مختلفة ، انظر Changelog.

التوافق

يتم تغطية المكون الإضافي Android Gradle 3.1.4 - 8.7.3 على Gradle 4.9 - 8.9 كما هو مدرج في دليل توافق AGP بواسطة إصدارات مكون الإضافي مختلف.

الإصدار المدعوم حاليًا هو Android Gradle Plugin 7.0.2 - 8.7.3 على Gradle 7.0 - 8.9 حيث متوافق.

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	رشفة.
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 - ∞

• ❓ = لست متأكدًا مما إذا كان مدعومًا من AGP ، ولم يتم اختباره أبدًا.
• = غير متوافق بناءً على توافق AGP.
• رشفة. = مدعوم على أساس توافق AGP ، ولكن لم يتم اختباره.
• N/A = الدعم الكامل غير متوفر حتى الآن ، فقط الدعم الأولي على أساس بنيات ALPHA/BETA من AGP.
• ∞ = أحدث إصدار
• ^1 = Gradle 4.4 - 4.9 لـ AGP 3.2 لم يتم دعمها أبدًا ، لأنه من الصعب خلفية واجهات برمجة تطبيقات تكوين المهمة البطيئة.
• ^2 = المكونات الإضافية للاتفاقية تدعم فقط AGP 4.0.0 - 4.2.2 على Gradle 6.1.1+ ، لأنه من الصعب حقًا خلفية جميع الميزات إلى 3.x دون حاجة لذلك.
• ^3 = الإصدار 0.16 تم إسقاط دعم AGP 3.x - 4.x على Gradle 5.x - 7.x ، لجعل هذا المشروع أسهل في الحفاظ عليه.

إعداد سريع

هناك طرق مختلفة لاستخدام البرنامج المساعد Gradle ، اختر السم الخاص بك أدناه.

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 "

لمعرفة المزيد ، انظر مجلد الأمثلة.

سمات

تقرير انتهاك HTML

هناك تقرير HTML مدمج يجمع جميع النتائج من جميع الوحدات في ملف HTML واحد.

gradlew :violationReportHtml

تقرير انتهاك وحدة التحكم

هناك تقرير وحدة تحكم مدمج يجمع جميع النتائج من جميع الوحدات النمطية والمخرجات إلى وحدة التحكم.

gradlew :violationReportConsole

تقرير انتهاك العد إلى ملف

إنه يحفظ عدد الانتهاكات في ملف. جيد للأتمتة.

gradlew :violationCountFile

فشل في البناء على الانتهاك

يفشل فقط إذا كانت هناك انتهاكات.

gradlew :validateViolations

تقرير اختبار مشروع الجذر

تجمع النتائج من العارض الفرعي ويفشل إذا كانت هناك أخطاء.

 gradlew :testReport

ملاحظة: هذا يغير :*:test لعدم الفشل بحيث يمكن إنشاء تقرير شامل.

Finalizer العالمي :lint

يعتمد على جميع العتبات الأخرى ويظهر ملخصًا للفشل لتقليل الحاجة إلى التمرير/مسح سجلات الإنشاء. lint تم الاحتجاج بها بشكل صريح مثل gradlew :lint سوف gradlew lint ، وإلا

لتعطيل:

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

مساهمات ، بنيات مخصصة

انظر Development.md حول كيفية تعيين هذا المشروع.