Merge pull request #1529 from davidburstrom/main-explain-plugin-listing

Explain why the plugins get listed in the root project build script
android · Sep 29, 2024 · c4ebde1 · c4ebde1
2 parents c79b1a3 + cde1607
commit c4ebde1
Showing 1 changed file with 7 additions and 1 deletion.
diff --git a/build.gradle.kts b/build.gradle.kts
@@ -30,7 +30,13 @@ buildscript {
 
 }
 
-// Lists all plugins used throughout the project
+/*
+ * By listing all the plugins used throughout all subprojects in the root project build script, it
+ * ensures that the build script classpath remains the same for all projects. This avoids potential
+ * problems with mismatching versions of transitive plugin dependencies. A subproject that applies
+ * an unlisted plugin will have that plugin and its dependencies _appended_ to the classpath, not
+ * replacing pre-existing dependencies.
+ */
 plugins {
     alias(libs.plugins.android.application) apply false
     alias(libs.plugins.android.library) apply false