From cbc111346d758019c9444fd9571118ce77c7ecf3 Mon Sep 17 00:00:00 2001 From: Zac Sweers Date: Tue, 19 Nov 2024 14:01:11 -0500 Subject: [PATCH] Deployed 7910f4f1 with MkDocs version: 1.6.1 --- .../-aggregate-module-score.html | 2 +- .../-aggregate-module-score/index.html | 2 +- .../-aggregate-module-score/scores.html | 2 +- .../-module-score/-module-score.html | 2 +- .../-module-score/includes-generated.html | 2 +- .../-module-score/index.html | 2 +- .../-module-score/module-name.html | 2 +- .../-module-score/score.html | 2 +- .../-module-score/weights.html | 2 +- .../-module-stats-aggregator-task.html | 2 +- .../-module-stats-aggregator-task/index.html | 2 +- .../output-file.html | 2 +- .../-weights/-weights.html | 2 +- .../-weights/centrality.html | 2 +- .../foundry.gradle.stats/-weights/index.html | 2 +- .../-weights/java-kotlin-ratio.html | 2 +- .../-weights/loc-generated.html | 2 +- .../foundry.gradle.stats/-weights/loc.html | 2 +- .../-weights/module-path.html | 2 +- .../-weights/percent-of-total-code.html | 2 +- .../foundry.gradle.stats/-weights/score.html | 2 +- .../foundry.gradle.stats/-weights/tags.html | 2 +- .../-module-topography-task.html | 2 +- .../-module-topography-task/compute.html | 2 +- .../-module-topography-task/features.html | 2 +- .../-module-topography-task/index.html | 2 +- .../plugins-property.html | 2 +- .../-module-topography-task/project-name.html | 2 +- .../-module-topography-task/project-path.html | 2 +- .../topography-output-file.html | 2 +- .../-validate-module-topography-task.html | 2 +- .../auto-fix.html | 2 +- .../features-config-file.html | 2 +- .../features-to-remove-output-file.html | 2 +- .../index.html | 2 +- .../modified-build-file.html | 2 +- .../project-dir-property.html | 2 +- .../topography-json.html | 2 +- .../validate.html | 2 +- changelog/index.html | 23 ++++++++++++++++++ search/search_index.json | 2 +- sitemap.xml.gz | Bin 127 -> 127 bytes 42 files changed, 63 insertions(+), 40 deletions(-) diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/-aggregate-module-score.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/-aggregate-module-score.html index 334104cb4..bd9fd72da 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/-aggregate-module-score.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/-aggregate-module-score.html @@ -65,7 +65,7 @@

AggregateModuleScore

-
constructor(scores: List<ModuleScore>)(source)
+
constructor(scores: List<ModuleScore>)(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/index.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/index.html index 92df7158a..b2d3865ab 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/index.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/index.html @@ -64,7 +64,7 @@
foundry-gradle-plugin/foundry.gradle.stats/AggregateModuleScore

AggregateModuleScore

-
@JsonClass(generateAdapter = true)
data class AggregateModuleScore(val scores: List<ModuleScore>)(source)
+
@JsonClass(generateAdapter = true)
data class AggregateModuleScore(val scores: List<ModuleScore>)(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/scores.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/scores.html index 9ecd9725f..260520aee 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/scores.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-aggregate-module-score/scores.html @@ -65,7 +65,7 @@

scores

-
val scores: List<ModuleScore>(source)
+
val scores: List<ModuleScore>(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/-module-score.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/-module-score.html index f41ff26c7..b6d79ad24 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/-module-score.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/-module-score.html @@ -65,7 +65,7 @@

ModuleScore

-
constructor(moduleName: String, score: Long, weights: Weights, includesGenerated: Boolean)(source)
+
constructor(moduleName: String, score: Long, weights: Weights, includesGenerated: Boolean)(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/includes-generated.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/includes-generated.html index eb0ed3899..c877e740e 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/includes-generated.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/includes-generated.html @@ -65,7 +65,7 @@

includesGenerated

-
val includesGenerated: Boolean(source)
+
val includesGenerated: Boolean(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/index.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/index.html index f2053605e..83d895c5a 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/index.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/index.html @@ -64,7 +64,7 @@
foundry-gradle-plugin/foundry.gradle.stats/ModuleScore

ModuleScore

-
@JsonClass(generateAdapter = true)
data class ModuleScore(val moduleName: String, val score: Long, val weights: Weights, val includesGenerated: Boolean)(source)
+
@JsonClass(generateAdapter = true)
data class ModuleScore(val moduleName: String, val score: Long, val weights: Weights, val includesGenerated: Boolean)(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/module-name.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/module-name.html index aa9d8dcf2..e0bf7eb3a 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/module-name.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/module-name.html @@ -65,7 +65,7 @@

moduleName

-
val moduleName: String(source)
+
val moduleName: String(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/score.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/score.html index 484160156..e8fbec1ff 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/score.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/score.html @@ -65,7 +65,7 @@

score

-
val score: Long(source)
+
val score: Long(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/weights.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/weights.html index da930a0a2..15096f939 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/weights.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-score/weights.html @@ -65,7 +65,7 @@

weights

-
val weights: Weights(source)
+
val weights: Weights(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/-module-stats-aggregator-task.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/-module-stats-aggregator-task.html index 21eac4eff..061536709 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/-module-stats-aggregator-task.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/-module-stats-aggregator-task.html @@ -65,7 +65,7 @@

ModuleStatsAggregatorTask

-
constructor()(source)
+
constructor()(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/index.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/index.html index 815632e00..e778f49dd 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/index.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/index.html @@ -64,7 +64,7 @@
foundry-gradle-plugin/foundry.gradle.stats/ModuleStatsAggregatorTask

ModuleStatsAggregatorTask

-
@CacheableTask
abstract class ModuleStatsAggregatorTask : DefaultTask(source)
+
@CacheableTask
abstract class ModuleStatsAggregatorTask : DefaultTask(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/output-file.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/output-file.html index f3a3c4fbf..c027a2cff 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/output-file.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-module-stats-aggregator-task/output-file.html @@ -65,7 +65,7 @@

outputFile

-
@get:OutputFile
abstract val outputFile: RegularFileProperty(source)
+
@get:OutputFile
abstract val outputFile: RegularFileProperty(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/-weights.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/-weights.html index c946ff1ad..dfed58ca7 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/-weights.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/-weights.html @@ -65,7 +65,7 @@

Weights

-
constructor(percentOfTotalCode: Double, javaKotlinRatio: Double, centrality: Double, loc: Int, locGenerated: Int, tags: Set<String>, modulePath: String)(source)
+
constructor(percentOfTotalCode: Double, javaKotlinRatio: Double, centrality: Double, loc: Int, locGenerated: Int, tags: Set<String>, modulePath: String)(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/centrality.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/centrality.html index 558f731bd..b37ce8859 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/centrality.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/centrality.html @@ -65,7 +65,7 @@

centrality

-
val centrality: Double(source)
+
val centrality: Double(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/index.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/index.html index b7222743f..f15f8d189 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/index.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/index.html @@ -64,7 +64,7 @@
foundry-gradle-plugin/foundry.gradle.stats/Weights

Weights

-
@JsonClass(generateAdapter = true)
data class Weights(val percentOfTotalCode: Double, val javaKotlinRatio: Double, val centrality: Double, val loc: Int, val locGenerated: Int, val tags: Set<String>, val modulePath: String)(source)
+
@JsonClass(generateAdapter = true)
data class Weights(val percentOfTotalCode: Double, val javaKotlinRatio: Double, val centrality: Double, val loc: Int, val locGenerated: Int, val tags: Set<String>, val modulePath: String)(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/java-kotlin-ratio.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/java-kotlin-ratio.html index cd96b6de8..514fcdef9 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/java-kotlin-ratio.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/java-kotlin-ratio.html @@ -65,7 +65,7 @@

javaKotlinRatio

-
val javaKotlinRatio: Double(source)
+
val javaKotlinRatio: Double(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/loc-generated.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/loc-generated.html index 5efb66753..05845b467 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/loc-generated.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/loc-generated.html @@ -65,7 +65,7 @@

locGenerated

-
val locGenerated: Int(source)
+
val locGenerated: Int(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/loc.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/loc.html index daf8bf759..07ca6994c 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/loc.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/loc.html @@ -65,7 +65,7 @@

loc

-
val loc: Int(source)
+
val loc: Int(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/module-path.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/module-path.html index 1d5f07a3d..148e75c32 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/module-path.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/module-path.html @@ -65,7 +65,7 @@

modulePath

-
val modulePath: String(source)
+
val modulePath: String(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/percent-of-total-code.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/percent-of-total-code.html index 051e08486..f2c102203 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/percent-of-total-code.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/percent-of-total-code.html @@ -65,7 +65,7 @@

percentOfTotalCode

-
val percentOfTotalCode: Double(source)
+
val percentOfTotalCode: Double(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/score.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/score.html index 0bc073533..83ef4ac22 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/score.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/score.html @@ -65,7 +65,7 @@

score

-
fun score(): Long(source)
+
fun score(): Long(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/tags.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/tags.html index da773f63d..2e4e6dc42 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/tags.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.stats/-weights/tags.html @@ -65,7 +65,7 @@

tags

-
val tags: Set<String>(source)
+
val tags: Set<String>(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/-module-topography-task.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/-module-topography-task.html index d1e51bbe3..6ee24bfc5 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/-module-topography-task.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/-module-topography-task.html @@ -65,7 +65,7 @@

ModuleTopographyTask

-
constructor()(source)
+
constructor()(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/compute.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/compute.html index 7e4917305..2070dc059 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/compute.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/compute.html @@ -65,7 +65,7 @@

compute

-
fun compute()(source)
+
fun compute()(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/features.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/features.html index 0a2952de1..2b1de615f 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/features.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/features.html @@ -65,7 +65,7 @@

features

-
@get:Input
@get:Optional
abstract val features: MapProperty<String, Boolean>(source)
+
@get:Input
@get:Optional
abstract val features: MapProperty<String, Boolean>(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/index.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/index.html index 9e9214859..4a46f98fa 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/index.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/index.html @@ -64,7 +64,7 @@
foundry-gradle-plugin/foundry.gradle.topography/ModuleTopographyTask

ModuleTopographyTask

-
@CacheableTask
abstract class ModuleTopographyTask : DefaultTask(source)
+
@CacheableTask
abstract class ModuleTopographyTask : DefaultTask(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/plugins-property.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/plugins-property.html index facc852fd..4934593ef 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/plugins-property.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/plugins-property.html @@ -65,7 +65,7 @@

pluginsProperty

-
@get:Input
@get:Optional
abstract val pluginsProperty: SetProperty<String>(source)
+
@get:Input
@get:Optional
abstract val pluginsProperty: SetProperty<String>(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/project-name.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/project-name.html index c82fe33fe..0ce23177d 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/project-name.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/project-name.html @@ -65,7 +65,7 @@

projectName

-
@get:Input
abstract val projectName: Property<String>(source)
+
@get:Input
abstract val projectName: Property<String>(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/project-path.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/project-path.html index 0e2041681..b13fa0251 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/project-path.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/project-path.html @@ -65,7 +65,7 @@

projectPath

-
@get:Input
abstract val projectPath: Property<String>(source)
+
@get:Input
abstract val projectPath: Property<String>(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/topography-output-file.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/topography-output-file.html index 87b741ed9..7d4fbb992 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/topography-output-file.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-module-topography-task/topography-output-file.html @@ -65,7 +65,7 @@

topographyOutputFile

-
@get:OutputFile
abstract val topographyOutputFile: RegularFileProperty(source)
+
@get:OutputFile
abstract val topographyOutputFile: RegularFileProperty(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/-validate-module-topography-task.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/-validate-module-topography-task.html index 81f866559..a5c3ec4cb 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/-validate-module-topography-task.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/-validate-module-topography-task.html @@ -65,7 +65,7 @@

ValidateModuleTopographyTask

-
constructor()(source)
+
constructor()(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/auto-fix.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/auto-fix.html index 4c33aec10..fe6734511 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/auto-fix.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/auto-fix.html @@ -65,7 +65,7 @@

autoFix

-
@get:Optional
@get:Input
abstract val autoFix: Property<Boolean>(source)
+
@get:Optional
@get:Input
abstract val autoFix: Property<Boolean>(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/features-config-file.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/features-config-file.html index a1005280d..ffca7fcb3 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/features-config-file.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/features-config-file.html @@ -65,7 +65,7 @@

featuresConfigFile

-
@get:InputFile
@get:PathSensitive(value = PathSensitivity.NONE)
@get:Optional
abstract val featuresConfigFile: RegularFileProperty(source)
+
@get:InputFile
@get:PathSensitive(value = PathSensitivity.NONE)
@get:Optional
abstract val featuresConfigFile: RegularFileProperty(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/features-to-remove-output-file.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/features-to-remove-output-file.html index 617f09bf3..47ab06f1e 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/features-to-remove-output-file.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/features-to-remove-output-file.html @@ -65,7 +65,7 @@

featuresToRemoveOutputFile

-
@get:OutputFile
abstract val featuresToRemoveOutputFile: RegularFileProperty(source)
+
@get:OutputFile
abstract val featuresToRemoveOutputFile: RegularFileProperty(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/index.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/index.html index e7f638f36..f96ce86f8 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/index.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/index.html @@ -64,7 +64,7 @@
foundry-gradle-plugin/foundry.gradle.topography/ValidateModuleTopographyTask

ValidateModuleTopographyTask

-
@DisableCachingByDefault
abstract class ValidateModuleTopographyTask : DefaultTask(source)
+
@DisableCachingByDefault
abstract class ValidateModuleTopographyTask : DefaultTask(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/modified-build-file.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/modified-build-file.html index b61291e95..710292db4 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/modified-build-file.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/modified-build-file.html @@ -65,7 +65,7 @@

modifiedBuildFile

-
@get:OutputFile
abstract val modifiedBuildFile: RegularFileProperty(source)
+
@get:OutputFile
abstract val modifiedBuildFile: RegularFileProperty(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/project-dir-property.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/project-dir-property.html index 34744cc6d..776144abb 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/project-dir-property.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/project-dir-property.html @@ -65,7 +65,7 @@

projectDirProperty

-
@get:Internal
abstract val projectDirProperty: DirectoryProperty(source)
+
@get:Internal
abstract val projectDirProperty: DirectoryProperty(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/topography-json.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/topography-json.html index 18e82cf03..9298f2ccc 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/topography-json.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/topography-json.html @@ -65,7 +65,7 @@

topographyJson

-
@get:InputFile
@get:PathSensitive(value = PathSensitivity.NONE)
abstract val topographyJson: RegularFileProperty(source)
+
@get:InputFile
@get:PathSensitive(value = PathSensitivity.NONE)
abstract val topographyJson: RegularFileProperty(source)
diff --git a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/validate.html b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/validate.html index 6426040ce..5a24f30dd 100644 --- a/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/validate.html +++ b/api/0.x/platforms/gradle/foundry-gradle-plugin/foundry.gradle.topography/-validate-module-topography-task/validate.html @@ -65,7 +65,7 @@

validate

-
fun validate()(source)
+
fun validate()(source)
diff --git a/changelog/index.html b/changelog/index.html index cd5d23a71..c13b19767 100644 --- a/changelog/index.html +++ b/changelog/index.html @@ -600,6 +600,15 @@ + + +
  • + + + 0.22.5 + + +
  • @@ -1999,6 +2008,15 @@ +
    • + +
  • + + + 0.22.5 + + +
  • @@ -3317,6 +3335,11 @@

    Changelog

    Unreleased

    +

    0.22.5

    +

    2024-11-19

    +
      +
    • [gradle] Make LocTask.generatedSrcsDir @Internal to avoid depending implicitly on outputs of tasks that sometimes only just make empty dirs with no files.
      • +

    0.22.4

    2024-11-15

      diff --git a/search/search_index.json b/search/search_index.json index d50a12a81..4a1779606 100644 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"foundry","text":"

      This repository contains much of Slack\u2019s Android/Kotlin/JVM tooling for Gradle, IntelliJ, CLIs, and more.

      This repo is effectively for Slack\u2019s own used but publishes to Maven Central. We develop these in the open to knowledge-share with the community.

      As such, we don\u2019t normally accept external PRs, but we welcome your questions in the discussions section of the project!

      "},{"location":"#highlights","title":"Highlights","text":""},{"location":"#common-project-configuration","title":"Common project configuration","text":"

      The foundry.base plugin offers common configuration for all projects implementing it, covering a wide spectrum of Android, Kotlin, and Java configurations.

      This includes a whole host of things!

      • Common Android configuration (single variant libraries, disabling unused features, compose, etc).
      • Common Kotlin configuration (freeCompilerArgs, JVM target, etc).
      • Common Java configuration (toolchains, release versions, etc).
      • Common annotation processors.
      • FoundryExtension (see next section).
      • Formatting (via Spotless).
      • Platforms and BOM dependencies (see \u201cPlatform plugins\u201d section below).
      • Common lint checks (both on Android and plain JVM projects).

      Full docs can be found in the architecture docs.

      "},{"location":"#feature-dsl","title":"Feature DSL","text":"

      To ease use and configuration of common features in projects, we expose a foundry DSL in projects that allows for configuration of these in a semantically easy and boilerplate-free way. This is controlled via FoundryExtension.

      foundry {\n  features {\n    dagger()\n    moshi(codegen = true)\n  }\n  android {\n    features {\n      robolectric()\n    }\n  }\n}\n

      A major benefit of this is that we can intelligently configure features and avoid applying costly plugins like Kapt unless they\u2019re actually needed for a specific feature, such as Java injections in projects using Dagger. Since this is pure code, we can also propagate deprecated behavior by deprecating the corresponding functions in the DSL.

      "},{"location":"#platform-plugins","title":"Platform plugins","text":"

      Platforms.kt contains an implementation that sources a VersionCatalog and applies it to a Gradle platform project. This allows us to effectively treat our versions catalog as a BOM and apply it to all projects in the consuming repo and reduce dependency version stratification.

      "},{"location":"#thermal-throttling-capture","title":"Thermal throttling capture","text":"

      MacBooks can suffer thermal throttling and result in poor build performance. We built instrumentation for this to capture these and include them in our build scans to better understand their impact. We support both Intel and Apple Silicon macs now and contain this implementation in ThermalsWatcher.kt. This also includes helpful charting APIs for visualizing the data (courtesy of our friends at Square).

      "},{"location":"#better-properties","title":"Better Properties","text":"

      Gradle\u2019s built-in property support is limited and has surprising behavior, so we have our own system on top of it that has consistent precedence, local.properties support, project-local gradle.properties, and configuration caching support. Check out PropertyResolver.

      "},{"location":"#dependency-rake","title":"Dependency Rake","text":"

      DependencyRake.kt contains an extension to the gradle-dependency-analysis-plugin that applies its advice to a project to automatically optimize it and rake dependencies.

      "},{"location":"#module-stats-aka-mod-score","title":"Module Stats (aka \u201cMod Score\u201d)","text":"

      As a part of our modularization efforts, we developed a scoring mechanism for modules that we could use as a measure of their \u201cmodularization\u201d. This includes a number of metrics and weighs them in a formula to compute a score. This includes LoC, language mixtures, and build graph centrality. This logic is under the foundry.stats package.

      "},{"location":"#robolectric-jars-management","title":"Robolectric Jars Management","text":"

      Robolectric uses preinstrumented Android API jars that live on maven central. While it can handle downloading of these automatically, we found this implementation to be brittle and unreliable, so we built our own version of it that handles downloading these into a local .cache directory. This implementation lives in UpdateRobolectricJarsTask.kt and that task is configured to be a dependency of all Test tasks.

      "},{"location":"#bootstrap","title":"Bootstrap","text":"

      We try to simplify and streamline the bootstrap process for both local development and on CI. This involves computing optimized JVM arguments for the Gradle and Kotlin daemons (which differ between CI and local) as well as toe-holds for future customizations. This logic lives in BootstrapTask.kt.

      "},{"location":"#permission-checks","title":"Permission Checks","text":"

      To avoid accidentally checking in any new, unexpected manifest permissions, we have a CheckManifestPermissionsTask that compares the final merged manifest\u2019s permissions to an allow list of known permissions. This is allow list is checked in and expected to be guarded by a CODEOWNERS watch and will fail the build if they differ.

      slack {\n  android {\n    app {\n      permissionAllowlist {\n        if (name == \"externalRelease\") {\n          setAllowlistFile(file(\"permissionsAllowlist.txt\"))\n        }\n      }\n    }\n  }\n}\n
      "},{"location":"#apk-versioning-computers","title":"APK Versioning Computers","text":"

      AGP offers new property-based APIs for computing APK version codes and version names. We use this to compute information from different inputs (CI build number, git state, etc) and control this logic in ApkVersioningPlugin.kt.

      "},{"location":"#check-dependency-versions","title":"Check dependency versions","text":"

      Sometimes a dependency update may bring with it a surprise update to a transitive dependency that we also declare. In order to avoid this happening unexpectedly, the CheckDependencyVersionsTask checks that any transitive dependency versions that also correspond to a version declared in our VersionCatalog match the version there. It\u2019s ok if they don\u2019t, but the author just need to update the version in the catalog too to be explicit (or investigate further if it\u2019s an unwanted surprise!).

      "},{"location":"#agp-handlers","title":"AGP Handlers","text":"

      AGP occasionally contains new or breaking API changes that we want to handle gracefully in early testing. We regularly test against newer preview versions of AGP so we can\u2019t just hardcode in new APIs and expect them to work everywhere. To handle this, we have an AgpHandler interface that can be used to abstract these new APIs in a backward-compatible way. Then we ship implementations of this as different artifacts that are built against different AGP versions. Then, at runtime, we pick the appropriate instance (via service loading) to use for the current AGP version being used in that build.

      "},{"location":"#detekt-baselining","title":"Detekt baselining","text":"

      Detekt is a static analysis tool that we use to check for common issues in our code. We use one global baseline file for baselined issues (when introducing new checks or updates), but Detekt doesn\u2019t currently support this easily. So, we built MergeDetektBaselinesTask to merge all the generated baselines from each subproject into a single global baseline.

      "},{"location":"#misc-tools","title":"Misc tools","text":"

      There are a ton of miscellaneous tools, utilities, and glue code for Gradle (and various plugins) sprinkled throughout this project.

      "},{"location":"#usage-requirements","title":"Usage requirements","text":"

      SGP expects there to be a libs version catalog.

      The following versions are required to be set the above catalog. Their docs can be found in FoundryVersions.kt.

      For Android projects, some extra definitions need to be defined

      • libs.versions.toml libraries
        • google-coreLibraryDesugaring - the core library desugaring libraries to use with L8.
      • gradle.properties properties
        • foundry.compileSdkVersion
        • foundry.targetSdkVersion
        • foundry.minSdkVersion

      The following plugins are applied by default but can be disabled if you don\u2019t need them.

      • Gradle\u2019s test retry \u2013 foundry.auto-apply.test-retry
        • By default, this uses the Gradle test-retry plugin, but can be configured to use the Gradle Enterprise plugin\u2019s implementation instead by setting the foundry.test.retry.pluginType property to GE.
      • Spotless \u2013 foundry.auto-apply.spotless
      • Detekt \u2013 foundry.auto-apply.detekt
      • NullAway \u2013 foundry.auto-apply.nullaway
      • Android Cache Fix \u2013 foundry.auto-apply.cache-fix
      "},{"location":"#commit-hooks","title":"Commit hooks","text":"

      The installCommitHooks task can install commit hooks for formatting kotlin and java files. They expect binaries to be in <root>/config/git/hooks and it\u2019s highly recommended to enable git-lfs for these objects. These binaries can be downloaded via the updateKtfmt, updateGjf, etc tasks.

      "},{"location":"#license","title":"License","text":"
      Copyright 2022 Slack Technologies, LLC\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n
      "},{"location":"changelog/","title":"Changelog","text":""},{"location":"changelog/#unreleased","title":"Unreleased","text":""},{"location":"changelog/#0224","title":"0.22.4","text":"

      2024-11-15

      • [gradle] Improve Detekt configuration to better ignore generated source files.
      • [gradle] Add skippy support to validateModuleTopography. Now there are globalCiValidateModuleTopography and ciValidateModuleTopography tasks.
      • [gradle] Use mustRunAfter for depending on source gen tasks + add back sqldelight\u2019s schema task as a source-generating task.
      • [gradle] Improve compose matching text to include .setContent {.
      • [gradle] Support custom configurations and overrides of ModuleTopography features via JSON file specified by the foundry.topography.features.config property.
      • Update kaml to 0.65.0.
      • Build against develocity plugin 3.18.2.
      • Build against Roborazzi plugin 1.32.2.
      "},{"location":"changelog/#0223","title":"0.22.3","text":"

      2024-11-13

      • [gradle] Only make LocTask depend on source-generating tasks if MODULE_SCORE_INCLUDE_GENERATED is true.
      "},{"location":"changelog/#0222","title":"0.22.2","text":"

      2024-11-13

      • [gradle] Fix dependencies on source-generating tasks in module stats and topography.
      "},{"location":"changelog/#0221","title":"0.22.1","text":"

      2024-11-12

      • [gradle] Fix FoundryProperties hierarchical init.
      "},{"location":"changelog/#0220","title":"0.22.0","text":"

      2024-11-12

      • [gradle] Introduce new moduleTopography task. This is a general task that attempts to validate project configurations by looking for features that are enabled but unused. Currently covers a few core features like kapt, ksp, moshi code gen, dagger/anvil, and viewbinding. Outputs are printed and written to a JSON file. Add --validate-all to make the tasks fail on validation issues.
      • [gradle] Cache global FoundryProperties instance for subproject use.
      • [gradle] Add composeRuntimeOnly() DSL feature.
      • [cli] Check for non-existent paths before traversing in Path.walkEachFile().
      • [gradle] Don\u2019t depend on build sources in mod score if MODULE_SCORE_INCLUDE_GENERATED is false
      • [gradle] Source module topography in mod score stats collecting
      • [gradle] Build against Gradle 8.11.
      • [gradle] Do not track state in RakeDependencies task.
      • Update to KotlinPoet 2.0.0.
      • Update to xmlutil 0.90.3.
      • Update to kaml 0.62.2.
      • Update to Mordant 3.0.1.
      • Build against gradle-dependency-sorter 0.12.
      • Build against KSP 2.0.21-1.0.27.
      • Build against DAGP 2.4.2.
      • Build against Compose Multiplatform 1.7.0.
      "},{"location":"changelog/#0210","title":"0.21.0","text":"

      2024-10-25

      • New: Extract better-gradle-properties artifact, which is our hierarchical Gradle properties solution that better handles properties in Gradle. This is what powers FoundryProperties but is now extracted to be more portable.
      • This checks in the following order of priority
        • project-local local.properties
        • project-local gradle.properties
        • root-project local.properties
        • root-project/global gradle.properties
      • New: Extract version-number artifact. This contains a Kotlin, non-deprecated VersionNumber API. This is useful given that Gradle\u2019s is both deprecated and not available in standard JVM projects.
      • New: Support Robolectric 4.14.
      • Changed: Remove defunct foundry.git.hooksPath and foundry.git.ignoreRevsFile properties.
      • Changed: Rename SgpArtifact to FoundryArtifact.
      • Misc doc fixes + reorganize docsite around new repo structure.
      • Update xmlutil to 0.90.2.
      • Build against Spotless 7.0.0.BETA4.
      • Build against KSP 2.0.21-1.0.26.
      • Build against DAGP 2.2.0.
      • Build against nullaway-gradle 2.1.0.
      • Build against errorprone-gradle 4.1.0.
      • Build against Compose multiplatform 1.7.0.
      • Build against Dokka 2.0.0-Beta.
      "},{"location":"changelog/#0202","title":"0.20.2","text":"

      2024-10-14

      • Fix: Fall back to old property name for kotlin JVM args if the new one isn\u2019t found.
      • Enhancement: Don\u2019t try to apply kotlin JVM args if there are none.
      "},{"location":"changelog/#0201","title":"0.20.1","text":"

      2024-10-14

      Don\u2019t use this release! We goofed on something.

      "},{"location":"changelog/#0200","title":"0.20.0","text":"

      2024-10-11

      "},{"location":"changelog/#project-restructuring","title":"Project Restructuring","text":"

      We\u2019ve restructured this project! Since its early days as a simple Gradle convention plugin it\u2019s expanded into IntelliJ plugins, CLIs, CI tooling, and more. To better capture this, we\u2019ve renamed the project to Foundry, restructured its artifacts into a more cohesive setup, moved kotlin-cli-util into this repo, and will likely split out some more artifacts down the line.

      "},{"location":"changelog/#migration-guide","title":"Migration Guide","text":"
      • Any gradle properties prefixed with slack. or sgp. have now moved to foundry.. slack.gradle. prefix have also removed the gradle. (i.e. slack.gradle.foo would now be foundry.foo).
      • SlackProperties has been renamed to FoundryProperties.
      • Some properties have been further refined to be more specific.

      • There is a helper script you can use to automatically rename all properties in foundry-migration/.

        • Download mapping.txt
        • Download property_migration.sh
        • Run ./property_migration.sh mapping.txt <path to target project>.
        • Note this only covers *.kts and *.properties files. This does not cover args passed via CLI or envs.

      • Package names have all aligned to foundry.*. In most cases it should be simple enough to replace import com.slack.* with import foundry.*.

      • Gradle coordinates group have moved to the com.slack.foundry group name.

        Old Artifact ID New Artifact ID sgp gradle-plugin sgp-agp-handler-api agp-handler-api sgp-common foundry-common sgp-tracing tracing skippy skippy

      • The former kotlin-cli-util APIs have moved to the com.slack.foundry:cli artifact.

      • Platform-specific plugins now live under the platforms/ directory.
      • All other tools now live under the tools/ directory.
      • Most top-level Slack-prefixed APIs are now prefixed with Foundry.
      • The primary gradle entry points are now foundry {}, but the previous slack {} entry points are left with deprecation ReplaceWith options.

      • Gradle plugin IDs have migrated to com.slack.foundry.* names.

        Old New com.slack.gradle.root com.slack.foundry.root com.slack.gradle.base com.slack.foundry.base com.slack.gradle.apk-versioning com.slack.foundry.apk-versioning

      • Introduce new required foundry.android.defaultNamespacePrefix property for android projects. This is necessary for projects that don\u2019t define an android.namespace explicitly.

      "},{"location":"changelog/#misc","title":"Misc","text":"
      • New: Make JDK configuration docs and error messages configurable via FoundryProperties.
      • Fix: Gracefully handle undefined kapt language versions when computing progressive.
      • Fix: Track deleted build files when computing parent projects in Skippy.
      • Update Clikt to 5.0.1.
      • Update oshi-core to 6.6.5.
      • Build against DAGP 2.x.
      • Build against gradle-error-prone 4.0.1.
      • Build against gradle-nullaway 2.0.0.
      • Build against Gradle versions plugin 0.51.0.
      • Build against Develocity plugin 3.18.1.
      "},{"location":"changelog/#0196","title":"0.19.6","text":"

      2024-09-25

      • Intro SoftRefLRUPolicyMSPerMB + ReservedCodeCacheSize jvm args to bootstrap
      • Learnings from https://jasonpearson.dev/codecache-in-jvm-builds and https://jasonpearson.dev/softreflrupolicymspermb-in-jvm-builds.
      • Update kotlin-cli-util to 3.0.1.
      • Update to Guava 33.3.1-jre.
      • Build against Gradle 8.10.2.
      "},{"location":"changelog/#0195","title":"0.19.5","text":"

      2024-09-23

      • Add workaround for KGP not applying sourceInformation compose options in android projects and default it to true.
      "},{"location":"changelog/#0194","title":"0.19.4","text":"

      2024-09-22

      • Change slack.allowWarnings property to sgp.kotlin.allowWarnings.
      • Disallow warnings in Kotlin test compilations by default, add sgp.kotlin.allowWarningsInTests property to opt-out.
      • Update to kotlinx-coroutines 1.9.0.
      • Update Okio to 3.9.1.
      • Update to Clikt 5.0.0.
      • Update JNA to 5.15.0.
      • Update oshi-core to 6.6.4.
      • Update kotlin-cli-util to 3.0.0.
      • Build against AGP 8.6.1.
      "},{"location":"changelog/#0193","title":"0.19.3","text":"

      2024-09-12

      • Change: Rename testFixtures() feature DSL to enableTestFixtures() to disambiguate from Gradle\u2019s methods.
      • New: Introduce new sgp.compose.stabilityConfigurationPath property to specify a Compose configuration file path from the root project. It is also now disallowed to specify this via sgp.compose.commonCompilerOptions.
      "},{"location":"changelog/#0192","title":"0.19.2","text":"

      2024-09-12

      • [sgp] New: Add new slack { features { testFixtures() } } DSL for enabling test fixtures in a project-agnostic way.
      • [sgp] Make slack.location.robolectric-core property optional.
      • [sgp] Clean up duplicate Kotlin JVM argument handling in KaptGenerateStubsTask.
      • [sgp] Update to the new compose-compiler-gradle-plugin feature flag API.
      • [sgp] Apply platform project BOMs to SqlDelight DialectClasspath configurations too.
      • [sgp] Build against KSP 2.0.20-1.0.25.
      • [sgp] Build against AGP 8.6.0.
      • [sgp] Build against Gradle 8.10.1.
      • [sgp] Build against Wire 5.1.0.
      • [skippy] Don\u2019t treat testFixtures as test sources
      "},{"location":"changelog/#0191","title":"0.19.1","text":"

      2024-09-03

      • Add slack.bootstrap.minGradleXms property to set minimum xms values for daemon memory args.
      • Apply slack.boostrap.minGradleXm* values to kotlin daemon jvm args too.
      • Remove MaxMetaspace caps from bootstrap. This shouldn\u2019t be set anymore in JDK 17+.
      • Update develocity-gradle-plugin-adapters to 1.0.4.
      • Update Bugsnag to 3.7.2.
      • Build against AGP 8.6.0.
      "},{"location":"changelog/#0190","title":"0.19.0","text":"

      2024-08-27

      • Improve KGP plugin handling to better support upcoming AGP kotlin compilation.
      • Build with JDK 22. Still targets JVM 17.
      • Update MoshiX to 0.28.0.
      • Update RxJava to 3.1.9.
      • Update Oshi to 6.6.3.
      • Revert dependency sorter back to 0.7.
      • Build against Kotlin 2.0.20.
      • Build against redacted-compiler-plugin 1.10.0.
      • Build against KSP 2.0.20-1.0.24.
      • Build against Gradle 8.10.
      "},{"location":"changelog/#0184","title":"0.18.4","text":"

      2024-08-12

      • Add sgp.kapt.languageVersion property to override the language version used for KAPT.
      • Build against Kotlin 2.0.10.
      • Build against KSP 2.0.10-1.0.24.
      • Build against AGP 8.5.2.
      "},{"location":"changelog/#0183","title":"0.18.3","text":"

      2024-08-04

      • Add support for changing Anvil implementations.
      "},{"location":"changelog/#0182","title":"0.18.2","text":"

      2024-07-31

      • Fix applying free compiler args from Gradle properties.
      • Gate disabling compose live literals on relevant AGP versions. This is deprecated in new AGP versions.
      • Remove a noisy log.
      • Streamline dagger ksp handling + remove napt support.
      • Update Kaml to 0.61.0.
      • Update Oshi to 6.6.2.
      • Build against DAGP 1.33.0.
      • Build against KSP 2.0.0-1.0.24.
      • Build against Anvil 2.5.0-beta11.
      "},{"location":"changelog/#0181","title":"0.18.1","text":"

      2024-07-19

      • Fix: Fix circular evaluation dependency for jvmTarget.
      • Remove Kover Workaround for 0.7.1.
      • Turn off xml report generation for lint task.
      • Update KotlinPoet to 1.18.1.
      • Update Wire to 5.0.0.
      • Update MoshiX to 0.27.2.
      • Build against Gradle 8.9.
      • Build against KSP 2.0.0-1.0.23.
      • Build against AGP 8.5.1.
      • Build against sort-dependencies 0.7.
      "},{"location":"changelog/#0172","title":"0.17.2","text":"

      2024-05-28

      • Make default Kotlin compiler arguments more configurable. This includes removing some previously-default behavior.
      • sgp.kotlin.languageVersionOverride. Default is null, which will just defer to KGP\u2019s default.
      • sgp.kotlin.optIns
        • Previous default opt-ins = kotlin.contracts.ExperimentalContracts, kotlin.experimental.ExperimentalTypeInference, kotlin.ExperimentalStdlibApi, kotlin.time.ExperimentalTime
      • sgp.kotlin.freeArgs
        • Previous default free args = -Xenhance-type-parameter-types-to-def-not-null, -Xself-upper-bound-inference
      • sgp.kotlin.jvmFreeArgs
        • Previous default JVM free args = -Xjsr305=strict, -Xassertions=jvm, -Xemit-jvm-type-annotations, -Xjvm-default=all, -Xtype-enhancement-improvements-strict-mode, -Xjspecify-annotations=strict
      • sgp.kotlin.progressive. Default is true.
      • Build against AGP 8.5.0.
      • Build against DAGP 1.32.0.
      • Build against Compose Multiplatform 1.6.11.
      • Update to Kaml 0.60.0.
      • Update to Guava 33.2.1-jre.
      • Update to MoshiX 0.27.1.
      "},{"location":"changelog/#0171","title":"0.17.1","text":"

      2024-05-28

      • Build against Kotlin 2.0.0.
      • Build against KSP 2.0.0-1.0.21.
      • Build against AGP 8.4.1.
      "},{"location":"changelog/#0170","title":"0.17.0","text":"

      2024-04-30

      • Build against AGP 8.4.0.
      • Update Clikt to 4.4.0.
      "},{"location":"changelog/#0164","title":"0.16.4","text":"

      2024-04-26

      • Add new flag + logic to relocate project build directories #827.
      • Update to develocity plugin\u2019s retry extension.
      • Build against redacted compiler plugin 1.8.1.
      • Update to Kaml 0.59.0.
      "},{"location":"changelog/#0163","title":"0.16.3","text":"

      2024-04-18

      • Migrate to Develocity (3.17) for build scan reporting. Technically legacy Gradle Enterprise APIs should still work, but we\u2019re not intentionally supporting them anymore.
      • Build against Anvil 2.5.0-beta07.
      • Update commons-text to 1.12.0.
      • Update oshi to 6.6.0.
      • Build against DAGP 1.31.0.
      • Build against Compose Multiplatform 1.6.2.
      • Build against AGP 8.3.2.
      • Build against KSP 1.9.23-1.0.20.
      • Build against SqlDelight 2.0.2.
      • Update to Wire 4.9.9.
      • Update to Clikt 4.3.0.
      "},{"location":"changelog/#0162","title":"0.16.2","text":"

      2024-03-28

      • Work around https://issuetracker.google.com/issues/331806519 when using KSP in android projects.
      • Build against AGP 8.3.1.
      • Build against Detekt 1.23.6.
      • Build against Gradle 8.7.
      • Update Retrofit to 2.11.0.
      • Update Kaml to 0.58.0.
      • Update Wire to 4.9.8.
      • Update Guava to 33.1.0-jre.
      "},{"location":"changelog/#0161","title":"0.16.1","text":"

      2024-03-14

      • Only apply -Xjdk-release on jvm compilations (not android).
      "},{"location":"changelog/#0160","title":"0.16.0","text":"

      2024-03-14

      • New: Add support for Anvil\u2019s new KSP support via Anvil 2.5.0-beta04.
      • Incorporate Kotlin\u2019s -Xjdk-release option alongside jvmTarget.
      • Fix configuration cache when setting kotlin compilation module name.
      • Update Okio to 3.9.0.
      • Update Oshi to 6.5.0.
      • Build against Kotlin 1.9.23.
      • Build against KSP 1.9.23-1.0.19.
      • Build against Compose Multiplatform 1.6.1.
      "},{"location":"changelog/#0159","title":"0.15.9","text":"

      2024-03-08

      • New: Add property to override lint version from version catalogs.
      • Fix: Fix application of common compose options.
      "},{"location":"changelog/#0158","title":"0.15.8","text":"

      2024-03-04

      • Fix: Check for com.android.test in Project.isAndroid checks. This resolves a case where we accidentally set the JavaCompile.options.release property in those projects.
      "},{"location":"changelog/#0157","title":"0.15.7","text":"

      2024-02-28

      • Fix inverted logic for disabled anvil mode in K2/KSP testing.
      "},{"location":"changelog/#0156","title":"0.15.6","text":"

      2024-02-28

      • Fix AnvilMode casing in detection.
      "},{"location":"changelog/#0155","title":"0.15.5","text":"

      2024-02-27

      • Broaden anvil KSP support controls.
      • Update oshi to 6.4.13.
      • Add sgp.compose.commonCompilerOptions property for common compose compiler options.
      • Build against Compose Multiplatform 1.6.0.
      • Fix mkdocs lists on the main page.
      "},{"location":"changelog/#0154","title":"0.15.4","text":"

      2024-02-19

      • Remove -Xproper-ieee754-comparisons arg, as it\u2019s enabled by default and removed entirely in K2.
      • Small fixes around skippy + add inverse options to boolean options.
      • Update Okio to 3.8.0.
      • Update Oshi to 6.4.12.
      • Update coroutines to 1.8.0.
      • Build against DAGP 1.30.0.
      • Build against AGP 8.3.0-rc01.
      "},{"location":"changelog/#0153","title":"0.15.3","text":"

      2024-02-03

      • Support Gradle 8.6.
      • Use new lazier TaskCollection.named(Spec) APIs where appropriate.
      • Update to Moshi 1.15.1.
      • Update to kotlin-cli-util 2.6.3.
      • Update to oshi 6.4.11.
      • Build against AGP 8.2.2.
      • Build against Kotlin 1.9.22.
      • Build against KSP 1.9.22-1.0.17.
      • Build against Detekt 1.23.5.
      • Build against Compose Multiplatform 1.5.12.
      • Build against DAGP 1.29.0.
      • Build against Spotless 6.25.0.
      "},{"location":"changelog/#0152","title":"0.15.2","text":"

      2024-01-11

      • New: Promote PropertyResolver to public API.
      • New: Skippy logic is now distributed as a separate, non-gradle-specific artifact under com.slack.gradle:skippy. This also includes a CLI that can be run as an alternative to the gradle task. Note this requires serialized dependency graph and androidTest projects to be pre-computed. THe config must be in a static JSON file. See the docs on ComputeAffectedProjectsCli.

      Usage: compute-affected-projects-cli [<options>]\n\n  Computes affected projects and writes output files to an output directory.\n\nOptions:\n  --debug                    Enable debug logging.\n  --merge-outputs            Merge outputs from all configs into a single\n                             /merged dir.\n  --config=<path>            Path to a config file that contains a mapping of\n                             tool names to SkippyConfig objects.\n  --parallel                 Compute affected projects in parallel.\n  --changed-files=<path>     A relative (to the repo root) path to a\n                             changed_files.txt that contains a\n                             newline-delimited list of changed files. This is\n                             usually computed from a GitHub PR's changed files.\n  -o, --outputs-dir=<path>   Output directory for skippy outputs.\n  --root-dir=<path>          Root repo directory. Used to compute relative\n                             paths.\n  --dependency-graph=<path>  Path to a serialized dependency graph file.\n  --android-test-project-paths=<path>\n                             Path to a file that contains a newline-delimited\n                             list of project paths that produce androidTest\n                             APKs.\n  -h, --help                 Show this message and exit\n
      - Enhancement: Split out separate cacheable generateDependencyGraph and generateAndroidTestProjects tasks from ComputeAffectedProjectsTask. This allows for more fine-grained caching and parallelization.

      An example flow of the last two bullets can look like so:

      # Generate the dependency graph and androidTest projects\n./gradlew generateDependencyGraph generateAndroidTestProjectPaths\n\n# Run the CLI, such as from a `*.main.kts` file that imports it.\n./skippy-runner.main.kts \\\n    --changed-files changed_files.txt \\\n    --dependency-graph slack/dependencyGraph/serializedGraph.bin \\\n    --android-test-project-paths slack/androidTestProjectPaths/paths.txt \\\n    ...\n
      "},{"location":"changelog/#0151","title":"0.15.1","text":"

      2024-01-09

      • Misc small fixes to the new artifact publishing internals released in 0.15.0.
      "},{"location":"changelog/#0150","title":"0.15.0","text":"

      2024-01-02

      • Enhancement: We\u2019ve reworked the internals of SGP significantly to make it more compatible with Gradle Project Isolation. This affects Skippy, ModScore, AndroidTest APK aggregation, DAGP missing identifiers, and property resolution (specifically command line properties and local.properties). Note that this work is ongoing as project isolation is incubating, but the changes in this release should be non-functional in nature.
      • Build against Kotlin 1.9.22.
      • Build against KSP 1.9.22-1.0.16.
      • Build against AGP 8.2.1.
      • Build against AGP 8.3.0-beta01 in AgpHandler83.
      • Build against maven-publish 0.26.0.
      • Update to Guava 33.0.0-jre.
      • Update to Oshi 6.4.10.
      • Update to kotlin-cli-util 2.6.0.
      "},{"location":"changelog/#0142","title":"0.14.2","text":"

      2023-12-18

      • Make compose() DSL function with Action parameter public.
      "},{"location":"changelog/#0141","title":"0.14.1","text":"

      2023-12-18

      • Expose compilerOption() API in Compose DSL for compiler arg configuration.
      • Update to DAGP 1.28.0 + migrate off deprecated APIs.
      • Update Okio to 3.7.0.
      • Update AgpHandler 8.3 to 8.3.0-alpha18.
      • Build against KSP 1.9.21-1.0.16.
      "},{"location":"changelog/#0140","title":"0.14.0","text":"

      2023-12-12

      • Support granular Skippy configuration. Now each tool can be configured independently with both global and per-tool configuration. These are controlled via public skippy extension now. These outputs and diagnostics are stored at build/skippy/{tool}/.... Merged outputs can be generated as well to build/skippy/merged. This allows for creating dynamic pipelines based on the outputs of each tool. The global config is always overlaid onto each tool-specific config.
      skippy {\n  debug.set(true)\n  mergeOutputs.set(true)\n  computeInParallel.set(true)\n  global {\n    applyDefaults()\n    // Glob patterns of files to include in computing\n    includePatterns.addAll(\n      \"**/*.pro\",\n      \"**/src/**/sqldelight/**\",\n    )\n    excludePatterns.addAll(\".idea/**/*.kt\")\n    // Glob patterns of files that, if changed, should result in not skipping anything in the build\n    neverSkipPatterns.addAll(\n      \".buildkite/**\",\n      \".github/actions/**\",\n      \"ci/**\",\n      \"config/health-score/**\",\n      \"tooling/scripts/**\",\n    )\n  }\n  config(\"lint\") {\n    includePatterns.addAll(\n      // project-local lint.xml files\n      // this doesn't fuuuuully work with skippy because these layer like .gitignore does\n      \"**/lint.xml\",\n      // Lint baselines\n      \"**/lint-baseline.xml\",\n    )\n    neverSkipPatterns.addAll(\n      // Global lint config\n      \"config/lint/lint.xml\",\n      // Houston feature flags, which is an input to our feature flags lints\n      \"config/feature-flags/experiments.txt\",\n    )\n  }\n  config(\"detekt\") {\n    // Detekt baselines\n    includePatterns.add(\"**/detekt-baseline.xml\")\n    // Global detekt configs\n    neverSkipPatterns.add(\"config/detekt/*\")\n  }\n}\n
      • Update Kotlin language version to 1.9.
      • Upgrade away from deprecated CC API check.
      • Update to okio 3.6.0
      • Update to oshi 6.4.9
      • Update to JNA 5.14.0
      • Update to kotlin-cli-util 2.5.4
      • Build against AGP 8.3.0-alpha17 in AgpHandler 8.3 artifact.
      • Build against DAGP 1.27.0.
      "},{"location":"changelog/#0131","title":"0.13.1","text":"

      2023-12-05

      • Make Project.isSyncing public.
      • Update to new android.studio.version property for reporting to build scans.
      • Update to Wire 4.9.3.
      • Update to RxJava 3.1.8.
      • Build against Kotlin 1.9.21.
      • Build against KSP 1.9.21-1.0.15.
      • Build against MoshiX 0.25.1.
      • Build against AGP 8.2.0.
      • Build against SqlDelight 2.0.1.
      • Build against Redacted Compiler Plugin 1.7.1.
      • Build against Detekt 1.23.4.
      • Build against Gradle Doctor 0.9.1.
      "},{"location":"changelog/#0130","title":"0.13.0","text":"

      2023-11-30

      • Update to Gradle 8.5. This version requires Gradle 8.5+.
      • Report Gradle 8.5\u2019s new BuildFeatures to build scans as custom values, starting with configuration cache and isolated projects.
      • Update Guava to 32.1.3-jre.
      • Update Oshi to 6.4.8.
      • Build against AGP 8.1.4 (main) and 8.3.0-alpha15 (agp handler 8.3).
      • Build against compose multipaltform 1.5.11.
      • Include source links in Dokka docs.
      "},{"location":"changelog/#0121","title":"0.12.1","text":"

      2023-11-21

      • Fix circuit() extension code gen using the wrong configuration.
      "},{"location":"changelog/#0120","title":"0.12.0","text":"

      2023-11-20

      • New: Add a SlackExtension.circuit() DSL. This makes it easy to set up Circuit in a project. See the DSL docs for more details. 
        slack {\n  features {\n    circuit()\n  }\n}\n
      • Don\u2019t configure KspTask subtypes of KotlinCompile tasks.
      • Remove autoValue() APIs from SlackExtension.
      • Fix deprecated forkEvery call.
      "},{"location":"changelog/#0117","title":"0.11.7","text":"

      2023-11-10

      • Make AGP version resolution lazy in AgpHandlers.
      "},{"location":"changelog/#0116","title":"0.11.6","text":"

      2023-11-09

      • Explicitly set Detekt.baseline to null if we don\u2019t specify one, as we don\u2019t want it to fall back to its default location.
      "},{"location":"changelog/#0115","title":"0.11.5","text":"

      2023-11-09

      • Support AGP 8.3.0-alpha13.
      "},{"location":"changelog/#0114","title":"0.11.4","text":"

      2023-11-08

      • Detekt baselines are now generated into their corresponding projects. This matches how we handle lint baselines, and global baselines are no longer supported.
      • You do now need to specify a slack.detekt.baseline-file-name property to indicate what the simple file name should be. This is evaluated against project.layout.projectDirectory.file(...). This replaces the previous slack.detekt.baseline property.
      • Build against Kotlin 1.9.20.
      • Build against AGP 8.1.3.
      • Build against Compose Multiplatform 1.5.10.
      "},{"location":"changelog/#0113","title":"0.11.3","text":"

      2023-11-02

      • Support Robolectric 4.11 jars for Android API 34.
      "},{"location":"changelog/#0112","title":"0.11.2","text":"

      2023-10-30

      • Make detekt and lint baselines default to null if their property values are blank.
      • No longer publish monkeypatch artifact as it\u2019s no longer necessary.
      "},{"location":"changelog/#0111","title":"0.11.1","text":"

      2023-10-22

      • Add new sgp.isTestLibrary property to indicate if a library is a test library. Note that projects that are named test-fixtures are implicitly considered test libraries.
      • Fix: Don\u2019t impose VisibleForTests lint on test libraries.
      "},{"location":"changelog/#0110","title":"0.11.0","text":"

      2023-10-22

      • Revamp some lint configuration and best-effort support KMP projects.
      • Remove slack.lint.update-baselines property in favor of AGP\u2019s modern updateBaselines task.
      • Remove hidden ImplicitSamInstance lint config.
      • Disable newer issues for dependency checks.
      "},{"location":"changelog/#01011","title":"0.10.11","text":"

      2023-10-19

      • Support AGP 8.3.0-alpha08.
      • Build against Gradle 8.4.
      • Build against compose-multiplatform 1.5.3.
      "},{"location":"changelog/#01010","title":"0.10.10","text":"

      2023-10-02

      • Make debug builds everywhere (local and CI) use consistent version codes and version names. This way remote build cache entries for them are compatible.
      • Default debug version code is governed by slack.gradle.debugVersionCode and defaults to 90009999.
      • Default version name user suffix is governed by slack.gradle.debugUserString and defaults to debug.
      • Non-debug build types are the same as before.
      • Remove a noisy lifecycle log around lint variant selection.
      • Build against Bugsnag Gradle Plugin 8.1.0.
      "},{"location":"changelog/#0109","title":"0.10.9","text":"

      2023-09-28

      • Don\u2019t disable caching on MergeAssets tasks by default. Leave that to consuming repos.
      • Update permission allowlist API to use a allowListFile file property instead.
      • Don\u2019t exclude coroutines\u2019 debug probes in debug build packaging.
      • Support AGP 8.3.0-alpha05+.
      • Build against Wire 4.9.1.
      • Build against Compose Multiplatform 1.5.2.
      • Update to Oshi 6.4.6.
      "},{"location":"changelog/#0108","title":"0.10.8","text":"

      2023-09-22

      • Fix: Don\u2019t apply boms to the coreLibraryDesugaring configuration.
      • Enhancement: Set Kotlin compilerOptions.moduleName to a dashified version of the Gradle project path.
      • Update MoshiX to 0.24.3
      • Compile against Anvil 2.4.8.
      • Compile against CM 1.5.1.
      • Compile against DAGP 1.22.0.
      • Compile against redacted-compiler-plugin 1.6.1.
      "},{"location":"changelog/#0107","title":"0.10.7","text":"

      2023-08-29

      • Fix: Don\u2019t apply BOMs to testApi configurations.
      "},{"location":"changelog/#0106","title":"0.10.6","text":"

      2023-08-29

      • New: Publish a generic Tracing API under the sgp-tracing artifact ID. We use this internally to collect extra build metadata, but it\u2019s generic enough for general use. Not currently used in slack-plugin yet.
      • Add sgp.android.buildToolsVersionOverride property to override the default build tools version in Android.
      • Migrate to AndroidPluginVersion API in AgpHandler.
      • Fix a few more deprecated Gradle API usages.
      • Build against AGP 8.1.1.
      • Build against Spotless 6.21.0.
      • Build against Compose Multiplatform 1.5.0.
      • Update to Kotlin 1.9.10.
      • Update to KSP 1.9.10-1.0.13.
      • Update to RxJava 3.1.7.
      • Update to kotlin-cli-util 2.2.1.
      • Update to Oshi 6.4.5.
      • Update to Wire 4.8.1
      • Update to DAGP 1.21.0.
      • Update to Gradle 8.3.
      "},{"location":"changelog/#0105","title":"0.10.5","text":"

      2023-08-15

      • Fix: Better support com.android.test projects in a few ways
      • No longer apply lint configurations as they don\u2019t support them.
      • No longer apply DAGP as it doesn\u2019t support them yet.
      • No longer apply unit test configurations as they don\u2019t have unit tests.
      • Build against Gradle 8.3 + fix a few deprecated Project.buildDir API usages.
      • Update kotlin-cli-util to 2.1.0.
      "},{"location":"changelog/#0104","title":"0.10.4","text":"

      2023-08-10

      • New: New DSL API for enabling Android resources.

      This streamlines configuration of enabling androidResources and enforces use of a resource prefix to avoid conflicts.

      May your avatars never be wrongly sized again.

      slack {\n  android {\n    features {\n      resources(\"prefix_\")\n    }\n  }\n}\n
      • Update kotlin-cli-util to 2.0.0.
      • Update Moshi to 1.15.0.
      • Update sort-dependencies to 0.4.
      • Update KSP to 1.9.0-1.0.13.
      • Update Okio to 3.5.0.
      • Update Jetbrains Markdown to 0.5.0.
      "},{"location":"changelog/#0103","title":"0.10.3","text":"

      2023-08-08

      • Fix an issue with Skippy where we would accidentally mark all library projects as affected androidTest projects even if they didn\u2019t have androidTest enabled.
      • Update Guava to 32.1.2-jre.
      "},{"location":"changelog/#0102","title":"0.10.2","text":"

      2023-08-08

      • Apparently the bugsnag plugin relies on the version code to be set in the variant output, so now we set a default again (configurable via slack.gradle.defaultVersionCode). The default is 90009999, for reasons.
      "},{"location":"changelog/#0101","title":"0.10.1","text":"

      2023-08-07

      • Use a single version code for all APK architectures.
      • Before, we used to compute a different version code for each architecture. This is kinda silly, and broke with AGP 8.1.0. So now we no longer do this. This means that by default, no custom version code is set unless an override is set in {rootProject}/build/ci/release.version. The default behavior will be to just use the version set in the android DSL.
      • Update to Detekt 1.23.1.
      • Update to Gradle Enterprise 3.14.1.
      • Update to Compose Multiplatform 1.4.3.
      • Update to SqlDelight 2.0.0.
      • Update to Anvil 2.4.7.
      "},{"location":"changelog/#0100","title":"0.10.0","text":"

      2023-07-25

      • Update to Kotlin 1.9.0.
      • Update to KSP 1.9.0-1.0.12.
      • Update to AGP 8.1.0.
      • Update kotlin-cli-util to 1.2.3.
      • Update MoshiX to 0.24.0.
      • Update redacted to 1.5.0.
      • Update wire to 4.8.0.
      • Add new dagger flag to ignore wildcard keys by default.
      • https://dagger.dev/dev-guide/compiler-options#ignore-provision-key-wildcards
      "},{"location":"changelog/#0918","title":"0.9.18","text":"

      2023-07-12

      • Fix: Differentiate unit and instrumentation tests in Skippy. Now changing a unit test will not cause the instrumentation tests to be marked as affected.
      • Add slack.dependencyrake.dryRun gradle property flag for dependency rake to enable dry-run. If enabled, the project build files will not be modified and a separate new-build.gradle.kts file will be written to instead.
      • Update Okio to 3.4.0.
      "},{"location":"changelog/#0917","title":"0.9.17","text":"

      2023-07-07

      • Don\u2019t register RakeDependencies task on platform projects.
      • Fix configuration cache for Dependency Rake. Note that DAGP doesn\u2019t yet support it.
      • Add Dependency Rake usage to its doc.
      • Add missing identifiers aggregation for Dependency Rake. This makes it easier to find and add missing identifiers to version catalogs that dependency rake expects.
      • ./gradlew aggregateMissingIdentifiers -Pslack.gradle.config.enableAnalysisPlugin=true --no-configuration-cache
      "},{"location":"changelog/#0916","title":"0.9.16","text":"

      2023-06-30

      • Enable lint on test sources by default.
      • Account for all version catalogs in DependencyRake.
      • Update Guava to 32.1.0-jre.
      "},{"location":"changelog/#0915","title":"0.9.15","text":"

      2023-06-29

      • Switch Robolectric jar downloads to use detached configurations.
      • This lets Gradle do the heavy lifting of caching the downloaded jars and also allows downloading them from a configured repository setup. This also simplifies the up-to-date checks.
      • Docs are now published on https://slackhq.github.io/slack-gradle-plugin. This is a work in progress.
      • API kdocs are published at https://slackhq.github.io/slack-gradle-plugin/api/0.x/.
      • Update kotlin-cli-util to 1.2.2.
      "},{"location":"changelog/#0914","title":"0.9.14","text":"

      2023-06-25

      • Fix compose compiler config not applying to android projects.
      "},{"location":"changelog/#0913","title":"0.9.13","text":"

      2023-06-24

      • Fix wrong map key name being used in exclusion.
      "},{"location":"changelog/#0912","title":"0.9.12","text":"

      2023-06-24

      • Fix wrong dependency being used for compose-compiler in new Compose configuration overhaul.
      "},{"location":"changelog/#0911","title":"0.9.11","text":"

      2023-06-24

      • Overhaul configuration of the Compose compiler across Android and multiplatform projects to make it easier to test the matrix of the AndroidX compose compiler, the JetBrains compose compiler, and new Kotlin versions.
      • New: Add a sgp.compose.multiplatform.forceAndroidXComposeCompiler Gradle property flag to force use of the AndroidX compose compiler in Compose Multiplatform projects.
      • New: Add a sgp.config.jvmVendor.optOut Gradle property flag to disable jvmVendor configuration in toolchains.
      • Fix: No longer try to watch thermals on Intel macOS machines when configuration cache is enabled.
      "},{"location":"changelog/#0910","title":"0.9.10","text":"

      2023-06-06

      • Fix: Don\u2019t apply vendor property to Bootstrap toolchain if it\u2019s undefined.
      "},{"location":"changelog/#099","title":"0.9.9","text":"

      2023-06-06

      • New: Robolectric is now optional. Its support will only be enabled if there is a robolectric key in the primary version catalog.
      • Enhancement: Update bootstrap JVM args to use ExitOnOutOfMemoryError for OOMs. No longer takes a heap dump on OOM.
      • Enhancement: Update unit test verbose mode to use CrashOnOutOfMemoryError for OOMs to produce more logs.
      • Fix: Bootstrap now respects the sgp.config.jvmVendor property.
      • Build against Wire to 4.7.0.
      • Build against Anvil 2.4.6.
      • Build against AGP 8.0.2.
      • Build against Detekt 1.23.0.
      "},{"location":"changelog/#098","title":"0.9.8","text":"

      2023-05-15

      • Fix eager check of whether or not androidTest is enabled in slack DSL.
      "},{"location":"changelog/#097","title":"0.9.7","text":"

      2023-05-15

      • Fix application targets not getting marked as androidTest()-enabled.
      "},{"location":"changelog/#096","title":"0.9.6","text":"

      2023-05-09

      • Fix wrong use of disallowChanges() on javaCompiler in JavaCompile tasks. It seems that Gradle sets this multiple times.
      • Improve git version matching.
      "},{"location":"changelog/#095","title":"0.9.5","text":"

      2023-05-09

      • Use disallowChanges() where possible on properties SGP controls in order to avoid accidental overwrites.
      • Make ComputeAffectedProjectsTask also generate a affected_android_test_projects.txt file with a newline-delimited list of affected projects that enable androidTest(). This can be used in CI scripts to statically determine if instrumentation tests need to run.
      "},{"location":"changelog/#094","title":"0.9.4","text":"

      2023-05-06

      • Fix alias naming in SlackVersions. See SlackVersions.kt for updated expected naming of aliases.
      "},{"location":"changelog/#093","title":"0.9.3","text":"

      2023-05-05

      • Add jdk.compiler/com.sun.tools.javac.model to Bootstrap Gradle JVM args and exec prefixes for binaries for GJF 17.
      "},{"location":"changelog/#092","title":"0.9.2","text":"

      2023-05-05

      • Fix accidental noisy JVM vendor log.
      "},{"location":"changelog/#091","title":"0.9.1","text":"

      2023-05-04

      Happy May the Fourth!

      • Add new sgp.config.jvmVendor property to control the JVM vendor used in Kotlin and Java toolchains. This value is used to match a known vendor spec, such as AZUL.
      • Apply the kover plugin in an afterEvaluate block to avoid https://github.com/Kotlin/kotlinx-kover/issues/362.
      • Update jgrapht to 1.5.2.
      • Update oshi to 6.4.2.
      "},{"location":"changelog/#090","title":"0.9.0","text":"

      2023-04-30

      • Improve Skippy logging.
      • Configure all Kotlin compilations, not just JVM compilations.
      • Split standard JVM args and common Kotlin args.
      • Simplify OkHttpClient setup in SlackTools.
      • Update to Kotlin 1.8.21.
      • Support Dagger KSP in slack.features.dagger DSL controls. There are two new properties to control this:
      • slack.ksp.allow-dagger \u2013 allow use of Dagger in KSP.
      • slack.ksp.allow-anvil \u2013 allow use of Anvil in KSP. Note this is not yet implemented in Anvil, just a toe-hold for the future.
      • Add debugging logs for loading SlackToolsExtension instances + fix classloader used for it.
      • Gracefully handle SlackToolsExtension extensions that fail to load.
      "},{"location":"changelog/#0810","title":"0.8.10","text":"

      2023-04-25

      • Add Context to SlackToolsExtension.
      "},{"location":"changelog/#089","title":"0.8.9","text":"

      2023-04-25

      • Expose missing SlackTools.findExtension API.
      • Expose missing SlackTools.SERVICE_NAME for @ServiceReference API.
      "},{"location":"changelog/#088","title":"0.8.8","text":"

      2023-04-25

      • Update to Kotlin 1.8.20.
      • Remove moshi-kotlin, only use generated adapters now.
      • Don\u2019t auto-apply the Kover plugin on a platform project.
      • Add new sgp.ge.apply-common-build-tags property flag to gate applying common build tags to a project.
      • Switch SlackToolsExtension to work as a ServiceLoader instead.
      "},{"location":"changelog/#087","title":"0.8.7","text":"

      2023-04-23

      • Remove lock file checking in SlackTools because this apparently invalidates configuration cache every time.
      "},{"location":"changelog/#086","title":"0.8.6","text":"

      2023-04-22

      • Revert using native Kotlin lambdas instead of class for SAM conversions due to https://github.com/gradle/gradle/issues/24871.
      "},{"location":"changelog/#085","title":"0.8.5","text":"

      2023-04-22

      • Clean up thermals logging setup in SlackTools and support enabling property at different scopes (local.properties, etc).
      • Shut down thermals heartbeat executor when SlackTools is closed.
      • Use native Kotlin lambdas instead of class for SAM conversions. The minimum supported Gradle version is now 8.1, which introduced support for this.
      "},{"location":"changelog/#084","title":"0.8.4","text":"

      2023-04-22

      • Fix JSON serialization for thermals data.
      "},{"location":"changelog/#083","title":"0.8.3","text":"

      2023-04-22

      • Don\u2019t accidentally create new SlackTools instances when reporting background data to Gradle Enterprise. These instances would be orphaned because this would happen after Gradle had closed all existing services, and create a memory leak.
      • Use a lock file to track SlackTools instances.
      • Use a single-threaded Executor for SlackTools\u2019 thermals heartbeat.
      "},{"location":"changelog/#082","title":"0.8.2","text":"

      2023-04-22

      • Log a Throwable with multiple instances of SlackTools to help track origin points.
      "},{"location":"changelog/#081","title":"0.8.1","text":"

      2023-04-22

      • Add some debug logging to SlackTools to track multiple instances.
      "},{"location":"changelog/#080","title":"0.8.0","text":"

      2023-04-15

      • Fix: Wrap all exec operations in a ValueSource for Gradle 8.x compatibility.
      • Fix: Set git line endings to PLATFORM_NATIVE in spotless by default. Its default of looking at .gitattributes is expensive and incompatible with Gradle 8.1+ configuration caching.
      • Fix: Add slack.auto-apply.sort-dependencies boolean Gradle property to gate auto-applying the sort-dependencies plugin.
      • SGP now requires AGP 8.0+ (and with it \u2013 Gradle 8+).
      "},{"location":"changelog/#079","title":"0.7.9","text":"

      2023-04-01

      Happy April Fool\u2019s Day!

      • [Skippy] Recursively resolve project dependencies to avoid missing transitive edges in the graph. Previously we only computed shallow dependencies.
      "},{"location":"changelog/#078","title":"0.7.8","text":"

      2023-03-28

      • Fix: Add missing detekt task dependencies for globalDetekt.
      • Fix: Only apply detekt config once (even if multiple Kotlin plugins are applied).
      "},{"location":"changelog/#077","title":"0.7.7","text":"

      2023-03-27

      • Add new slack.detekt.full property to gate whether or to run full detekt (i.e. with type resolution). If disabled, detektRelease/detektMain and associated tasks will be disabled and not used in detektGlobal.
      "},{"location":"changelog/#076","title":"0.7.6","text":"

      2023-03-25

      • Fix: Apply matching configurations to DetektCreateBaselineTask tasks too due to https://github.com/detekt/detekt/issues/5940.
      "},{"location":"changelog/#075","title":"0.7.5","text":"

      2023-03-24

      • [Skippy] Add more default configurations.
      • [Skippy] Add slack.avoidance.build-upon-default-affected-project-configurations flag to make provided configurations build upon defaults.
      • Add new globalDetekt task that runs detekt on all subprojects. This is Skippy-compatible and responds to slack.avoidance.affectedProjectsFile.
      "},{"location":"changelog/#074","title":"0.7.4","text":"

      2023-03-22

      • Don\u2019t expose androidExtension publicly in SlackExtension to avoid Gradle mismatching number of type arguments in AGP 8.1.0-alpha10+.
      "},{"location":"changelog/#073","title":"0.7.3","text":"

      2023-03-22

      • Set Detekt.jdkHome to null to avoid https://github.com/detekt/detekt/issues/5925.
      • Rename String.safeCapitalize() to String.capitalizeUS() to make it more explicit.
      "},{"location":"changelog/#072","title":"0.7.2","text":"

      2023-03-21

      • Disable Live Literals in Compose by default due to multiple issues. They can be enabled via -Pslack.compose.android.enableLiveLiterals=true.
      • Poor runtime performance: https://issuetracker.google.com/issues/274207650.
      • Non-deterministic class files breaking build cache: https://issuetracker.google.com/issues/274231394.
      • [Skippy] Add .github/actions/** to default never skip filters.
      "},{"location":"changelog/#071","title":"0.7.1","text":"

      2023-03-20

      • [Skippy] Improve pattern configuration.
      • Make the default patterns public. This allows consumers to more easily reuse them when customizing their own.
      • Use sets for the type to better enforce uniqueness requirements.
      • Add github actions to never-skip defaults.
      • Add excludePatterns to allow finer-grained control. This runs after include filtering so that users can manually exclude certain files that may otherwise be captured in an inclusion filter and is difficult to describe in a simple glob pattern. GitHub action does similar controls for CI matrices.
      • [Skippy] Allow relative (from the project root) to affected_projects.txt and allow non-existent files as a value. This makes it easy to gracefully fall back in CI.
      • [Skippy] Fix logging path matchers missing toString() impls.
      • [SKippy] Log verbosely in debug mode when skipping task deps.
      • Update oshi to 6.4.1.
      "},{"location":"changelog/#070","title":"0.7.0","text":"

      2023-03-17

      "},{"location":"changelog/#project-skippy","title":"Project Skippy","text":"

      This release introduces an experimental new computeAffectedProjects task for computing affected projects based on an input of changed files. The goal of this is to statically detect which unit test, lint, and androidTest checks can be safely skipped in CI on pull requests.

      Example usage 

      ./gradlew computeAffectedProjects --changed-files changed_files.txt\n

      Where changed_files.txt is resolved against the root repo directory and contains a newline-delimited list of changed files (usually inferred from a PR).

      A simple example of how to produce such a file with the gh CLI:

      gh pr view ${{ github.event.number }} --json files -q '.files[].path' > changed_files.txt\n

      One would run this task first as a preflight task, then run subsequent builds with the slack.avoidance.affectedProjectsFile Gradle property pointing to its output file location (printed at the end of the task).

      ./gradlew ... -Pslack.avoidance.affectedProjectsFile=/Users/zacsweers/dev/slack/slack-android-ng/build/skippy/affected_projects.txt\n

      The globalCiLint, globalCiUnitTest, and aggregateAndroidTestApks tasks all support reading this property and will avoid adding dependencies on tasks in projects that are not present in this set.

      The ComputeAffectedProjectsTask task has some sensible defaults, but can be configured further in the root projects like so.

      tasks.named<ComputeAffectedProjectsTask>(\"computeAffectedProjects\") {\n  // Glob patterns of files to include in computing\n  includePatterns.addAll(\n    \"**/*.kt\",\n    \"**/*.java\",\n  )\n  // Glob patterns of files that, if changed, should result in not skipping anything in the build\n  neverSkipPatterns.addAll(\n    \"**/*.versions.toml\",\n    \"gradle/wrapper/**\",\n  )\n}\n

      Debug logging can be enabled via the slack.debug=true Gradle property. This will output timings, logs, and diagnostics for the task.

      The configurations used to determine the build graph can be customized via comma-separated list to the slack.avoidance.affected-project-configurations property.

      "},{"location":"changelog/#061","title":"0.6.1","text":"

      2023-03-15

      Happy Ted Lasso season 3 premier day!

      • Fix: Remove UseContainerSupport jvm arg from unit tests as this appears to only work on Linux.
      "},{"location":"changelog/#060","title":"0.6.0","text":"

      2023-03-14

      Happy Pi day!

      • Refactor how unit tests are configured.
      • Test tasks are now configured more consistently across CI and local, so there should be more cache hits.
      • Add a new globalCiUnitTest task to the root project to ease running ciUnitTest tasks across all subprojects.
      • Add new properties to SlackProperties for controlling max parallelism and forkEvery options in Test tasks.
      • Refactor how lint tasks are configured.
      • Add a new ciLint task to every project that depends on all lint tasks in that project. This is intended to be the inverse behavior of the built-in lint task in Android projects, which only runs the default variant\u2019s lint task.
      • Add a new globalCiLint task to the root project to ease running ciLint tasks across all subprojects.
      • Add new properties to SlackProperties for controlling which variants should be linted.
      • Revert \u201cAdd lintErrorRuleIds property\u201d. lint.xml is the right place for this kind of logic.
      "},{"location":"changelog/#0510","title":"0.5.10","text":"

      2023-03-07

      • Reduce noisy JNA load failures logging. Still have not gotten to the root cause, but at least this will reduce the log noise.
      • Add a new slack.lint.severity.errorRuleIds Gradle property to specify lint rule IDs that should always be error severity.
      "},{"location":"changelog/#059","title":"0.5.9","text":"

      2023-02-27

      • Gracefully handle JNA load failures in thermals logging.
      "},{"location":"changelog/#058","title":"0.5.8","text":"

      2023-02-20

      • Enhancement: Remove kotlin-dsl from the plugin. If you were indirectly relying on its APIs from this plugin, you\u2019ll need to add that dependency separately.
      • Enhancement: Better support fully modularized lints
      • checkDependencies is no longer enabled by default.
      • Make the baseline file name configurable via slack.lint.baseline-file-name property. Defaults to lint-baseline.xml.
      • Fix: ImplicitSamInstance lint not being enabled.
      "},{"location":"changelog/#057","title":"0.5.7","text":"

      2023-02-15

      • Fix: MergeFileTask.kt was accidentally removed during a previous release.
      • Fix: Add jna-platform dependency to align with the jna dependency version.
      "},{"location":"changelog/#056","title":"0.5.6","text":"

      2023-02-15

      Do not use! Release was accidentally messed up.

      "},{"location":"changelog/#055","title":"0.5.5","text":"

      2023-02-13

      • Fix: LocTask is now compatible with Gradle 8.0 and has the correct task dependencies when Ksp, Kapt, etc are running.
      • Fix: LocTask is now compatible with remote build cache.
      • Enhancement: ModScore now supports KSP.
      • Enhancement: Binary download tasks (KtfmtDownloadTask, DetektDownloadTask, etc) now have prettier and more reliable download progress indications.
      • Enhancement: UpdateRobolectricJarsTask now uses Gradle workers to parallelize downloads. On gigabit wifi, this takes the task runtime down from ~21sec to ~13sec.
      • Enhancement: The boolean SLACK_FORCE_REDOWNLOAD_ROBOLECTRIC_JARS env variable can be used to force UpdateRobolectricJarsTask to redownload jars even if already downloaded. Behavior change: Mod score must now be opted in to via the slack.gradle.config.modscore.enabled=true gradle property.
      • Enhancement: Mod score can be disabled per-project via the slack.gradle.config.modscore.ignore=true gradle property.
      "},{"location":"changelog/#054","title":"0.5.4","text":"

      2023-02-07

      • New: Integrate gradle-dependency-sorter as another formatter. This automatically apply if the sortDependencies toml version is present, and you can have it download+create executable binaries via ./gradlew downloadDependenciesSorter.
      • Enhancement: Improve compose multiplatform support. Now the compose() DSL is moved to slack.features and offers an optional multiplatform parameter to enable the compose multiplatform plugin. 
        slack {\n  features {\n    compose(multiplatform = <true|false>)\n  }\n}\n
      • Build against Kotlin 1.8.10 and AGP 7.4.1.
      "},{"location":"changelog/#053","title":"0.5.3","text":"

      2023-01-27

      • Fix the MergeFilesTask monkeypatch using env vars instead of system props.
      "},{"location":"changelog/#052","title":"0.5.2","text":"

      2023-01-26

      • Try another fix for the MergeFilesTask monkeypatch plus extra logging. Feel free to skip this update if you\u2019re unaffected.
      "},{"location":"changelog/#051","title":"0.5.1","text":"

      2023-01-23

      • Fix: Unwrap Optional for google-coreLibraryDesugaring dependency before adding it. The Gradle API\u2019s lack of type safety strikes again.
      "},{"location":"changelog/#050","title":"0.5.0","text":"

      2023-01-23

      • New: Introduce a new sgp-monkeypatch-agp artifact. This contains monkeypatches for AGP where we try to fix bugs. This initial version contains a patched MergeFilesTask that sorts files before merging them to ensure deterministic outputs, as we believe this is causing our lint tasks to be non-cacheable across machines. This can be enabled via setting the com.slack.sgp.sort-merge-files system property to true.
      • New: Rework how bugsnag is enabled. Instead of only applying the plugin in release/main builds, we now always apply the plugin and only enable uploads on release/main builds. This allows us to catch issues with the plugin in updates sooner, as before we would not see them on PRs.
      • Uploads can be force-enabled via setting the slack.gradle.config.bugsnag.enabled gradle property to true.
      • Branches that allow uploads can be configured via regexp value on the slack.gradle.config.bugsnag.enabledBranchPattern gradle property. For example: slack.gradle.config.bugsnag.enabledBranchPattern=main|release_.*.
      • New: Source desugar libraries from libs.versions.toml instead of assuming the artifact name. Starting with 1.2.0, desugar JDK libs offers multiple artifacts. Point google-coreLibraryDesugaring in [libraries] to whichever artifact should be used.
      • Fix: Catch and print errors with thermal closes.
      • Misc: Update to JDK 19 and latest AGPs. The plugin itself still targets JVM 11 bytecode. AGP 7.4.0 is now required.
      "},{"location":"changelog/#042","title":"0.4.2","text":"

      2023-01-13

      • Enhancement: Change default gradle memory percent in bootstrap from 25% to 50%.
      • Fix: Support the gradle enterprise plugin retry implementation when using Gradle enterprise 3.12+.
      "},{"location":"changelog/#041","title":"0.4.1","text":"

      2023-01-09

      Happy new year!

      • Fix: Remove EitherNet compiler option opt-ins.
      • Update Okio to 3.3.0.
      "},{"location":"changelog/#040","title":"0.4.0","text":"

      2022-12-29

      • Update to Kotlin 1.8.0. This plugin now requires Kotlin 1.8.0 or later as it only configures KGP\u2019s new compilerOptions API now.
      "},{"location":"changelog/#038","title":"0.3.8","text":"

      2022-12-22

      • Add support for AGP 8.0.0-alpha10.
      "},{"location":"changelog/#037","title":"0.3.7","text":"

      2022-12-19

      • Fix: Don\u2019t apply freeCompilerArguments.
      • Fix: Add missing license information to published POM files.
      "},{"location":"changelog/#036","title":"0.3.6","text":"

      2022-12-15

      • Backport android.packagingOptions.jniLibs.pickFirst for AGP 8.x compatibility, as the returned type by jniLibs changed from JniLibsPackagingOptions to JniLibsPackaging.
      "},{"location":"changelog/#035","title":"0.3.5","text":"

      2022-12-06

      • Introduce compileCiUnitTest lifecycle task to just compile (but not run!) unit tests that are run by ciUnitTest.
      "},{"location":"changelog/#034","title":"0.3.4","text":"

      2022-12-04

      • Only enable isIncludeAndroidResources in Android unit tests automatically when robolectric() is used.
      "},{"location":"changelog/#033","title":"0.3.3","text":"

      2022-11-11

      • Add some more Kotlin compiler arguments to compilations. See #160
      "},{"location":"changelog/#032","title":"0.3.2","text":"

      2022-11-10

      • (Strict mode only) Check for AndroidManifest.xml files in androidTest sources + ensure they\u2019re debuggable.
      "},{"location":"changelog/#031","title":"0.3.1","text":"

      2022-10-20

      • Exclude **/build/** from Detekt tasks.
      "},{"location":"changelog/#030","title":"0.3.0","text":"

      2022-10-14

      • New: Support com.android.test projects.
      • New: Preliminary support for AGP 8.x.
      • Automatically add compose compiler dep in Compose multiplatform (i.e. org.jetbrains.compose) projects.
      • Support Error Prone Gradle Plugin 3.x.
      • Update me.tongfei:progressbar to 0.9.5.
      "},{"location":"changelog/#024","title":"0.2.4","text":"

      2022-10-06

      • Fix: Only check allowed androidTest variants if any are defined.
      "},{"location":"changelog/#023","title":"0.2.3","text":"

      2022-10-03

      • Fix: Only configure bootstrap conditionally.
      "},{"location":"changelog/#022","title":"0.2.2","text":"

      2022-10-03

      • Add necessary --add-opens to Test tasks for Robolectric 4.9+ when it\u2019s enabled.
      • Avoid subprojects module stats and allprojects in bootstrap for better project isolation support.
      "},{"location":"changelog/#021","title":"0.2.1","text":"

      2022-09-27

      • Fix: New androidTest(allowedVariants = ...) wasn\u2019t running on com.android.application projects.
      • Fix: Configure Lint DSL block for com.android.library and org.jetbrains.kotlin.jvm projects too.
      "},{"location":"changelog/#020","title":"0.2.0","text":"

      2022-09-23

      • Add option to enable only certain variants\u2019 android tests.
      slack {\n  android {\n    features {\n      androidTest(allowedVariants = setOf(\"internalDebug\"))\n    }\n  }\n}\n
      "},{"location":"changelog/#012","title":"0.1.2","text":"

      2022-09-20

      • Support Robolectric jars for Android API 30.
      "},{"location":"changelog/#011","title":"0.1.1","text":"

      2022-09-08

      • Fix wrong slack.unit-test plugin application.
      "},{"location":"changelog/#010","title":"0.1.0","text":"

      2022-09-07

      • Update to Moshi 1.14.0.
      • Disable Instantiatable lint in min SDK 28+ due to lint bug.
      • Specify kotlin version in compose compatibility check.
      "},{"location":"code-of-conduct/","title":"Code of Conduct","text":""},{"location":"code-of-conduct/#introduction","title":"Introduction","text":"

      Diversity and inclusion make our community strong. We encourage participation from the most varied and diverse backgrounds possible and want to be very clear about where we stand.

      Our goal is to maintain a safe, helpful and friendly community for everyone, regardless of experience, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, nationality, or other defining characteristic.

      This code and related procedures also apply to unacceptable behavior occurring outside the scope of community activities, in all community venues (online and in-person) as well as in all one-on-one communications, and anywhere such behavior has the potential to adversely affect the safety and well-being of community members.

      For more information on our code of conduct, please visit https://slackhq.github.io/code-of-conduct

      "},{"location":"contributing/","title":"Contributors Guide","text":"

      Note that this project is considered READ-ONLY. You are welcome to discuss or ask questions in the discussions section of the repo, but we do not normally accept external contributions without prior discussion.

      "},{"location":"contributing/#development","title":"Development","text":"

      Check out this repo with Android Studio or IntelliJ. It\u2019s a standard gradle project and conventional to check out.

      The primary project is slack-plugin.

      Kotlin should be used for more idiomatic use with Gradle/AGP APIs

      Code formatting is checked via Spotless. To run the formatter, use the spotlessApply command.

      ./gradlew spotlessApply\n

      Optionally, there are commit hooks in the repo you can enable by running the below 

      git config core.hooksPath config/git/hooks\n

      "},{"location":"platforms/gradle/architecture/","title":"Architecture","text":"

      Foundry contains three Gradle plugins and some associated helper artifacts.

      "},{"location":"platforms/gradle/architecture/#foundryrootplugin","title":"FoundryRootPlugin","text":"

      This is the root plugin that is applied to the root project of a multi-project build.

      plugins {\n  id(\"foundry.root\")\n}\n

      Its responsibilities include:

      • Registering the FoundryTools build service.
      • Setting up global configuration (i.e. global lifecycle tasks, download tasks, etc).
      • Validating the JDK matches the expected JDK defined in libs.versions.toml.
      • Configure git (hooks, ignored revisions, etc).
      • (If running on macOS) Validating the build isn\u2019t running in Rosetta mode.
      "},{"location":"platforms/gradle/architecture/#foundrybaseplugin","title":"FoundryBasePlugin","text":"

      This is the base plugin that is applied to all projects (including the root project).

      plugins {\n  id(\"foundry.base\")\n}\n

      Its responsibilities include:

      • Configuring formatters for Spotless.
      • Configuring the buildscript and dependency classpaths. This includes \u201cfixing\u201d any known bad dependencies (Hamcrest and CheckerFramework are a mess), failing on non-reproducible dependency declarations.
      • Running standard subproject configurations via StandardProjectConfigurations.
      • Configuring unit tests via UnitTests. This also includes configuring the Gradle test retry plugin, if enabled.
      • Configuring NullAway, if enabled.
      • Configuring Skippy.
      • Configuring Mod Score tasks.
      "},{"location":"platforms/gradle/architecture/#standardprojectconfigurations","title":"StandardProjectConfigurations","text":"

      This class warrants special mention as it is responsible for the bulk of the configuration applied to projects SGP manages.

      • Creates and exposes the foundry extension DSL.
      • Applies common configurations.
      • This largely just sets up the dependency sorter plugin.
      • Applies common JVM configurations.
      • Applies common Kotlin configurations.
      "},{"location":"platforms/gradle/architecture/#jvm-configurations","title":"JVM Configurations","text":"

      All JVM projects (Android, Java, Kotlin) receive some common configuration for their JVM tasks.

      "},{"location":"platforms/gradle/architecture/#common","title":"Common","text":"
      • Applies the repo\u2019s platform project, if any.
      • Applies any BOM dependencies to platform-configurable configurations.
      • Configures the dependency analysis gradle plugin and DependencyRake.
      • Applies common annotations and common test bundles from version catalogs.
      • Fails on non-androidx support library dependencies.
      • Configure common annotations processors.
      • This logic is largely in StandardProjectConfigurations.configureAnnotationProcessors() and StandardProjectConfigurations.APT_OPTION_CONFIGS, which seeks to apply common configs for known processors like Dagger and Moshi.
      "},{"location":"platforms/gradle/architecture/#java","title":"Java","text":"

      Java projects are fairly simple. Note that these are applied on all projects that apply the java plugin, which is most of them!

      • They are just configured to ensure their source/target compatibility is set to the repo\u2019s JVM target.
      • In non-android projects, JavaCompile tasks have their options.release property set to this as well.
      • Gradle toolchains are used to manage the JDK used for JavaCompile tasks in non-android projects to ensure consistency.
      • All JavaCompile tasks have -parameters added to options.compilerArgs for better static analysis and annotation processing support.
      • If opted-in, error-prone and nullaway are applied and set up with the project with common configurations (configured checks, ignoring build dirs, etc).
      • Foundry supports Error-Prone\u2019s auto-patching mode via enabling the foundry.epAutoPatch property.
      "},{"location":"platforms/gradle/architecture/#android","title":"Android","text":"
      • Configures AndroidTest APK aggregation with Skippy support.
      • Applies the Android cache fix plugin, if enabled.
      • Configures common AGP extensions (both legacy extensions and new Component extensions).
      • Disables unused/irrelevant variants. SGP is single-variant for library projects by default.
      • Disables android tests on projects unless opted in.
      • Disables unit tests on app projects by default (we use the app project as just a shell project for producing an APK).
      • Configures compileOptions, defaultConfig, compileSdk/targetSdk/minSdk/ndkVersion, etc.
        • Enables vectorDrawables.useSupportLibrary.
      • Enables core library desugaring.
      • Configures common testOptions like orchestrator, unitTests, etc.
        • unitTests.isReturnDefaultValues is always enabled for convenience.
        • unitTests.isIncludeAndroidResources is only enabled if robolectric is enabled on the project, as this is expensive to enable.
        • Set up unit test Test tasks to depend on the UpdateRobolectricJarsTask if robolectric is enabled.
      • Patches objenesis dependency versions due to weird transitive dependencies in android test classpaths.
      • Configures com.android.library and com.android.application projects. com.android.test is supported but somewhat limited.
      • Application projects\u2026
      • have their packaging config set up with some convenience common exclusions and handling common jniLibs handling.
      • have v3 and v4 signing enabled by default.
      • are configured with PermissionChecks.
      • are configured with the Bugsnag gradle plugin, if enabled.
      • Library projects\u2026
      • are configured with an automatic android.namespace, if none is manually specified in the buildscript. The namespace is inferred from the project\u2019s Gradle path.
      • are single-variant by default, set to release.
      "},{"location":"platforms/gradle/architecture/#kotlin-configurations","title":"Kotlin Configurations","text":"

      Kotlin projects are configured with KGP and Detekt in mind. SGP supports configuring Android, JVM, Multiplatform, and Compose Multiplatform projects. Multiplatform for targets other than JVM/android is limited at the moment.

      Common configurations include:

      • Setting computed kotlin daemon JVM args.
      • Setting the jvmToolchain to align with the repo\u2019s JDK target.
      • Configuring KotlinCompilation tasks with common configurations.
      • Enabling allWarningsAsErrors.
      • Adding free compiler args to freeCompilerArgs.
        • If a JVM compilation, add extra JVM args + set jvmTarget and javaParameters.
        • Dynamic, dependency-based compiler args are also set via StandardProjectConfigurations.configureFreeKotlinCompilerArgs(). This is an annoying thing to have to do, but necessary because kotlinc will complain if you add opt-ins that are not recognized by any dependencies on that classpath.
      • Enabling K2 testing.
      • Configure Detekt, if enabled, via DetektTasks.
      • Configure Lint if not an Android project via the com.android.lint plugin and LintTasks.
      • Configure the src/{variant}/kotlin source set in android projects, as these are still not automatically enabled.
      • Prevent use of the deprecated android.extensions extension.
      • Configure kapt (if requested) with common configuration
      • correctErrorTypes is set to true for better error messages.
      • mapDiagnosticLocations is set to false because it\u2019s broken.
      • Unless opted-in, disables kapt in tests due to this.
      "},{"location":"platforms/gradle/architecture/#apkversioningplugin","title":"ApkVersioningPlugin","text":"
      plugins {\n  id(\"com.slack.gradle.apk-versioning\")\n}\n

      This plugin is applied in Android application projects and is solely to configure the versionCode and versionName of APKs based on git and Gradle property inputs.

      The following properties are sourced

      versionMajor=...\nversionMinor=...\nversionPatch=...\n

      This also adds a generateVersionProperties task that is more or less only relevant for Slack\u2019s internal CI.

      "},{"location":"platforms/gradle/architecture/#agp-handlers","title":"AGP Handlers","text":"

      SGP is designed to work with multiple versions of AGP at a time, albeit only for forward compatibility and testing reasons. Generally SGP will only be tested against the latest stable version of AGP. To support multiple beta/canary versions of upcoming AGP versions, SGP has an API called AgpHandler, which is intended to be an AGP-agnostic common interface for configuring AGP projects across breaking API (source or binary) changes. When a new such change is introduced, we create an AgpHandler{version} artifact and implementation with that AGP version as its minimum. At runtime, SGP loads the relevant AgpHandler instance for the AGP version it is running against and relevant APIs use this instance via FoundryTools to interact with them in a version-agnostic way. These aren\u2019t always needed so there may be times when there are no implementations needed for the current suite of AGP versions.

      An example handler for AGP 8.0 looks like this.

      // AutoService makes it available via ServiceLoader\n// The factory should always be AGP-api agnostic.\nclass AgpHandler80 : AgpHandler {\n  @Suppress(\"DEPRECATION\")\n  override val agpVersion: String\n    get() = com.android.builder.model.Version.ANDROID_GRADLE_PLUGIN_VERSION\n\n  @AutoService(AgpHandlerFactory::class)\n  class Factory : AgpHandlerFactory {\n    override val minVersion: VersionNumber = VersionNumber.parse(\"8.0.0\")\n\n    @Suppress(\"DEPRECATION\")\n    override fun currentVersion(): String =\n      com.android.builder.model.Version.ANDROID_GRADLE_PLUGIN_VERSION\n\n    override fun create(): AgpHandler {\n      return AgpHandler80()\n    }\n  }\n}\n
      "},{"location":"platforms/gradle/bootstrap/","title":"Bootstrap","text":"

      Bootstrap is a tool for bootstrapping local dev environments. This is usually used in tandem with a bootstrap bash script that runs the ./gradlew bootstrap task and any other repo-specific setups.

      The core implementation lives in BootstrapTask.kt.

      At a high level, bootstrap is mostly focused on configuring the JDK and daemon environments. Gradle has extremely limited configurability for the Gradle daemon, and we want to optimize the JDK for available space on different developer machines. To support this, we compute optimal daemon jvm arguments in bootstrap and write them to the user\u2019s home ~/.gradle/gradle.properties to override repo-specific settings with client-side properties.

      For the JDK, it requests the JDK toolchain from Gradle\u2019s first-party APIs. This includes allowing Gradle to download the JDK if it\u2019s missing, which is useful for getting developers set up and running faster.

      Bootstrap is also useful on CI for its ability to scale available memory to the machine it\u2019s running on, so we generally run it as a preflight step for all of our CI jobs too.

      Finally, there are some other specific things it does to optimize things:

      • Disable Gradle file watching on CI as it\u2019s not necessary there.
      • Configure specific GC and heap args for optimized use in Gradle builds (favoring larger young generation spaces).
      • Configure a fixed-size heap for CI to avoid time spent growing the heap.
      "},{"location":"platforms/gradle/configuration/","title":"Configuration","text":"

      TODO

      "},{"location":"platforms/gradle/dependency-rake/","title":"Dependency Rake","text":"

      Dependency rake is an tool we develop within foundry (SGP) to automatically clean up Gradle build files.

      This tool uses the outputs of the dependency-analysis-gradle-plugin ( DAGP) to infer and apply fixes it recommends.

      "},{"location":"platforms/gradle/dependency-rake/#types-of-fixes","title":"Types of Fixes","text":"

      There are three main categories of fixes that DR applies.

      1. Remove unused dependencies.
        • Like it says on the tin, these are declared dependencies that are unused and should be removed.
      2. Fix misused dependencies.
        • These are dependencies that are declared but only transitive dependencies they include are actually used. For example - depending on RxAndroid but only using RxJava from it. These are fixed by replacing the dependency with the specific transitive dependency.
      3. Fix wrong configurations.
        • These are dependencies that declare the wrong Gradle configuration (e.g. api, implementation, etc). Dependencies determined to be used in the \u201cpublic ABI\u201d of the library should be \u201capi\u201d configuration for use in dependent projects. Anything else can be hidden as an \u201cimplementation\u201d or \u201ccompileOnly\u201d (if annotations-only) dependency.
      "},{"location":"platforms/gradle/dependency-rake/#benefits","title":"Benefits","text":"

      The primary benefit of dependency rake is to improve build times by more or less \u201craking\u201d the build dependency graph. By removing and fixing dependencies, we remove unneeded edges in the build graph. This in turn provides improved build parallelism and better avoidance in Skippy CI pipelines.

      A secondary benefit is automatic upkeep of build files. As projects change over time, dependencies become obsolete and out of date. Most developers do not keep up with these changes over time, so automating this affords us extra upkeep that we currently do not do.

      "},{"location":"platforms/gradle/dependency-rake/#implementation","title":"Implementation","text":"

      The core implementation of DR lives in DependencyRake.kt.

      "},{"location":"platforms/gradle/dependency-rake/#usage","title":"Usage","text":"

      To run dependency rake in a project, use the below command

      $ ./gradlew rakeDependencies -Pfoundry.config.enableAnalysisPlugin=true --no-configuration-cache\n

      This will run all rakeDependencies tasks in the project. This task exists on all subprojects as well, but it works best if all are run together.

      Sometimes dependency rake will try to replace identifiers with ones that are not present in any available version catalogs. Sometimes this is acceptable, but often times it can result in \u201cmissing\u201d dependencies from the build after it runs. To help fix these, DR will write all missing identifiers out to a build output file.

      For convenience, you can also run ./gradlew aggregateMissingIdentifiers -Pslack.gradle.config.enableAnalysisPlugin=true --no-configuration-cache to run all dependency rake tasks and aggregate these missing identifiers into a root project build output file.

      "},{"location":"platforms/gradle/dsl/","title":"DSL","text":"

      SGP offers a DSL extension for configuring project behavior via the plugin. The idea is that developers don\u2019t really want to think about specific dependency wirings, and instead want to express what features they want and allow SGP to automatically wire these up for them.

      Some examples of this include Dagger, Moshi code gen, Robolectric, and more.

      The primary entry point is the slack extension in the build file, which is backed by the SlackExtension interface.

      foundry {\n    features {\n        dagger(...)\n        moshi(...)\n    }\n    android {\n        features {\n            robolectric(...)\n        }\n    }\n}\n
      "},{"location":"platforms/gradle/dsl/#features","title":"Features","text":""},{"location":"platforms/gradle/dsl/#circuit","title":"Circuit","text":"

      The Circuit feature automatically sets up Circuit in the project. This includes controls for different Circuit artifacts and code gen. The default circuit() call will just enable Circuit\u2019s runtime + code gen.

      "},{"location":"platforms/gradle/dsl/#dagger","title":"Dagger","text":"

      The Dagger feature automatically sets up both Dagger and Anvil. This includes optional parameters to control whether or not you want the runtime only, component merging, or other features. This automatically handles applying the Anvil, kapt, or KSP plugins under the hood and any necessary dependencies to run them.

      The default dagger() call will just enable Dagger\u2019s runtime + Anvil\u2019s factory generation with no component merging ( to avoid the Kapt cost).

      "},{"location":"platforms/gradle/dsl/#moshi","title":"Moshi","text":"

      The Moshi feature handles setting up both Moshi and MoshiX. This includes handling applying code gen logic (either KSP or IR) as well as moshi-sealed support if requested.

      "},{"location":"platforms/gradle/dsl/#redacted","title":"Redacted","text":"

      This enables the redacted-compiler-plugin compiler plugin.

      "},{"location":"platforms/gradle/dsl/#compose","title":"Compose","text":"

      The Compose feature handles setting up Compose in both Android and multiplatform projects. This handles a bunch of boilerplate (see ComposeUtil.kt) for applying the right compose-compiler artifact version as well as enabling the right controls in the Android plugin.

      "},{"location":"platforms/gradle/dsl/#test-fixtures","title":"Test Fixtures","text":"

      This enables Gradle test fixtures in a project-agnostic fashion. In JVM projects this will apply the java-test-fixtures plugin, in Android projects this will configure the android.testFixtures.enable property.

      "},{"location":"platforms/gradle/dsl/#android-features","title":"Android Features","text":""},{"location":"platforms/gradle/dsl/#robolectric","title":"Robolectric","text":"

      The Robolectric feature handles setting up Robolectric in an Android project. This entails common Robolectric dependencies (including any bundles or core Robolectric project dependencies). This also sets up Robolectric jar downloads (via UpdateRobolectricJarsTask) for test tasks and enabling resource merging in tests (which Robolectric requires). There are a few other controls that StandardProjectConfigurations use to control or patch Robolectric\u2019s behavior.

      "},{"location":"platforms/gradle/dsl/#android-test","title":"Android Test","text":"

      By default, SGP disables androidTests in projects. These can be enabled via the androidTest() feature, which will enable the relevant controls in the Android plugin. This can also accept specified variants to enable/disable.

      This is important for opting in tests to AndroidTest APK Aggregation.

      "},{"location":"platforms/gradle/dsl/#resources","title":"Resources","text":"

      By default, we disable Android resources (different from Java resources) and libraries have to opt-in to using them.

      This can be enabled via the resources() feature, which will enable the relevant BuildFeature in the Android plugin and also takes a required prefix parameter that is used as the required resourcePrefix for that library\u2019s resources to avoid naming conflicts.

      "},{"location":"platforms/gradle/dsl/#android-application-features","title":"Android Application Features","text":""},{"location":"platforms/gradle/dsl/#permission-allowlist","title":"Permission AllowList","text":"

      This enables checking of a permission allowlist. See PermissionChecks for more details.

      "},{"location":"platforms/gradle/formatters-and-analysis/","title":"Formatters and Static Analysis","text":"

      SGP supports running a number of formatters and static analysis tools.

      Individual tools are usually gated on whether they have a version specified in libs.versions.toml. If they do not have a version specified, they are deemed not enabled.

      "},{"location":"platforms/gradle/formatters-and-analysis/#formatting","title":"Formatting","text":"

      The core set of formatters are:

      • ktfmt (Kotlin)
      • google-java-format (Java)
      • gson (JSON)
      • gradle-dependency-sorter (Gradle build file dependencies)
      • Spotless (general purpose Gradle plugin that runs most of the above)
      "},{"location":"platforms/gradle/formatters-and-analysis/#static-analysis","title":"Static Analysis","text":"

      The core set of analysis tools supported in SGP are:

      • Android Lint (Kotlin, Java, XML resources, build files, etc.)
      • Detekt (Kotlin)
      • Error Prone (Java)
      "},{"location":"platforms/gradle/formatters-and-analysis/#git-hooks","title":"Git Hooks","text":"

      SGP ships with a standard set of git hooks (pre-commit, etc) that it can bootstrap in projects by running ./gradlew installCommitHooks. These hooks rely on checking in relevant binaries for each formatter/checker, it\u2019s strongly recommended to use git-lfs for these. These files should be edited as needed to best serve the project they\u2019re running in.

      SGP can configure these hooks in the project automatically during bootstrap if you add the foundry.git.hooksPath gradle property and point it at the hooks directory that the above command output to, or wherever the host project opts to store them.

      Note that Detekt is not yet supported in git hooks as these require extra parameters for baselines.

      "},{"location":"platforms/gradle/formatters-and-analysis/#downloading-binaries","title":"Downloading binaries","text":"

      Each tool (ktfmt, gjf, etc) has corresponding ./gradlew update<tool name> tasks that you can run to download and install them, by default to config/bin/<tool name>. You should re-run these any time you update a tool to re-run them.

      "},{"location":"platforms/gradle/lint/","title":"Lint","text":"

      TODO

      "},{"location":"platforms/gradle/mod-score/","title":"Mod Score","text":"

      TODO

      "},{"location":"platforms/gradle/properties/","title":"Properties","text":"

      TODO

      "},{"location":"platforms/gradle/testing/","title":"Testing","text":"

      TODO

      "},{"location":"platforms/gradle/thermals-logging/","title":"Thermals Logging","text":"

      TODO

      "},{"location":"platforms/gradle/utilities/","title":"Utilities","text":"

      There are a bunch of miscellaneous utilities and tools in this project that don\u2019t necessarily warrant their own dedicated docs page.

      "},{"location":"platforms/gradle/utilities/#androidsourcesconfigurer","title":"AndroidSourcesConfigurer","text":"

      When testing new Android SDK betas, the compile SDK version is available months before sources are. Developers want to build against these APIs, but we don\u2019t want to make their experience in the IDE worse than necessary. The problem with using a compile SDK version that doesn\u2019t have sources is that the IDE can\u2019t provide any documentation for the APIs and will just show stub files instead.

      To work mitigate this, we will patch the SDK by putting a copy of the previous version\u2019s sources in the location of the new SDK. This allows most sources to still index properly during the beta period. Then, once the new sources are available, the consuming repo needs only to update the foundry.latestCompileSdkWithSources gradle property to that new SDK version and the patcher will clear out that copy and let AGP download the real ones.

      This runs automatically in the root plugin.

      "},{"location":"platforms/gradle/utilities/#androidtest-apk-aggregation","title":"AndroidTest APK Aggregation","text":"

      At Slack we use FTL + Fladle for running our instrumentation tests. In order to add more test APKs from modularized instrumentation tests in other subprojects, we have to aggregate a list of their locations and pass them on to Fladle. This is done via AndroidTestApksTask, which is registered in the root project and can be wired to pipe its output file into Fladle\u2019s config input.

      Example

      val aggregatedApksProvider = rootProject.tasks\n  .named<AndroidTestApksTask>(\"aggregateAndroidTestApks\")\n  .flatMap { it.outputFile }\n  .map { it.asFile.readLines() }\n\ntasks\n  .withType<YamlConfigWriterTask>()\n  .named { it == \"writeConfigProps${fladleTarget}\" }\n  .configureEach { additionalTestApks.value(testInputsProvider) }\n

      This task is automatically added to whenever a subproject uses the androidTest() DSL feature.

      "},{"location":"platforms/gradle/utilities/#permissionchecks","title":"PermissionChecks","text":"

      Permissions are an integral part of Android apps, and oversight into what permissions are required in the app is critical to a release pipeline. PermissionChecks is a feature to help with this.

      The workflow we use at Slack is like this:

      • We check in a permissionsAllowlist.txt file in the Slack android repo.
      • This file is owned in GitHub by a specific codeowner rule that adds a permission reviewers group.
      • This file is passed into the allowListFile DSL feature in the application project.
      • On each build, SGP automatically checks that the permissions present in the release APK manifest match the ones defined in the allowlist.

      This way new permissions are not accidentally or secretly added to the app.

      "},{"location":"tools/cli/","title":"Foundry CLIs","text":"

      An artifact containing basic CLI utilities for Kotlin.

      "},{"location":"tools/cli/#installation","title":"Installation","text":"

      // In Gradle\ndependencies {\n  implementation(\"com.slack.foundry:cli:<version>\")\n}\n\n// In kotlin script\n@file:DependsOn(\"com.slack.foundry:cli:{version}\")\n

      "},{"location":"tools/cli/#local-testing","title":"Local testing","text":"

      If consuming these utilities from a kotlin script file, you can test changes like so:

      1. Set the version in gradle.properties, such as 2.5.0-LOCAL1.
      2. Run ./gradlew publishToMavenLocal to publish the current version to your local maven repository.
      3. In your script file, add the local repository and update the version: 
        @file:Repository(\"file:///Users/{username}/.m2/repository\")\n@file:DependsOn(\"com.slack.foundry:cli:{version you set in gradle.properties}\")\n
      4. Repeat as needed while testing, incrementing the version number each time to avoid caching issues.
      "},{"location":"tools/skippy/","title":"Skippy","text":"

      TODO

      "}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"foundry","text":"

      This repository contains much of Slack\u2019s Android/Kotlin/JVM tooling for Gradle, IntelliJ, CLIs, and more.

      This repo is effectively for Slack\u2019s own used but publishes to Maven Central. We develop these in the open to knowledge-share with the community.

      As such, we don\u2019t normally accept external PRs, but we welcome your questions in the discussions section of the project!

      "},{"location":"#highlights","title":"Highlights","text":""},{"location":"#common-project-configuration","title":"Common project configuration","text":"

      The foundry.base plugin offers common configuration for all projects implementing it, covering a wide spectrum of Android, Kotlin, and Java configurations.

      This includes a whole host of things!

      • Common Android configuration (single variant libraries, disabling unused features, compose, etc).
      • Common Kotlin configuration (freeCompilerArgs, JVM target, etc).
      • Common Java configuration (toolchains, release versions, etc).
      • Common annotation processors.
      • FoundryExtension (see next section).
      • Formatting (via Spotless).
      • Platforms and BOM dependencies (see \u201cPlatform plugins\u201d section below).
      • Common lint checks (both on Android and plain JVM projects).

      Full docs can be found in the architecture docs.

      "},{"location":"#feature-dsl","title":"Feature DSL","text":"

      To ease use and configuration of common features in projects, we expose a foundry DSL in projects that allows for configuration of these in a semantically easy and boilerplate-free way. This is controlled via FoundryExtension.

      foundry {\n  features {\n    dagger()\n    moshi(codegen = true)\n  }\n  android {\n    features {\n      robolectric()\n    }\n  }\n}\n

      A major benefit of this is that we can intelligently configure features and avoid applying costly plugins like Kapt unless they\u2019re actually needed for a specific feature, such as Java injections in projects using Dagger. Since this is pure code, we can also propagate deprecated behavior by deprecating the corresponding functions in the DSL.

      "},{"location":"#platform-plugins","title":"Platform plugins","text":"

      Platforms.kt contains an implementation that sources a VersionCatalog and applies it to a Gradle platform project. This allows us to effectively treat our versions catalog as a BOM and apply it to all projects in the consuming repo and reduce dependency version stratification.

      "},{"location":"#thermal-throttling-capture","title":"Thermal throttling capture","text":"

      MacBooks can suffer thermal throttling and result in poor build performance. We built instrumentation for this to capture these and include them in our build scans to better understand their impact. We support both Intel and Apple Silicon macs now and contain this implementation in ThermalsWatcher.kt. This also includes helpful charting APIs for visualizing the data (courtesy of our friends at Square).

      "},{"location":"#better-properties","title":"Better Properties","text":"

      Gradle\u2019s built-in property support is limited and has surprising behavior, so we have our own system on top of it that has consistent precedence, local.properties support, project-local gradle.properties, and configuration caching support. Check out PropertyResolver.

      "},{"location":"#dependency-rake","title":"Dependency Rake","text":"

      DependencyRake.kt contains an extension to the gradle-dependency-analysis-plugin that applies its advice to a project to automatically optimize it and rake dependencies.

      "},{"location":"#module-stats-aka-mod-score","title":"Module Stats (aka \u201cMod Score\u201d)","text":"

      As a part of our modularization efforts, we developed a scoring mechanism for modules that we could use as a measure of their \u201cmodularization\u201d. This includes a number of metrics and weighs them in a formula to compute a score. This includes LoC, language mixtures, and build graph centrality. This logic is under the foundry.stats package.

      "},{"location":"#robolectric-jars-management","title":"Robolectric Jars Management","text":"

      Robolectric uses preinstrumented Android API jars that live on maven central. While it can handle downloading of these automatically, we found this implementation to be brittle and unreliable, so we built our own version of it that handles downloading these into a local .cache directory. This implementation lives in UpdateRobolectricJarsTask.kt and that task is configured to be a dependency of all Test tasks.

      "},{"location":"#bootstrap","title":"Bootstrap","text":"

      We try to simplify and streamline the bootstrap process for both local development and on CI. This involves computing optimized JVM arguments for the Gradle and Kotlin daemons (which differ between CI and local) as well as toe-holds for future customizations. This logic lives in BootstrapTask.kt.

      "},{"location":"#permission-checks","title":"Permission Checks","text":"

      To avoid accidentally checking in any new, unexpected manifest permissions, we have a CheckManifestPermissionsTask that compares the final merged manifest\u2019s permissions to an allow list of known permissions. This is allow list is checked in and expected to be guarded by a CODEOWNERS watch and will fail the build if they differ.

      slack {\n  android {\n    app {\n      permissionAllowlist {\n        if (name == \"externalRelease\") {\n          setAllowlistFile(file(\"permissionsAllowlist.txt\"))\n        }\n      }\n    }\n  }\n}\n
      "},{"location":"#apk-versioning-computers","title":"APK Versioning Computers","text":"

      AGP offers new property-based APIs for computing APK version codes and version names. We use this to compute information from different inputs (CI build number, git state, etc) and control this logic in ApkVersioningPlugin.kt.

      "},{"location":"#check-dependency-versions","title":"Check dependency versions","text":"

      Sometimes a dependency update may bring with it a surprise update to a transitive dependency that we also declare. In order to avoid this happening unexpectedly, the CheckDependencyVersionsTask checks that any transitive dependency versions that also correspond to a version declared in our VersionCatalog match the version there. It\u2019s ok if they don\u2019t, but the author just need to update the version in the catalog too to be explicit (or investigate further if it\u2019s an unwanted surprise!).

      "},{"location":"#agp-handlers","title":"AGP Handlers","text":"

      AGP occasionally contains new or breaking API changes that we want to handle gracefully in early testing. We regularly test against newer preview versions of AGP so we can\u2019t just hardcode in new APIs and expect them to work everywhere. To handle this, we have an AgpHandler interface that can be used to abstract these new APIs in a backward-compatible way. Then we ship implementations of this as different artifacts that are built against different AGP versions. Then, at runtime, we pick the appropriate instance (via service loading) to use for the current AGP version being used in that build.

      "},{"location":"#detekt-baselining","title":"Detekt baselining","text":"

      Detekt is a static analysis tool that we use to check for common issues in our code. We use one global baseline file for baselined issues (when introducing new checks or updates), but Detekt doesn\u2019t currently support this easily. So, we built MergeDetektBaselinesTask to merge all the generated baselines from each subproject into a single global baseline.

      "},{"location":"#misc-tools","title":"Misc tools","text":"

      There are a ton of miscellaneous tools, utilities, and glue code for Gradle (and various plugins) sprinkled throughout this project.

      "},{"location":"#usage-requirements","title":"Usage requirements","text":"

      SGP expects there to be a libs version catalog.

      The following versions are required to be set the above catalog. Their docs can be found in FoundryVersions.kt.

      For Android projects, some extra definitions need to be defined

      • libs.versions.toml libraries
        • google-coreLibraryDesugaring - the core library desugaring libraries to use with L8.
      • gradle.properties properties
        • foundry.compileSdkVersion
        • foundry.targetSdkVersion
        • foundry.minSdkVersion

      The following plugins are applied by default but can be disabled if you don\u2019t need them.

      • Gradle\u2019s test retry \u2013 foundry.auto-apply.test-retry
        • By default, this uses the Gradle test-retry plugin, but can be configured to use the Gradle Enterprise plugin\u2019s implementation instead by setting the foundry.test.retry.pluginType property to GE.
      • Spotless \u2013 foundry.auto-apply.spotless
      • Detekt \u2013 foundry.auto-apply.detekt
      • NullAway \u2013 foundry.auto-apply.nullaway
      • Android Cache Fix \u2013 foundry.auto-apply.cache-fix
      "},{"location":"#commit-hooks","title":"Commit hooks","text":"

      The installCommitHooks task can install commit hooks for formatting kotlin and java files. They expect binaries to be in <root>/config/git/hooks and it\u2019s highly recommended to enable git-lfs for these objects. These binaries can be downloaded via the updateKtfmt, updateGjf, etc tasks.

      "},{"location":"#license","title":"License","text":"
      Copyright 2022 Slack Technologies, LLC\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n
      "},{"location":"changelog/","title":"Changelog","text":""},{"location":"changelog/#unreleased","title":"Unreleased","text":""},{"location":"changelog/#0225","title":"0.22.5","text":"

      2024-11-19

      • [gradle] Make LocTask.generatedSrcsDir @Internal to avoid depending implicitly on outputs of tasks that sometimes only just make empty dirs with no files.
      "},{"location":"changelog/#0224","title":"0.22.4","text":"

      2024-11-15

      • [gradle] Improve Detekt configuration to better ignore generated source files.
      • [gradle] Add skippy support to validateModuleTopography. Now there are globalCiValidateModuleTopography and ciValidateModuleTopography tasks.
      • [gradle] Use mustRunAfter for depending on source gen tasks + add back sqldelight\u2019s schema task as a source-generating task.
      • [gradle] Improve compose matching text to include .setContent {.
      • [gradle] Support custom configurations and overrides of ModuleTopography features via JSON file specified by the foundry.topography.features.config property.
      • Update kaml to 0.65.0.
      • Build against develocity plugin 3.18.2.
      • Build against Roborazzi plugin 1.32.2.
      "},{"location":"changelog/#0223","title":"0.22.3","text":"

      2024-11-13

      • [gradle] Only make LocTask depend on source-generating tasks if MODULE_SCORE_INCLUDE_GENERATED is true.
      "},{"location":"changelog/#0222","title":"0.22.2","text":"

      2024-11-13

      • [gradle] Fix dependencies on source-generating tasks in module stats and topography.
      "},{"location":"changelog/#0221","title":"0.22.1","text":"

      2024-11-12

      • [gradle] Fix FoundryProperties hierarchical init.
      "},{"location":"changelog/#0220","title":"0.22.0","text":"

      2024-11-12

      • [gradle] Introduce new moduleTopography task. This is a general task that attempts to validate project configurations by looking for features that are enabled but unused. Currently covers a few core features like kapt, ksp, moshi code gen, dagger/anvil, and viewbinding. Outputs are printed and written to a JSON file. Add --validate-all to make the tasks fail on validation issues.
      • [gradle] Cache global FoundryProperties instance for subproject use.
      • [gradle] Add composeRuntimeOnly() DSL feature.
      • [cli] Check for non-existent paths before traversing in Path.walkEachFile().
      • [gradle] Don\u2019t depend on build sources in mod score if MODULE_SCORE_INCLUDE_GENERATED is false
      • [gradle] Source module topography in mod score stats collecting
      • [gradle] Build against Gradle 8.11.
      • [gradle] Do not track state in RakeDependencies task.
      • Update to KotlinPoet 2.0.0.
      • Update to xmlutil 0.90.3.
      • Update to kaml 0.62.2.
      • Update to Mordant 3.0.1.
      • Build against gradle-dependency-sorter 0.12.
      • Build against KSP 2.0.21-1.0.27.
      • Build against DAGP 2.4.2.
      • Build against Compose Multiplatform 1.7.0.
      "},{"location":"changelog/#0210","title":"0.21.0","text":"

      2024-10-25

      • New: Extract better-gradle-properties artifact, which is our hierarchical Gradle properties solution that better handles properties in Gradle. This is what powers FoundryProperties but is now extracted to be more portable.
      • This checks in the following order of priority
        • project-local local.properties
        • project-local gradle.properties
        • root-project local.properties
        • root-project/global gradle.properties
      • New: Extract version-number artifact. This contains a Kotlin, non-deprecated VersionNumber API. This is useful given that Gradle\u2019s is both deprecated and not available in standard JVM projects.
      • New: Support Robolectric 4.14.
      • Changed: Remove defunct foundry.git.hooksPath and foundry.git.ignoreRevsFile properties.
      • Changed: Rename SgpArtifact to FoundryArtifact.
      • Misc doc fixes + reorganize docsite around new repo structure.
      • Update xmlutil to 0.90.2.
      • Build against Spotless 7.0.0.BETA4.
      • Build against KSP 2.0.21-1.0.26.
      • Build against DAGP 2.2.0.
      • Build against nullaway-gradle 2.1.0.
      • Build against errorprone-gradle 4.1.0.
      • Build against Compose multiplatform 1.7.0.
      • Build against Dokka 2.0.0-Beta.
      "},{"location":"changelog/#0202","title":"0.20.2","text":"

      2024-10-14

      • Fix: Fall back to old property name for kotlin JVM args if the new one isn\u2019t found.
      • Enhancement: Don\u2019t try to apply kotlin JVM args if there are none.
      "},{"location":"changelog/#0201","title":"0.20.1","text":"

      2024-10-14

      Don\u2019t use this release! We goofed on something.

      "},{"location":"changelog/#0200","title":"0.20.0","text":"

      2024-10-11

      "},{"location":"changelog/#project-restructuring","title":"Project Restructuring","text":"

      We\u2019ve restructured this project! Since its early days as a simple Gradle convention plugin it\u2019s expanded into IntelliJ plugins, CLIs, CI tooling, and more. To better capture this, we\u2019ve renamed the project to Foundry, restructured its artifacts into a more cohesive setup, moved kotlin-cli-util into this repo, and will likely split out some more artifacts down the line.

      "},{"location":"changelog/#migration-guide","title":"Migration Guide","text":"
      • Any gradle properties prefixed with slack. or sgp. have now moved to foundry.. slack.gradle. prefix have also removed the gradle. (i.e. slack.gradle.foo would now be foundry.foo).
      • SlackProperties has been renamed to FoundryProperties.
      • Some properties have been further refined to be more specific.

      • There is a helper script you can use to automatically rename all properties in foundry-migration/.

        • Download mapping.txt
        • Download property_migration.sh
        • Run ./property_migration.sh mapping.txt <path to target project>.
        • Note this only covers *.kts and *.properties files. This does not cover args passed via CLI or envs.

      • Package names have all aligned to foundry.*. In most cases it should be simple enough to replace import com.slack.* with import foundry.*.

      • Gradle coordinates group have moved to the com.slack.foundry group name.

        Old Artifact ID New Artifact ID sgp gradle-plugin sgp-agp-handler-api agp-handler-api sgp-common foundry-common sgp-tracing tracing skippy skippy

      • The former kotlin-cli-util APIs have moved to the com.slack.foundry:cli artifact.

      • Platform-specific plugins now live under the platforms/ directory.
      • All other tools now live under the tools/ directory.
      • Most top-level Slack-prefixed APIs are now prefixed with Foundry.
      • The primary gradle entry points are now foundry {}, but the previous slack {} entry points are left with deprecation ReplaceWith options.

      • Gradle plugin IDs have migrated to com.slack.foundry.* names.

        Old New com.slack.gradle.root com.slack.foundry.root com.slack.gradle.base com.slack.foundry.base com.slack.gradle.apk-versioning com.slack.foundry.apk-versioning

      • Introduce new required foundry.android.defaultNamespacePrefix property for android projects. This is necessary for projects that don\u2019t define an android.namespace explicitly.

      "},{"location":"changelog/#misc","title":"Misc","text":"
      • New: Make JDK configuration docs and error messages configurable via FoundryProperties.
      • Fix: Gracefully handle undefined kapt language versions when computing progressive.
      • Fix: Track deleted build files when computing parent projects in Skippy.
      • Update Clikt to 5.0.1.
      • Update oshi-core to 6.6.5.
      • Build against DAGP 2.x.
      • Build against gradle-error-prone 4.0.1.
      • Build against gradle-nullaway 2.0.0.
      • Build against Gradle versions plugin 0.51.0.
      • Build against Develocity plugin 3.18.1.
      "},{"location":"changelog/#0196","title":"0.19.6","text":"

      2024-09-25

      • Intro SoftRefLRUPolicyMSPerMB + ReservedCodeCacheSize jvm args to bootstrap
      • Learnings from https://jasonpearson.dev/codecache-in-jvm-builds and https://jasonpearson.dev/softreflrupolicymspermb-in-jvm-builds.
      • Update kotlin-cli-util to 3.0.1.
      • Update to Guava 33.3.1-jre.
      • Build against Gradle 8.10.2.
      "},{"location":"changelog/#0195","title":"0.19.5","text":"

      2024-09-23

      • Add workaround for KGP not applying sourceInformation compose options in android projects and default it to true.
      "},{"location":"changelog/#0194","title":"0.19.4","text":"

      2024-09-22

      • Change slack.allowWarnings property to sgp.kotlin.allowWarnings.
      • Disallow warnings in Kotlin test compilations by default, add sgp.kotlin.allowWarningsInTests property to opt-out.
      • Update to kotlinx-coroutines 1.9.0.
      • Update Okio to 3.9.1.
      • Update to Clikt 5.0.0.
      • Update JNA to 5.15.0.
      • Update oshi-core to 6.6.4.
      • Update kotlin-cli-util to 3.0.0.
      • Build against AGP 8.6.1.
      "},{"location":"changelog/#0193","title":"0.19.3","text":"

      2024-09-12

      • Change: Rename testFixtures() feature DSL to enableTestFixtures() to disambiguate from Gradle\u2019s methods.
      • New: Introduce new sgp.compose.stabilityConfigurationPath property to specify a Compose configuration file path from the root project. It is also now disallowed to specify this via sgp.compose.commonCompilerOptions.
      "},{"location":"changelog/#0192","title":"0.19.2","text":"

      2024-09-12

      • [sgp] New: Add new slack { features { testFixtures() } } DSL for enabling test fixtures in a project-agnostic way.
      • [sgp] Make slack.location.robolectric-core property optional.
      • [sgp] Clean up duplicate Kotlin JVM argument handling in KaptGenerateStubsTask.
      • [sgp] Update to the new compose-compiler-gradle-plugin feature flag API.
      • [sgp] Apply platform project BOMs to SqlDelight DialectClasspath configurations too.
      • [sgp] Build against KSP 2.0.20-1.0.25.
      • [sgp] Build against AGP 8.6.0.
      • [sgp] Build against Gradle 8.10.1.
      • [sgp] Build against Wire 5.1.0.
      • [skippy] Don\u2019t treat testFixtures as test sources
      "},{"location":"changelog/#0191","title":"0.19.1","text":"

      2024-09-03

      • Add slack.bootstrap.minGradleXms property to set minimum xms values for daemon memory args.
      • Apply slack.boostrap.minGradleXm* values to kotlin daemon jvm args too.
      • Remove MaxMetaspace caps from bootstrap. This shouldn\u2019t be set anymore in JDK 17+.
      • Update develocity-gradle-plugin-adapters to 1.0.4.
      • Update Bugsnag to 3.7.2.
      • Build against AGP 8.6.0.
      "},{"location":"changelog/#0190","title":"0.19.0","text":"

      2024-08-27

      • Improve KGP plugin handling to better support upcoming AGP kotlin compilation.
      • Build with JDK 22. Still targets JVM 17.
      • Update MoshiX to 0.28.0.
      • Update RxJava to 3.1.9.
      • Update Oshi to 6.6.3.
      • Revert dependency sorter back to 0.7.
      • Build against Kotlin 2.0.20.
      • Build against redacted-compiler-plugin 1.10.0.
      • Build against KSP 2.0.20-1.0.24.
      • Build against Gradle 8.10.
      "},{"location":"changelog/#0184","title":"0.18.4","text":"

      2024-08-12

      • Add sgp.kapt.languageVersion property to override the language version used for KAPT.
      • Build against Kotlin 2.0.10.
      • Build against KSP 2.0.10-1.0.24.
      • Build against AGP 8.5.2.
      "},{"location":"changelog/#0183","title":"0.18.3","text":"

      2024-08-04

      • Add support for changing Anvil implementations.
      "},{"location":"changelog/#0182","title":"0.18.2","text":"

      2024-07-31

      • Fix applying free compiler args from Gradle properties.
      • Gate disabling compose live literals on relevant AGP versions. This is deprecated in new AGP versions.
      • Remove a noisy log.
      • Streamline dagger ksp handling + remove napt support.
      • Update Kaml to 0.61.0.
      • Update Oshi to 6.6.2.
      • Build against DAGP 1.33.0.
      • Build against KSP 2.0.0-1.0.24.
      • Build against Anvil 2.5.0-beta11.
      "},{"location":"changelog/#0181","title":"0.18.1","text":"

      2024-07-19

      • Fix: Fix circular evaluation dependency for jvmTarget.
      • Remove Kover Workaround for 0.7.1.
      • Turn off xml report generation for lint task.
      • Update KotlinPoet to 1.18.1.
      • Update Wire to 5.0.0.
      • Update MoshiX to 0.27.2.
      • Build against Gradle 8.9.
      • Build against KSP 2.0.0-1.0.23.
      • Build against AGP 8.5.1.
      • Build against sort-dependencies 0.7.
      "},{"location":"changelog/#0172","title":"0.17.2","text":"

      2024-05-28

      • Make default Kotlin compiler arguments more configurable. This includes removing some previously-default behavior.
      • sgp.kotlin.languageVersionOverride. Default is null, which will just defer to KGP\u2019s default.
      • sgp.kotlin.optIns
        • Previous default opt-ins = kotlin.contracts.ExperimentalContracts, kotlin.experimental.ExperimentalTypeInference, kotlin.ExperimentalStdlibApi, kotlin.time.ExperimentalTime
      • sgp.kotlin.freeArgs
        • Previous default free args = -Xenhance-type-parameter-types-to-def-not-null, -Xself-upper-bound-inference
      • sgp.kotlin.jvmFreeArgs
        • Previous default JVM free args = -Xjsr305=strict, -Xassertions=jvm, -Xemit-jvm-type-annotations, -Xjvm-default=all, -Xtype-enhancement-improvements-strict-mode, -Xjspecify-annotations=strict
      • sgp.kotlin.progressive. Default is true.
      • Build against AGP 8.5.0.
      • Build against DAGP 1.32.0.
      • Build against Compose Multiplatform 1.6.11.
      • Update to Kaml 0.60.0.
      • Update to Guava 33.2.1-jre.
      • Update to MoshiX 0.27.1.
      "},{"location":"changelog/#0171","title":"0.17.1","text":"

      2024-05-28

      • Build against Kotlin 2.0.0.
      • Build against KSP 2.0.0-1.0.21.
      • Build against AGP 8.4.1.
      "},{"location":"changelog/#0170","title":"0.17.0","text":"

      2024-04-30

      • Build against AGP 8.4.0.
      • Update Clikt to 4.4.0.
      "},{"location":"changelog/#0164","title":"0.16.4","text":"

      2024-04-26

      • Add new flag + logic to relocate project build directories #827.
      • Update to develocity plugin\u2019s retry extension.
      • Build against redacted compiler plugin 1.8.1.
      • Update to Kaml 0.59.0.
      "},{"location":"changelog/#0163","title":"0.16.3","text":"

      2024-04-18

      • Migrate to Develocity (3.17) for build scan reporting. Technically legacy Gradle Enterprise APIs should still work, but we\u2019re not intentionally supporting them anymore.
      • Build against Anvil 2.5.0-beta07.
      • Update commons-text to 1.12.0.
      • Update oshi to 6.6.0.
      • Build against DAGP 1.31.0.
      • Build against Compose Multiplatform 1.6.2.
      • Build against AGP 8.3.2.
      • Build against KSP 1.9.23-1.0.20.
      • Build against SqlDelight 2.0.2.
      • Update to Wire 4.9.9.
      • Update to Clikt 4.3.0.
      "},{"location":"changelog/#0162","title":"0.16.2","text":"

      2024-03-28

      • Work around https://issuetracker.google.com/issues/331806519 when using KSP in android projects.
      • Build against AGP 8.3.1.
      • Build against Detekt 1.23.6.
      • Build against Gradle 8.7.
      • Update Retrofit to 2.11.0.
      • Update Kaml to 0.58.0.
      • Update Wire to 4.9.8.
      • Update Guava to 33.1.0-jre.
      "},{"location":"changelog/#0161","title":"0.16.1","text":"

      2024-03-14

      • Only apply -Xjdk-release on jvm compilations (not android).
      "},{"location":"changelog/#0160","title":"0.16.0","text":"

      2024-03-14

      • New: Add support for Anvil\u2019s new KSP support via Anvil 2.5.0-beta04.
      • Incorporate Kotlin\u2019s -Xjdk-release option alongside jvmTarget.
      • Fix configuration cache when setting kotlin compilation module name.
      • Update Okio to 3.9.0.
      • Update Oshi to 6.5.0.
      • Build against Kotlin 1.9.23.
      • Build against KSP 1.9.23-1.0.19.
      • Build against Compose Multiplatform 1.6.1.
      "},{"location":"changelog/#0159","title":"0.15.9","text":"

      2024-03-08

      • New: Add property to override lint version from version catalogs.
      • Fix: Fix application of common compose options.
      "},{"location":"changelog/#0158","title":"0.15.8","text":"

      2024-03-04

      • Fix: Check for com.android.test in Project.isAndroid checks. This resolves a case where we accidentally set the JavaCompile.options.release property in those projects.
      "},{"location":"changelog/#0157","title":"0.15.7","text":"

      2024-02-28

      • Fix inverted logic for disabled anvil mode in K2/KSP testing.
      "},{"location":"changelog/#0156","title":"0.15.6","text":"

      2024-02-28

      • Fix AnvilMode casing in detection.
      "},{"location":"changelog/#0155","title":"0.15.5","text":"

      2024-02-27

      • Broaden anvil KSP support controls.
      • Update oshi to 6.4.13.
      • Add sgp.compose.commonCompilerOptions property for common compose compiler options.
      • Build against Compose Multiplatform 1.6.0.
      • Fix mkdocs lists on the main page.
      "},{"location":"changelog/#0154","title":"0.15.4","text":"

      2024-02-19

      • Remove -Xproper-ieee754-comparisons arg, as it\u2019s enabled by default and removed entirely in K2.
      • Small fixes around skippy + add inverse options to boolean options.
      • Update Okio to 3.8.0.
      • Update Oshi to 6.4.12.
      • Update coroutines to 1.8.0.
      • Build against DAGP 1.30.0.
      • Build against AGP 8.3.0-rc01.
      "},{"location":"changelog/#0153","title":"0.15.3","text":"

      2024-02-03

      • Support Gradle 8.6.
      • Use new lazier TaskCollection.named(Spec) APIs where appropriate.
      • Update to Moshi 1.15.1.
      • Update to kotlin-cli-util 2.6.3.
      • Update to oshi 6.4.11.
      • Build against AGP 8.2.2.
      • Build against Kotlin 1.9.22.
      • Build against KSP 1.9.22-1.0.17.
      • Build against Detekt 1.23.5.
      • Build against Compose Multiplatform 1.5.12.
      • Build against DAGP 1.29.0.
      • Build against Spotless 6.25.0.
      "},{"location":"changelog/#0152","title":"0.15.2","text":"

      2024-01-11

      • New: Promote PropertyResolver to public API.
      • New: Skippy logic is now distributed as a separate, non-gradle-specific artifact under com.slack.gradle:skippy. This also includes a CLI that can be run as an alternative to the gradle task. Note this requires serialized dependency graph and androidTest projects to be pre-computed. THe config must be in a static JSON file. See the docs on ComputeAffectedProjectsCli.

      Usage: compute-affected-projects-cli [<options>]\n\n  Computes affected projects and writes output files to an output directory.\n\nOptions:\n  --debug                    Enable debug logging.\n  --merge-outputs            Merge outputs from all configs into a single\n                             /merged dir.\n  --config=<path>            Path to a config file that contains a mapping of\n                             tool names to SkippyConfig objects.\n  --parallel                 Compute affected projects in parallel.\n  --changed-files=<path>     A relative (to the repo root) path to a\n                             changed_files.txt that contains a\n                             newline-delimited list of changed files. This is\n                             usually computed from a GitHub PR's changed files.\n  -o, --outputs-dir=<path>   Output directory for skippy outputs.\n  --root-dir=<path>          Root repo directory. Used to compute relative\n                             paths.\n  --dependency-graph=<path>  Path to a serialized dependency graph file.\n  --android-test-project-paths=<path>\n                             Path to a file that contains a newline-delimited\n                             list of project paths that produce androidTest\n                             APKs.\n  -h, --help                 Show this message and exit\n
      - Enhancement: Split out separate cacheable generateDependencyGraph and generateAndroidTestProjects tasks from ComputeAffectedProjectsTask. This allows for more fine-grained caching and parallelization.

      An example flow of the last two bullets can look like so:

      # Generate the dependency graph and androidTest projects\n./gradlew generateDependencyGraph generateAndroidTestProjectPaths\n\n# Run the CLI, such as from a `*.main.kts` file that imports it.\n./skippy-runner.main.kts \\\n    --changed-files changed_files.txt \\\n    --dependency-graph slack/dependencyGraph/serializedGraph.bin \\\n    --android-test-project-paths slack/androidTestProjectPaths/paths.txt \\\n    ...\n
      "},{"location":"changelog/#0151","title":"0.15.1","text":"

      2024-01-09

      • Misc small fixes to the new artifact publishing internals released in 0.15.0.
      "},{"location":"changelog/#0150","title":"0.15.0","text":"

      2024-01-02

      • Enhancement: We\u2019ve reworked the internals of SGP significantly to make it more compatible with Gradle Project Isolation. This affects Skippy, ModScore, AndroidTest APK aggregation, DAGP missing identifiers, and property resolution (specifically command line properties and local.properties). Note that this work is ongoing as project isolation is incubating, but the changes in this release should be non-functional in nature.
      • Build against Kotlin 1.9.22.
      • Build against KSP 1.9.22-1.0.16.
      • Build against AGP 8.2.1.
      • Build against AGP 8.3.0-beta01 in AgpHandler83.
      • Build against maven-publish 0.26.0.
      • Update to Guava 33.0.0-jre.
      • Update to Oshi 6.4.10.
      • Update to kotlin-cli-util 2.6.0.
      "},{"location":"changelog/#0142","title":"0.14.2","text":"

      2023-12-18

      • Make compose() DSL function with Action parameter public.
      "},{"location":"changelog/#0141","title":"0.14.1","text":"

      2023-12-18

      • Expose compilerOption() API in Compose DSL for compiler arg configuration.
      • Update to DAGP 1.28.0 + migrate off deprecated APIs.
      • Update Okio to 3.7.0.
      • Update AgpHandler 8.3 to 8.3.0-alpha18.
      • Build against KSP 1.9.21-1.0.16.
      "},{"location":"changelog/#0140","title":"0.14.0","text":"

      2023-12-12

      • Support granular Skippy configuration. Now each tool can be configured independently with both global and per-tool configuration. These are controlled via public skippy extension now. These outputs and diagnostics are stored at build/skippy/{tool}/.... Merged outputs can be generated as well to build/skippy/merged. This allows for creating dynamic pipelines based on the outputs of each tool. The global config is always overlaid onto each tool-specific config.
      skippy {\n  debug.set(true)\n  mergeOutputs.set(true)\n  computeInParallel.set(true)\n  global {\n    applyDefaults()\n    // Glob patterns of files to include in computing\n    includePatterns.addAll(\n      \"**/*.pro\",\n      \"**/src/**/sqldelight/**\",\n    )\n    excludePatterns.addAll(\".idea/**/*.kt\")\n    // Glob patterns of files that, if changed, should result in not skipping anything in the build\n    neverSkipPatterns.addAll(\n      \".buildkite/**\",\n      \".github/actions/**\",\n      \"ci/**\",\n      \"config/health-score/**\",\n      \"tooling/scripts/**\",\n    )\n  }\n  config(\"lint\") {\n    includePatterns.addAll(\n      // project-local lint.xml files\n      // this doesn't fuuuuully work with skippy because these layer like .gitignore does\n      \"**/lint.xml\",\n      // Lint baselines\n      \"**/lint-baseline.xml\",\n    )\n    neverSkipPatterns.addAll(\n      // Global lint config\n      \"config/lint/lint.xml\",\n      // Houston feature flags, which is an input to our feature flags lints\n      \"config/feature-flags/experiments.txt\",\n    )\n  }\n  config(\"detekt\") {\n    // Detekt baselines\n    includePatterns.add(\"**/detekt-baseline.xml\")\n    // Global detekt configs\n    neverSkipPatterns.add(\"config/detekt/*\")\n  }\n}\n
      • Update Kotlin language version to 1.9.
      • Upgrade away from deprecated CC API check.
      • Update to okio 3.6.0
      • Update to oshi 6.4.9
      • Update to JNA 5.14.0
      • Update to kotlin-cli-util 2.5.4
      • Build against AGP 8.3.0-alpha17 in AgpHandler 8.3 artifact.
      • Build against DAGP 1.27.0.
      "},{"location":"changelog/#0131","title":"0.13.1","text":"

      2023-12-05

      • Make Project.isSyncing public.
      • Update to new android.studio.version property for reporting to build scans.
      • Update to Wire 4.9.3.
      • Update to RxJava 3.1.8.
      • Build against Kotlin 1.9.21.
      • Build against KSP 1.9.21-1.0.15.
      • Build against MoshiX 0.25.1.
      • Build against AGP 8.2.0.
      • Build against SqlDelight 2.0.1.
      • Build against Redacted Compiler Plugin 1.7.1.
      • Build against Detekt 1.23.4.
      • Build against Gradle Doctor 0.9.1.
      "},{"location":"changelog/#0130","title":"0.13.0","text":"

      2023-11-30

      • Update to Gradle 8.5. This version requires Gradle 8.5+.
      • Report Gradle 8.5\u2019s new BuildFeatures to build scans as custom values, starting with configuration cache and isolated projects.
      • Update Guava to 32.1.3-jre.
      • Update Oshi to 6.4.8.
      • Build against AGP 8.1.4 (main) and 8.3.0-alpha15 (agp handler 8.3).
      • Build against compose multipaltform 1.5.11.
      • Include source links in Dokka docs.
      "},{"location":"changelog/#0121","title":"0.12.1","text":"

      2023-11-21

      • Fix circuit() extension code gen using the wrong configuration.
      "},{"location":"changelog/#0120","title":"0.12.0","text":"

      2023-11-20

      • New: Add a SlackExtension.circuit() DSL. This makes it easy to set up Circuit in a project. See the DSL docs for more details. 
        slack {\n  features {\n    circuit()\n  }\n}\n
      • Don\u2019t configure KspTask subtypes of KotlinCompile tasks.
      • Remove autoValue() APIs from SlackExtension.
      • Fix deprecated forkEvery call.
      "},{"location":"changelog/#0117","title":"0.11.7","text":"

      2023-11-10

      • Make AGP version resolution lazy in AgpHandlers.
      "},{"location":"changelog/#0116","title":"0.11.6","text":"

      2023-11-09

      • Explicitly set Detekt.baseline to null if we don\u2019t specify one, as we don\u2019t want it to fall back to its default location.
      "},{"location":"changelog/#0115","title":"0.11.5","text":"

      2023-11-09

      • Support AGP 8.3.0-alpha13.
      "},{"location":"changelog/#0114","title":"0.11.4","text":"

      2023-11-08

      • Detekt baselines are now generated into their corresponding projects. This matches how we handle lint baselines, and global baselines are no longer supported.
      • You do now need to specify a slack.detekt.baseline-file-name property to indicate what the simple file name should be. This is evaluated against project.layout.projectDirectory.file(...). This replaces the previous slack.detekt.baseline property.
      • Build against Kotlin 1.9.20.
      • Build against AGP 8.1.3.
      • Build against Compose Multiplatform 1.5.10.
      "},{"location":"changelog/#0113","title":"0.11.3","text":"

      2023-11-02

      • Support Robolectric 4.11 jars for Android API 34.
      "},{"location":"changelog/#0112","title":"0.11.2","text":"

      2023-10-30

      • Make detekt and lint baselines default to null if their property values are blank.
      • No longer publish monkeypatch artifact as it\u2019s no longer necessary.
      "},{"location":"changelog/#0111","title":"0.11.1","text":"

      2023-10-22

      • Add new sgp.isTestLibrary property to indicate if a library is a test library. Note that projects that are named test-fixtures are implicitly considered test libraries.
      • Fix: Don\u2019t impose VisibleForTests lint on test libraries.
      "},{"location":"changelog/#0110","title":"0.11.0","text":"

      2023-10-22

      • Revamp some lint configuration and best-effort support KMP projects.
      • Remove slack.lint.update-baselines property in favor of AGP\u2019s modern updateBaselines task.
      • Remove hidden ImplicitSamInstance lint config.
      • Disable newer issues for dependency checks.
      "},{"location":"changelog/#01011","title":"0.10.11","text":"

      2023-10-19

      • Support AGP 8.3.0-alpha08.
      • Build against Gradle 8.4.
      • Build against compose-multiplatform 1.5.3.
      "},{"location":"changelog/#01010","title":"0.10.10","text":"

      2023-10-02

      • Make debug builds everywhere (local and CI) use consistent version codes and version names. This way remote build cache entries for them are compatible.
      • Default debug version code is governed by slack.gradle.debugVersionCode and defaults to 90009999.
      • Default version name user suffix is governed by slack.gradle.debugUserString and defaults to debug.
      • Non-debug build types are the same as before.
      • Remove a noisy lifecycle log around lint variant selection.
      • Build against Bugsnag Gradle Plugin 8.1.0.
      "},{"location":"changelog/#0109","title":"0.10.9","text":"

      2023-09-28

      • Don\u2019t disable caching on MergeAssets tasks by default. Leave that to consuming repos.
      • Update permission allowlist API to use a allowListFile file property instead.
      • Don\u2019t exclude coroutines\u2019 debug probes in debug build packaging.
      • Support AGP 8.3.0-alpha05+.
      • Build against Wire 4.9.1.
      • Build against Compose Multiplatform 1.5.2.
      • Update to Oshi 6.4.6.
      "},{"location":"changelog/#0108","title":"0.10.8","text":"

      2023-09-22

      • Fix: Don\u2019t apply boms to the coreLibraryDesugaring configuration.
      • Enhancement: Set Kotlin compilerOptions.moduleName to a dashified version of the Gradle project path.
      • Update MoshiX to 0.24.3
      • Compile against Anvil 2.4.8.
      • Compile against CM 1.5.1.
      • Compile against DAGP 1.22.0.
      • Compile against redacted-compiler-plugin 1.6.1.
      "},{"location":"changelog/#0107","title":"0.10.7","text":"

      2023-08-29

      • Fix: Don\u2019t apply BOMs to testApi configurations.
      "},{"location":"changelog/#0106","title":"0.10.6","text":"

      2023-08-29

      • New: Publish a generic Tracing API under the sgp-tracing artifact ID. We use this internally to collect extra build metadata, but it\u2019s generic enough for general use. Not currently used in slack-plugin yet.
      • Add sgp.android.buildToolsVersionOverride property to override the default build tools version in Android.
      • Migrate to AndroidPluginVersion API in AgpHandler.
      • Fix a few more deprecated Gradle API usages.
      • Build against AGP 8.1.1.
      • Build against Spotless 6.21.0.
      • Build against Compose Multiplatform 1.5.0.
      • Update to Kotlin 1.9.10.
      • Update to KSP 1.9.10-1.0.13.
      • Update to RxJava 3.1.7.
      • Update to kotlin-cli-util 2.2.1.
      • Update to Oshi 6.4.5.
      • Update to Wire 4.8.1
      • Update to DAGP 1.21.0.
      • Update to Gradle 8.3.
      "},{"location":"changelog/#0105","title":"0.10.5","text":"

      2023-08-15

      • Fix: Better support com.android.test projects in a few ways
      • No longer apply lint configurations as they don\u2019t support them.
      • No longer apply DAGP as it doesn\u2019t support them yet.
      • No longer apply unit test configurations as they don\u2019t have unit tests.
      • Build against Gradle 8.3 + fix a few deprecated Project.buildDir API usages.
      • Update kotlin-cli-util to 2.1.0.
      "},{"location":"changelog/#0104","title":"0.10.4","text":"

      2023-08-10

      • New: New DSL API for enabling Android resources.

      This streamlines configuration of enabling androidResources and enforces use of a resource prefix to avoid conflicts.

      May your avatars never be wrongly sized again.

      slack {\n  android {\n    features {\n      resources(\"prefix_\")\n    }\n  }\n}\n
      • Update kotlin-cli-util to 2.0.0.
      • Update Moshi to 1.15.0.
      • Update sort-dependencies to 0.4.
      • Update KSP to 1.9.0-1.0.13.
      • Update Okio to 3.5.0.
      • Update Jetbrains Markdown to 0.5.0.
      "},{"location":"changelog/#0103","title":"0.10.3","text":"

      2023-08-08

      • Fix an issue with Skippy where we would accidentally mark all library projects as affected androidTest projects even if they didn\u2019t have androidTest enabled.
      • Update Guava to 32.1.2-jre.
      "},{"location":"changelog/#0102","title":"0.10.2","text":"

      2023-08-08

      • Apparently the bugsnag plugin relies on the version code to be set in the variant output, so now we set a default again (configurable via slack.gradle.defaultVersionCode). The default is 90009999, for reasons.
      "},{"location":"changelog/#0101","title":"0.10.1","text":"

      2023-08-07

      • Use a single version code for all APK architectures.
      • Before, we used to compute a different version code for each architecture. This is kinda silly, and broke with AGP 8.1.0. So now we no longer do this. This means that by default, no custom version code is set unless an override is set in {rootProject}/build/ci/release.version. The default behavior will be to just use the version set in the android DSL.
      • Update to Detekt 1.23.1.
      • Update to Gradle Enterprise 3.14.1.
      • Update to Compose Multiplatform 1.4.3.
      • Update to SqlDelight 2.0.0.
      • Update to Anvil 2.4.7.
      "},{"location":"changelog/#0100","title":"0.10.0","text":"

      2023-07-25

      • Update to Kotlin 1.9.0.
      • Update to KSP 1.9.0-1.0.12.
      • Update to AGP 8.1.0.
      • Update kotlin-cli-util to 1.2.3.
      • Update MoshiX to 0.24.0.
      • Update redacted to 1.5.0.
      • Update wire to 4.8.0.
      • Add new dagger flag to ignore wildcard keys by default.
      • https://dagger.dev/dev-guide/compiler-options#ignore-provision-key-wildcards
      "},{"location":"changelog/#0918","title":"0.9.18","text":"

      2023-07-12

      • Fix: Differentiate unit and instrumentation tests in Skippy. Now changing a unit test will not cause the instrumentation tests to be marked as affected.
      • Add slack.dependencyrake.dryRun gradle property flag for dependency rake to enable dry-run. If enabled, the project build files will not be modified and a separate new-build.gradle.kts file will be written to instead.
      • Update Okio to 3.4.0.
      "},{"location":"changelog/#0917","title":"0.9.17","text":"

      2023-07-07

      • Don\u2019t register RakeDependencies task on platform projects.
      • Fix configuration cache for Dependency Rake. Note that DAGP doesn\u2019t yet support it.
      • Add Dependency Rake usage to its doc.
      • Add missing identifiers aggregation for Dependency Rake. This makes it easier to find and add missing identifiers to version catalogs that dependency rake expects.
      • ./gradlew aggregateMissingIdentifiers -Pslack.gradle.config.enableAnalysisPlugin=true --no-configuration-cache
      "},{"location":"changelog/#0916","title":"0.9.16","text":"

      2023-06-30

      • Enable lint on test sources by default.
      • Account for all version catalogs in DependencyRake.
      • Update Guava to 32.1.0-jre.
      "},{"location":"changelog/#0915","title":"0.9.15","text":"

      2023-06-29

      • Switch Robolectric jar downloads to use detached configurations.
      • This lets Gradle do the heavy lifting of caching the downloaded jars and also allows downloading them from a configured repository setup. This also simplifies the up-to-date checks.
      • Docs are now published on https://slackhq.github.io/slack-gradle-plugin. This is a work in progress.
      • API kdocs are published at https://slackhq.github.io/slack-gradle-plugin/api/0.x/.
      • Update kotlin-cli-util to 1.2.2.
      "},{"location":"changelog/#0914","title":"0.9.14","text":"

      2023-06-25

      • Fix compose compiler config not applying to android projects.
      "},{"location":"changelog/#0913","title":"0.9.13","text":"

      2023-06-24

      • Fix wrong map key name being used in exclusion.
      "},{"location":"changelog/#0912","title":"0.9.12","text":"

      2023-06-24

      • Fix wrong dependency being used for compose-compiler in new Compose configuration overhaul.
      "},{"location":"changelog/#0911","title":"0.9.11","text":"

      2023-06-24

      • Overhaul configuration of the Compose compiler across Android and multiplatform projects to make it easier to test the matrix of the AndroidX compose compiler, the JetBrains compose compiler, and new Kotlin versions.
      • New: Add a sgp.compose.multiplatform.forceAndroidXComposeCompiler Gradle property flag to force use of the AndroidX compose compiler in Compose Multiplatform projects.
      • New: Add a sgp.config.jvmVendor.optOut Gradle property flag to disable jvmVendor configuration in toolchains.
      • Fix: No longer try to watch thermals on Intel macOS machines when configuration cache is enabled.
      "},{"location":"changelog/#0910","title":"0.9.10","text":"

      2023-06-06

      • Fix: Don\u2019t apply vendor property to Bootstrap toolchain if it\u2019s undefined.
      "},{"location":"changelog/#099","title":"0.9.9","text":"

      2023-06-06

      • New: Robolectric is now optional. Its support will only be enabled if there is a robolectric key in the primary version catalog.
      • Enhancement: Update bootstrap JVM args to use ExitOnOutOfMemoryError for OOMs. No longer takes a heap dump on OOM.
      • Enhancement: Update unit test verbose mode to use CrashOnOutOfMemoryError for OOMs to produce more logs.
      • Fix: Bootstrap now respects the sgp.config.jvmVendor property.
      • Build against Wire to 4.7.0.
      • Build against Anvil 2.4.6.
      • Build against AGP 8.0.2.
      • Build against Detekt 1.23.0.
      "},{"location":"changelog/#098","title":"0.9.8","text":"

      2023-05-15

      • Fix eager check of whether or not androidTest is enabled in slack DSL.
      "},{"location":"changelog/#097","title":"0.9.7","text":"

      2023-05-15

      • Fix application targets not getting marked as androidTest()-enabled.
      "},{"location":"changelog/#096","title":"0.9.6","text":"

      2023-05-09

      • Fix wrong use of disallowChanges() on javaCompiler in JavaCompile tasks. It seems that Gradle sets this multiple times.
      • Improve git version matching.
      "},{"location":"changelog/#095","title":"0.9.5","text":"

      2023-05-09

      • Use disallowChanges() where possible on properties SGP controls in order to avoid accidental overwrites.
      • Make ComputeAffectedProjectsTask also generate a affected_android_test_projects.txt file with a newline-delimited list of affected projects that enable androidTest(). This can be used in CI scripts to statically determine if instrumentation tests need to run.
      "},{"location":"changelog/#094","title":"0.9.4","text":"

      2023-05-06

      • Fix alias naming in SlackVersions. See SlackVersions.kt for updated expected naming of aliases.
      "},{"location":"changelog/#093","title":"0.9.3","text":"

      2023-05-05

      • Add jdk.compiler/com.sun.tools.javac.model to Bootstrap Gradle JVM args and exec prefixes for binaries for GJF 17.
      "},{"location":"changelog/#092","title":"0.9.2","text":"

      2023-05-05

      • Fix accidental noisy JVM vendor log.
      "},{"location":"changelog/#091","title":"0.9.1","text":"

      2023-05-04

      Happy May the Fourth!

      • Add new sgp.config.jvmVendor property to control the JVM vendor used in Kotlin and Java toolchains. This value is used to match a known vendor spec, such as AZUL.
      • Apply the kover plugin in an afterEvaluate block to avoid https://github.com/Kotlin/kotlinx-kover/issues/362.
      • Update jgrapht to 1.5.2.
      • Update oshi to 6.4.2.
      "},{"location":"changelog/#090","title":"0.9.0","text":"

      2023-04-30

      • Improve Skippy logging.
      • Configure all Kotlin compilations, not just JVM compilations.
      • Split standard JVM args and common Kotlin args.
      • Simplify OkHttpClient setup in SlackTools.
      • Update to Kotlin 1.8.21.
      • Support Dagger KSP in slack.features.dagger DSL controls. There are two new properties to control this:
      • slack.ksp.allow-dagger \u2013 allow use of Dagger in KSP.
      • slack.ksp.allow-anvil \u2013 allow use of Anvil in KSP. Note this is not yet implemented in Anvil, just a toe-hold for the future.
      • Add debugging logs for loading SlackToolsExtension instances + fix classloader used for it.
      • Gracefully handle SlackToolsExtension extensions that fail to load.
      "},{"location":"changelog/#0810","title":"0.8.10","text":"

      2023-04-25

      • Add Context to SlackToolsExtension.
      "},{"location":"changelog/#089","title":"0.8.9","text":"

      2023-04-25

      • Expose missing SlackTools.findExtension API.
      • Expose missing SlackTools.SERVICE_NAME for @ServiceReference API.
      "},{"location":"changelog/#088","title":"0.8.8","text":"

      2023-04-25

      • Update to Kotlin 1.8.20.
      • Remove moshi-kotlin, only use generated adapters now.
      • Don\u2019t auto-apply the Kover plugin on a platform project.
      • Add new sgp.ge.apply-common-build-tags property flag to gate applying common build tags to a project.
      • Switch SlackToolsExtension to work as a ServiceLoader instead.
      "},{"location":"changelog/#087","title":"0.8.7","text":"

      2023-04-23

      • Remove lock file checking in SlackTools because this apparently invalidates configuration cache every time.
      "},{"location":"changelog/#086","title":"0.8.6","text":"

      2023-04-22

      • Revert using native Kotlin lambdas instead of class for SAM conversions due to https://github.com/gradle/gradle/issues/24871.
      "},{"location":"changelog/#085","title":"0.8.5","text":"

      2023-04-22

      • Clean up thermals logging setup in SlackTools and support enabling property at different scopes (local.properties, etc).
      • Shut down thermals heartbeat executor when SlackTools is closed.
      • Use native Kotlin lambdas instead of class for SAM conversions. The minimum supported Gradle version is now 8.1, which introduced support for this.
      "},{"location":"changelog/#084","title":"0.8.4","text":"

      2023-04-22

      • Fix JSON serialization for thermals data.
      "},{"location":"changelog/#083","title":"0.8.3","text":"

      2023-04-22

      • Don\u2019t accidentally create new SlackTools instances when reporting background data to Gradle Enterprise. These instances would be orphaned because this would happen after Gradle had closed all existing services, and create a memory leak.
      • Use a lock file to track SlackTools instances.
      • Use a single-threaded Executor for SlackTools\u2019 thermals heartbeat.
      "},{"location":"changelog/#082","title":"0.8.2","text":"

      2023-04-22

      • Log a Throwable with multiple instances of SlackTools to help track origin points.
      "},{"location":"changelog/#081","title":"0.8.1","text":"

      2023-04-22

      • Add some debug logging to SlackTools to track multiple instances.
      "},{"location":"changelog/#080","title":"0.8.0","text":"

      2023-04-15

      • Fix: Wrap all exec operations in a ValueSource for Gradle 8.x compatibility.
      • Fix: Set git line endings to PLATFORM_NATIVE in spotless by default. Its default of looking at .gitattributes is expensive and incompatible with Gradle 8.1+ configuration caching.
      • Fix: Add slack.auto-apply.sort-dependencies boolean Gradle property to gate auto-applying the sort-dependencies plugin.
      • SGP now requires AGP 8.0+ (and with it \u2013 Gradle 8+).
      "},{"location":"changelog/#079","title":"0.7.9","text":"

      2023-04-01

      Happy April Fool\u2019s Day!

      • [Skippy] Recursively resolve project dependencies to avoid missing transitive edges in the graph. Previously we only computed shallow dependencies.
      "},{"location":"changelog/#078","title":"0.7.8","text":"

      2023-03-28

      • Fix: Add missing detekt task dependencies for globalDetekt.
      • Fix: Only apply detekt config once (even if multiple Kotlin plugins are applied).
      "},{"location":"changelog/#077","title":"0.7.7","text":"

      2023-03-27

      • Add new slack.detekt.full property to gate whether or to run full detekt (i.e. with type resolution). If disabled, detektRelease/detektMain and associated tasks will be disabled and not used in detektGlobal.
      "},{"location":"changelog/#076","title":"0.7.6","text":"

      2023-03-25

      • Fix: Apply matching configurations to DetektCreateBaselineTask tasks too due to https://github.com/detekt/detekt/issues/5940.
      "},{"location":"changelog/#075","title":"0.7.5","text":"

      2023-03-24

      • [Skippy] Add more default configurations.
      • [Skippy] Add slack.avoidance.build-upon-default-affected-project-configurations flag to make provided configurations build upon defaults.
      • Add new globalDetekt task that runs detekt on all subprojects. This is Skippy-compatible and responds to slack.avoidance.affectedProjectsFile.
      "},{"location":"changelog/#074","title":"0.7.4","text":"

      2023-03-22

      • Don\u2019t expose androidExtension publicly in SlackExtension to avoid Gradle mismatching number of type arguments in AGP 8.1.0-alpha10+.
      "},{"location":"changelog/#073","title":"0.7.3","text":"

      2023-03-22

      • Set Detekt.jdkHome to null to avoid https://github.com/detekt/detekt/issues/5925.
      • Rename String.safeCapitalize() to String.capitalizeUS() to make it more explicit.
      "},{"location":"changelog/#072","title":"0.7.2","text":"

      2023-03-21

      • Disable Live Literals in Compose by default due to multiple issues. They can be enabled via -Pslack.compose.android.enableLiveLiterals=true.
      • Poor runtime performance: https://issuetracker.google.com/issues/274207650.
      • Non-deterministic class files breaking build cache: https://issuetracker.google.com/issues/274231394.
      • [Skippy] Add .github/actions/** to default never skip filters.
      "},{"location":"changelog/#071","title":"0.7.1","text":"

      2023-03-20

      • [Skippy] Improve pattern configuration.
      • Make the default patterns public. This allows consumers to more easily reuse them when customizing their own.
      • Use sets for the type to better enforce uniqueness requirements.
      • Add github actions to never-skip defaults.
      • Add excludePatterns to allow finer-grained control. This runs after include filtering so that users can manually exclude certain files that may otherwise be captured in an inclusion filter and is difficult to describe in a simple glob pattern. GitHub action does similar controls for CI matrices.
      • [Skippy] Allow relative (from the project root) to affected_projects.txt and allow non-existent files as a value. This makes it easy to gracefully fall back in CI.
      • [Skippy] Fix logging path matchers missing toString() impls.
      • [SKippy] Log verbosely in debug mode when skipping task deps.
      • Update oshi to 6.4.1.
      "},{"location":"changelog/#070","title":"0.7.0","text":"

      2023-03-17

      "},{"location":"changelog/#project-skippy","title":"Project Skippy","text":"

      This release introduces an experimental new computeAffectedProjects task for computing affected projects based on an input of changed files. The goal of this is to statically detect which unit test, lint, and androidTest checks can be safely skipped in CI on pull requests.

      Example usage 

      ./gradlew computeAffectedProjects --changed-files changed_files.txt\n

      Where changed_files.txt is resolved against the root repo directory and contains a newline-delimited list of changed files (usually inferred from a PR).

      A simple example of how to produce such a file with the gh CLI:

      gh pr view ${{ github.event.number }} --json files -q '.files[].path' > changed_files.txt\n

      One would run this task first as a preflight task, then run subsequent builds with the slack.avoidance.affectedProjectsFile Gradle property pointing to its output file location (printed at the end of the task).

      ./gradlew ... -Pslack.avoidance.affectedProjectsFile=/Users/zacsweers/dev/slack/slack-android-ng/build/skippy/affected_projects.txt\n

      The globalCiLint, globalCiUnitTest, and aggregateAndroidTestApks tasks all support reading this property and will avoid adding dependencies on tasks in projects that are not present in this set.

      The ComputeAffectedProjectsTask task has some sensible defaults, but can be configured further in the root projects like so.

      tasks.named<ComputeAffectedProjectsTask>(\"computeAffectedProjects\") {\n  // Glob patterns of files to include in computing\n  includePatterns.addAll(\n    \"**/*.kt\",\n    \"**/*.java\",\n  )\n  // Glob patterns of files that, if changed, should result in not skipping anything in the build\n  neverSkipPatterns.addAll(\n    \"**/*.versions.toml\",\n    \"gradle/wrapper/**\",\n  )\n}\n

      Debug logging can be enabled via the slack.debug=true Gradle property. This will output timings, logs, and diagnostics for the task.

      The configurations used to determine the build graph can be customized via comma-separated list to the slack.avoidance.affected-project-configurations property.

      "},{"location":"changelog/#061","title":"0.6.1","text":"

      2023-03-15

      Happy Ted Lasso season 3 premier day!

      • Fix: Remove UseContainerSupport jvm arg from unit tests as this appears to only work on Linux.
      "},{"location":"changelog/#060","title":"0.6.0","text":"

      2023-03-14

      Happy Pi day!

      • Refactor how unit tests are configured.
      • Test tasks are now configured more consistently across CI and local, so there should be more cache hits.
      • Add a new globalCiUnitTest task to the root project to ease running ciUnitTest tasks across all subprojects.
      • Add new properties to SlackProperties for controlling max parallelism and forkEvery options in Test tasks.
      • Refactor how lint tasks are configured.
      • Add a new ciLint task to every project that depends on all lint tasks in that project. This is intended to be the inverse behavior of the built-in lint task in Android projects, which only runs the default variant\u2019s lint task.
      • Add a new globalCiLint task to the root project to ease running ciLint tasks across all subprojects.
      • Add new properties to SlackProperties for controlling which variants should be linted.
      • Revert \u201cAdd lintErrorRuleIds property\u201d. lint.xml is the right place for this kind of logic.
      "},{"location":"changelog/#0510","title":"0.5.10","text":"

      2023-03-07

      • Reduce noisy JNA load failures logging. Still have not gotten to the root cause, but at least this will reduce the log noise.
      • Add a new slack.lint.severity.errorRuleIds Gradle property to specify lint rule IDs that should always be error severity.
      "},{"location":"changelog/#059","title":"0.5.9","text":"

      2023-02-27

      • Gracefully handle JNA load failures in thermals logging.
      "},{"location":"changelog/#058","title":"0.5.8","text":"

      2023-02-20

      • Enhancement: Remove kotlin-dsl from the plugin. If you were indirectly relying on its APIs from this plugin, you\u2019ll need to add that dependency separately.
      • Enhancement: Better support fully modularized lints
      • checkDependencies is no longer enabled by default.
      • Make the baseline file name configurable via slack.lint.baseline-file-name property. Defaults to lint-baseline.xml.
      • Fix: ImplicitSamInstance lint not being enabled.
      "},{"location":"changelog/#057","title":"0.5.7","text":"

      2023-02-15

      • Fix: MergeFileTask.kt was accidentally removed during a previous release.
      • Fix: Add jna-platform dependency to align with the jna dependency version.
      "},{"location":"changelog/#056","title":"0.5.6","text":"

      2023-02-15

      Do not use! Release was accidentally messed up.

      "},{"location":"changelog/#055","title":"0.5.5","text":"

      2023-02-13

      • Fix: LocTask is now compatible with Gradle 8.0 and has the correct task dependencies when Ksp, Kapt, etc are running.
      • Fix: LocTask is now compatible with remote build cache.
      • Enhancement: ModScore now supports KSP.
      • Enhancement: Binary download tasks (KtfmtDownloadTask, DetektDownloadTask, etc) now have prettier and more reliable download progress indications.
      • Enhancement: UpdateRobolectricJarsTask now uses Gradle workers to parallelize downloads. On gigabit wifi, this takes the task runtime down from ~21sec to ~13sec.
      • Enhancement: The boolean SLACK_FORCE_REDOWNLOAD_ROBOLECTRIC_JARS env variable can be used to force UpdateRobolectricJarsTask to redownload jars even if already downloaded. Behavior change: Mod score must now be opted in to via the slack.gradle.config.modscore.enabled=true gradle property.
      • Enhancement: Mod score can be disabled per-project via the slack.gradle.config.modscore.ignore=true gradle property.
      "},{"location":"changelog/#054","title":"0.5.4","text":"

      2023-02-07

      • New: Integrate gradle-dependency-sorter as another formatter. This automatically apply if the sortDependencies toml version is present, and you can have it download+create executable binaries via ./gradlew downloadDependenciesSorter.
      • Enhancement: Improve compose multiplatform support. Now the compose() DSL is moved to slack.features and offers an optional multiplatform parameter to enable the compose multiplatform plugin. 
        slack {\n  features {\n    compose(multiplatform = <true|false>)\n  }\n}\n
      • Build against Kotlin 1.8.10 and AGP 7.4.1.
      "},{"location":"changelog/#053","title":"0.5.3","text":"

      2023-01-27

      • Fix the MergeFilesTask monkeypatch using env vars instead of system props.
      "},{"location":"changelog/#052","title":"0.5.2","text":"

      2023-01-26

      • Try another fix for the MergeFilesTask monkeypatch plus extra logging. Feel free to skip this update if you\u2019re unaffected.
      "},{"location":"changelog/#051","title":"0.5.1","text":"

      2023-01-23

      • Fix: Unwrap Optional for google-coreLibraryDesugaring dependency before adding it. The Gradle API\u2019s lack of type safety strikes again.
      "},{"location":"changelog/#050","title":"0.5.0","text":"

      2023-01-23

      • New: Introduce a new sgp-monkeypatch-agp artifact. This contains monkeypatches for AGP where we try to fix bugs. This initial version contains a patched MergeFilesTask that sorts files before merging them to ensure deterministic outputs, as we believe this is causing our lint tasks to be non-cacheable across machines. This can be enabled via setting the com.slack.sgp.sort-merge-files system property to true.
      • New: Rework how bugsnag is enabled. Instead of only applying the plugin in release/main builds, we now always apply the plugin and only enable uploads on release/main builds. This allows us to catch issues with the plugin in updates sooner, as before we would not see them on PRs.
      • Uploads can be force-enabled via setting the slack.gradle.config.bugsnag.enabled gradle property to true.
      • Branches that allow uploads can be configured via regexp value on the slack.gradle.config.bugsnag.enabledBranchPattern gradle property. For example: slack.gradle.config.bugsnag.enabledBranchPattern=main|release_.*.
      • New: Source desugar libraries from libs.versions.toml instead of assuming the artifact name. Starting with 1.2.0, desugar JDK libs offers multiple artifacts. Point google-coreLibraryDesugaring in [libraries] to whichever artifact should be used.
      • Fix: Catch and print errors with thermal closes.
      • Misc: Update to JDK 19 and latest AGPs. The plugin itself still targets JVM 11 bytecode. AGP 7.4.0 is now required.
      "},{"location":"changelog/#042","title":"0.4.2","text":"

      2023-01-13

      • Enhancement: Change default gradle memory percent in bootstrap from 25% to 50%.
      • Fix: Support the gradle enterprise plugin retry implementation when using Gradle enterprise 3.12+.
      "},{"location":"changelog/#041","title":"0.4.1","text":"

      2023-01-09

      Happy new year!

      • Fix: Remove EitherNet compiler option opt-ins.
      • Update Okio to 3.3.0.
      "},{"location":"changelog/#040","title":"0.4.0","text":"

      2022-12-29

      • Update to Kotlin 1.8.0. This plugin now requires Kotlin 1.8.0 or later as it only configures KGP\u2019s new compilerOptions API now.
      "},{"location":"changelog/#038","title":"0.3.8","text":"

      2022-12-22

      • Add support for AGP 8.0.0-alpha10.
      "},{"location":"changelog/#037","title":"0.3.7","text":"

      2022-12-19

      • Fix: Don\u2019t apply freeCompilerArguments.
      • Fix: Add missing license information to published POM files.
      "},{"location":"changelog/#036","title":"0.3.6","text":"

      2022-12-15

      • Backport android.packagingOptions.jniLibs.pickFirst for AGP 8.x compatibility, as the returned type by jniLibs changed from JniLibsPackagingOptions to JniLibsPackaging.
      "},{"location":"changelog/#035","title":"0.3.5","text":"

      2022-12-06

      • Introduce compileCiUnitTest lifecycle task to just compile (but not run!) unit tests that are run by ciUnitTest.
      "},{"location":"changelog/#034","title":"0.3.4","text":"

      2022-12-04

      • Only enable isIncludeAndroidResources in Android unit tests automatically when robolectric() is used.
      "},{"location":"changelog/#033","title":"0.3.3","text":"

      2022-11-11

      • Add some more Kotlin compiler arguments to compilations. See #160
      "},{"location":"changelog/#032","title":"0.3.2","text":"

      2022-11-10

      • (Strict mode only) Check for AndroidManifest.xml files in androidTest sources + ensure they\u2019re debuggable.
      "},{"location":"changelog/#031","title":"0.3.1","text":"

      2022-10-20

      • Exclude **/build/** from Detekt tasks.
      "},{"location":"changelog/#030","title":"0.3.0","text":"

      2022-10-14

      • New: Support com.android.test projects.
      • New: Preliminary support for AGP 8.x.
      • Automatically add compose compiler dep in Compose multiplatform (i.e. org.jetbrains.compose) projects.
      • Support Error Prone Gradle Plugin 3.x.
      • Update me.tongfei:progressbar to 0.9.5.
      "},{"location":"changelog/#024","title":"0.2.4","text":"

      2022-10-06

      • Fix: Only check allowed androidTest variants if any are defined.
      "},{"location":"changelog/#023","title":"0.2.3","text":"

      2022-10-03

      • Fix: Only configure bootstrap conditionally.
      "},{"location":"changelog/#022","title":"0.2.2","text":"

      2022-10-03

      • Add necessary --add-opens to Test tasks for Robolectric 4.9+ when it\u2019s enabled.
      • Avoid subprojects module stats and allprojects in bootstrap for better project isolation support.
      "},{"location":"changelog/#021","title":"0.2.1","text":"

      2022-09-27

      • Fix: New androidTest(allowedVariants = ...) wasn\u2019t running on com.android.application projects.
      • Fix: Configure Lint DSL block for com.android.library and org.jetbrains.kotlin.jvm projects too.
      "},{"location":"changelog/#020","title":"0.2.0","text":"

      2022-09-23

      • Add option to enable only certain variants\u2019 android tests.
      slack {\n  android {\n    features {\n      androidTest(allowedVariants = setOf(\"internalDebug\"))\n    }\n  }\n}\n
      "},{"location":"changelog/#012","title":"0.1.2","text":"

      2022-09-20

      • Support Robolectric jars for Android API 30.
      "},{"location":"changelog/#011","title":"0.1.1","text":"

      2022-09-08

      • Fix wrong slack.unit-test plugin application.
      "},{"location":"changelog/#010","title":"0.1.0","text":"

      2022-09-07

      • Update to Moshi 1.14.0.
      • Disable Instantiatable lint in min SDK 28+ due to lint bug.
      • Specify kotlin version in compose compatibility check.
      "},{"location":"code-of-conduct/","title":"Code of Conduct","text":""},{"location":"code-of-conduct/#introduction","title":"Introduction","text":"

      Diversity and inclusion make our community strong. We encourage participation from the most varied and diverse backgrounds possible and want to be very clear about where we stand.

      Our goal is to maintain a safe, helpful and friendly community for everyone, regardless of experience, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, nationality, or other defining characteristic.

      This code and related procedures also apply to unacceptable behavior occurring outside the scope of community activities, in all community venues (online and in-person) as well as in all one-on-one communications, and anywhere such behavior has the potential to adversely affect the safety and well-being of community members.

      For more information on our code of conduct, please visit https://slackhq.github.io/code-of-conduct

      "},{"location":"contributing/","title":"Contributors Guide","text":"

      Note that this project is considered READ-ONLY. You are welcome to discuss or ask questions in the discussions section of the repo, but we do not normally accept external contributions without prior discussion.

      "},{"location":"contributing/#development","title":"Development","text":"

      Check out this repo with Android Studio or IntelliJ. It\u2019s a standard gradle project and conventional to check out.

      The primary project is slack-plugin.

      Kotlin should be used for more idiomatic use with Gradle/AGP APIs

      Code formatting is checked via Spotless. To run the formatter, use the spotlessApply command.

      ./gradlew spotlessApply\n

      Optionally, there are commit hooks in the repo you can enable by running the below 

      git config core.hooksPath config/git/hooks\n

      "},{"location":"platforms/gradle/architecture/","title":"Architecture","text":"

      Foundry contains three Gradle plugins and some associated helper artifacts.

      "},{"location":"platforms/gradle/architecture/#foundryrootplugin","title":"FoundryRootPlugin","text":"

      This is the root plugin that is applied to the root project of a multi-project build.

      plugins {\n  id(\"foundry.root\")\n}\n

      Its responsibilities include:

      • Registering the FoundryTools build service.
      • Setting up global configuration (i.e. global lifecycle tasks, download tasks, etc).
      • Validating the JDK matches the expected JDK defined in libs.versions.toml.
      • Configure git (hooks, ignored revisions, etc).
      • (If running on macOS) Validating the build isn\u2019t running in Rosetta mode.
      "},{"location":"platforms/gradle/architecture/#foundrybaseplugin","title":"FoundryBasePlugin","text":"

      This is the base plugin that is applied to all projects (including the root project).

      plugins {\n  id(\"foundry.base\")\n}\n

      Its responsibilities include:

      • Configuring formatters for Spotless.
      • Configuring the buildscript and dependency classpaths. This includes \u201cfixing\u201d any known bad dependencies (Hamcrest and CheckerFramework are a mess), failing on non-reproducible dependency declarations.
      • Running standard subproject configurations via StandardProjectConfigurations.
      • Configuring unit tests via UnitTests. This also includes configuring the Gradle test retry plugin, if enabled.
      • Configuring NullAway, if enabled.
      • Configuring Skippy.
      • Configuring Mod Score tasks.
      "},{"location":"platforms/gradle/architecture/#standardprojectconfigurations","title":"StandardProjectConfigurations","text":"

      This class warrants special mention as it is responsible for the bulk of the configuration applied to projects SGP manages.

      • Creates and exposes the foundry extension DSL.
      • Applies common configurations.
      • This largely just sets up the dependency sorter plugin.
      • Applies common JVM configurations.
      • Applies common Kotlin configurations.
      "},{"location":"platforms/gradle/architecture/#jvm-configurations","title":"JVM Configurations","text":"

      All JVM projects (Android, Java, Kotlin) receive some common configuration for their JVM tasks.

      "},{"location":"platforms/gradle/architecture/#common","title":"Common","text":"
      • Applies the repo\u2019s platform project, if any.
      • Applies any BOM dependencies to platform-configurable configurations.
      • Configures the dependency analysis gradle plugin and DependencyRake.
      • Applies common annotations and common test bundles from version catalogs.
      • Fails on non-androidx support library dependencies.
      • Configure common annotations processors.
      • This logic is largely in StandardProjectConfigurations.configureAnnotationProcessors() and StandardProjectConfigurations.APT_OPTION_CONFIGS, which seeks to apply common configs for known processors like Dagger and Moshi.
      "},{"location":"platforms/gradle/architecture/#java","title":"Java","text":"

      Java projects are fairly simple. Note that these are applied on all projects that apply the java plugin, which is most of them!

      • They are just configured to ensure their source/target compatibility is set to the repo\u2019s JVM target.
      • In non-android projects, JavaCompile tasks have their options.release property set to this as well.
      • Gradle toolchains are used to manage the JDK used for JavaCompile tasks in non-android projects to ensure consistency.
      • All JavaCompile tasks have -parameters added to options.compilerArgs for better static analysis and annotation processing support.
      • If opted-in, error-prone and nullaway are applied and set up with the project with common configurations (configured checks, ignoring build dirs, etc).
      • Foundry supports Error-Prone\u2019s auto-patching mode via enabling the foundry.epAutoPatch property.
      "},{"location":"platforms/gradle/architecture/#android","title":"Android","text":"
      • Configures AndroidTest APK aggregation with Skippy support.
      • Applies the Android cache fix plugin, if enabled.
      • Configures common AGP extensions (both legacy extensions and new Component extensions).
      • Disables unused/irrelevant variants. SGP is single-variant for library projects by default.
      • Disables android tests on projects unless opted in.
      • Disables unit tests on app projects by default (we use the app project as just a shell project for producing an APK).
      • Configures compileOptions, defaultConfig, compileSdk/targetSdk/minSdk/ndkVersion, etc.
        • Enables vectorDrawables.useSupportLibrary.
      • Enables core library desugaring.
      • Configures common testOptions like orchestrator, unitTests, etc.
        • unitTests.isReturnDefaultValues is always enabled for convenience.
        • unitTests.isIncludeAndroidResources is only enabled if robolectric is enabled on the project, as this is expensive to enable.
        • Set up unit test Test tasks to depend on the UpdateRobolectricJarsTask if robolectric is enabled.
      • Patches objenesis dependency versions due to weird transitive dependencies in android test classpaths.
      • Configures com.android.library and com.android.application projects. com.android.test is supported but somewhat limited.
      • Application projects\u2026
      • have their packaging config set up with some convenience common exclusions and handling common jniLibs handling.
      • have v3 and v4 signing enabled by default.
      • are configured with PermissionChecks.
      • are configured with the Bugsnag gradle plugin, if enabled.
      • Library projects\u2026
      • are configured with an automatic android.namespace, if none is manually specified in the buildscript. The namespace is inferred from the project\u2019s Gradle path.
      • are single-variant by default, set to release.
      "},{"location":"platforms/gradle/architecture/#kotlin-configurations","title":"Kotlin Configurations","text":"

      Kotlin projects are configured with KGP and Detekt in mind. SGP supports configuring Android, JVM, Multiplatform, and Compose Multiplatform projects. Multiplatform for targets other than JVM/android is limited at the moment.

      Common configurations include:

      • Setting computed kotlin daemon JVM args.
      • Setting the jvmToolchain to align with the repo\u2019s JDK target.
      • Configuring KotlinCompilation tasks with common configurations.
      • Enabling allWarningsAsErrors.
      • Adding free compiler args to freeCompilerArgs.
        • If a JVM compilation, add extra JVM args + set jvmTarget and javaParameters.
        • Dynamic, dependency-based compiler args are also set via StandardProjectConfigurations.configureFreeKotlinCompilerArgs(). This is an annoying thing to have to do, but necessary because kotlinc will complain if you add opt-ins that are not recognized by any dependencies on that classpath.
      • Enabling K2 testing.
      • Configure Detekt, if enabled, via DetektTasks.
      • Configure Lint if not an Android project via the com.android.lint plugin and LintTasks.
      • Configure the src/{variant}/kotlin source set in android projects, as these are still not automatically enabled.
      • Prevent use of the deprecated android.extensions extension.
      • Configure kapt (if requested) with common configuration
      • correctErrorTypes is set to true for better error messages.
      • mapDiagnosticLocations is set to false because it\u2019s broken.
      • Unless opted-in, disables kapt in tests due to this.
      "},{"location":"platforms/gradle/architecture/#apkversioningplugin","title":"ApkVersioningPlugin","text":"
      plugins {\n  id(\"com.slack.gradle.apk-versioning\")\n}\n

      This plugin is applied in Android application projects and is solely to configure the versionCode and versionName of APKs based on git and Gradle property inputs.

      The following properties are sourced

      versionMajor=...\nversionMinor=...\nversionPatch=...\n

      This also adds a generateVersionProperties task that is more or less only relevant for Slack\u2019s internal CI.

      "},{"location":"platforms/gradle/architecture/#agp-handlers","title":"AGP Handlers","text":"

      SGP is designed to work with multiple versions of AGP at a time, albeit only for forward compatibility and testing reasons. Generally SGP will only be tested against the latest stable version of AGP. To support multiple beta/canary versions of upcoming AGP versions, SGP has an API called AgpHandler, which is intended to be an AGP-agnostic common interface for configuring AGP projects across breaking API (source or binary) changes. When a new such change is introduced, we create an AgpHandler{version} artifact and implementation with that AGP version as its minimum. At runtime, SGP loads the relevant AgpHandler instance for the AGP version it is running against and relevant APIs use this instance via FoundryTools to interact with them in a version-agnostic way. These aren\u2019t always needed so there may be times when there are no implementations needed for the current suite of AGP versions.

      An example handler for AGP 8.0 looks like this.

      // AutoService makes it available via ServiceLoader\n// The factory should always be AGP-api agnostic.\nclass AgpHandler80 : AgpHandler {\n  @Suppress(\"DEPRECATION\")\n  override val agpVersion: String\n    get() = com.android.builder.model.Version.ANDROID_GRADLE_PLUGIN_VERSION\n\n  @AutoService(AgpHandlerFactory::class)\n  class Factory : AgpHandlerFactory {\n    override val minVersion: VersionNumber = VersionNumber.parse(\"8.0.0\")\n\n    @Suppress(\"DEPRECATION\")\n    override fun currentVersion(): String =\n      com.android.builder.model.Version.ANDROID_GRADLE_PLUGIN_VERSION\n\n    override fun create(): AgpHandler {\n      return AgpHandler80()\n    }\n  }\n}\n
      "},{"location":"platforms/gradle/bootstrap/","title":"Bootstrap","text":"

      Bootstrap is a tool for bootstrapping local dev environments. This is usually used in tandem with a bootstrap bash script that runs the ./gradlew bootstrap task and any other repo-specific setups.

      The core implementation lives in BootstrapTask.kt.

      At a high level, bootstrap is mostly focused on configuring the JDK and daemon environments. Gradle has extremely limited configurability for the Gradle daemon, and we want to optimize the JDK for available space on different developer machines. To support this, we compute optimal daemon jvm arguments in bootstrap and write them to the user\u2019s home ~/.gradle/gradle.properties to override repo-specific settings with client-side properties.

      For the JDK, it requests the JDK toolchain from Gradle\u2019s first-party APIs. This includes allowing Gradle to download the JDK if it\u2019s missing, which is useful for getting developers set up and running faster.

      Bootstrap is also useful on CI for its ability to scale available memory to the machine it\u2019s running on, so we generally run it as a preflight step for all of our CI jobs too.

      Finally, there are some other specific things it does to optimize things:

      • Disable Gradle file watching on CI as it\u2019s not necessary there.
      • Configure specific GC and heap args for optimized use in Gradle builds (favoring larger young generation spaces).
      • Configure a fixed-size heap for CI to avoid time spent growing the heap.
      "},{"location":"platforms/gradle/configuration/","title":"Configuration","text":"

      TODO

      "},{"location":"platforms/gradle/dependency-rake/","title":"Dependency Rake","text":"

      Dependency rake is an tool we develop within foundry (SGP) to automatically clean up Gradle build files.

      This tool uses the outputs of the dependency-analysis-gradle-plugin ( DAGP) to infer and apply fixes it recommends.

      "},{"location":"platforms/gradle/dependency-rake/#types-of-fixes","title":"Types of Fixes","text":"

      There are three main categories of fixes that DR applies.

      1. Remove unused dependencies.
        • Like it says on the tin, these are declared dependencies that are unused and should be removed.
      2. Fix misused dependencies.
        • These are dependencies that are declared but only transitive dependencies they include are actually used. For example - depending on RxAndroid but only using RxJava from it. These are fixed by replacing the dependency with the specific transitive dependency.
      3. Fix wrong configurations.
        • These are dependencies that declare the wrong Gradle configuration (e.g. api, implementation, etc). Dependencies determined to be used in the \u201cpublic ABI\u201d of the library should be \u201capi\u201d configuration for use in dependent projects. Anything else can be hidden as an \u201cimplementation\u201d or \u201ccompileOnly\u201d (if annotations-only) dependency.
      "},{"location":"platforms/gradle/dependency-rake/#benefits","title":"Benefits","text":"

      The primary benefit of dependency rake is to improve build times by more or less \u201craking\u201d the build dependency graph. By removing and fixing dependencies, we remove unneeded edges in the build graph. This in turn provides improved build parallelism and better avoidance in Skippy CI pipelines.

      A secondary benefit is automatic upkeep of build files. As projects change over time, dependencies become obsolete and out of date. Most developers do not keep up with these changes over time, so automating this affords us extra upkeep that we currently do not do.

      "},{"location":"platforms/gradle/dependency-rake/#implementation","title":"Implementation","text":"

      The core implementation of DR lives in DependencyRake.kt.

      "},{"location":"platforms/gradle/dependency-rake/#usage","title":"Usage","text":"

      To run dependency rake in a project, use the below command

      $ ./gradlew rakeDependencies -Pfoundry.config.enableAnalysisPlugin=true --no-configuration-cache\n

      This will run all rakeDependencies tasks in the project. This task exists on all subprojects as well, but it works best if all are run together.

      Sometimes dependency rake will try to replace identifiers with ones that are not present in any available version catalogs. Sometimes this is acceptable, but often times it can result in \u201cmissing\u201d dependencies from the build after it runs. To help fix these, DR will write all missing identifiers out to a build output file.

      For convenience, you can also run ./gradlew aggregateMissingIdentifiers -Pslack.gradle.config.enableAnalysisPlugin=true --no-configuration-cache to run all dependency rake tasks and aggregate these missing identifiers into a root project build output file.

      "},{"location":"platforms/gradle/dsl/","title":"DSL","text":"

      SGP offers a DSL extension for configuring project behavior via the plugin. The idea is that developers don\u2019t really want to think about specific dependency wirings, and instead want to express what features they want and allow SGP to automatically wire these up for them.

      Some examples of this include Dagger, Moshi code gen, Robolectric, and more.

      The primary entry point is the slack extension in the build file, which is backed by the SlackExtension interface.

      foundry {\n    features {\n        dagger(...)\n        moshi(...)\n    }\n    android {\n        features {\n            robolectric(...)\n        }\n    }\n}\n
      "},{"location":"platforms/gradle/dsl/#features","title":"Features","text":""},{"location":"platforms/gradle/dsl/#circuit","title":"Circuit","text":"

      The Circuit feature automatically sets up Circuit in the project. This includes controls for different Circuit artifacts and code gen. The default circuit() call will just enable Circuit\u2019s runtime + code gen.

      "},{"location":"platforms/gradle/dsl/#dagger","title":"Dagger","text":"

      The Dagger feature automatically sets up both Dagger and Anvil. This includes optional parameters to control whether or not you want the runtime only, component merging, or other features. This automatically handles applying the Anvil, kapt, or KSP plugins under the hood and any necessary dependencies to run them.

      The default dagger() call will just enable Dagger\u2019s runtime + Anvil\u2019s factory generation with no component merging ( to avoid the Kapt cost).

      "},{"location":"platforms/gradle/dsl/#moshi","title":"Moshi","text":"

      The Moshi feature handles setting up both Moshi and MoshiX. This includes handling applying code gen logic (either KSP or IR) as well as moshi-sealed support if requested.

      "},{"location":"platforms/gradle/dsl/#redacted","title":"Redacted","text":"

      This enables the redacted-compiler-plugin compiler plugin.

      "},{"location":"platforms/gradle/dsl/#compose","title":"Compose","text":"

      The Compose feature handles setting up Compose in both Android and multiplatform projects. This handles a bunch of boilerplate (see ComposeUtil.kt) for applying the right compose-compiler artifact version as well as enabling the right controls in the Android plugin.

      "},{"location":"platforms/gradle/dsl/#test-fixtures","title":"Test Fixtures","text":"

      This enables Gradle test fixtures in a project-agnostic fashion. In JVM projects this will apply the java-test-fixtures plugin, in Android projects this will configure the android.testFixtures.enable property.

      "},{"location":"platforms/gradle/dsl/#android-features","title":"Android Features","text":""},{"location":"platforms/gradle/dsl/#robolectric","title":"Robolectric","text":"

      The Robolectric feature handles setting up Robolectric in an Android project. This entails common Robolectric dependencies (including any bundles or core Robolectric project dependencies). This also sets up Robolectric jar downloads (via UpdateRobolectricJarsTask) for test tasks and enabling resource merging in tests (which Robolectric requires). There are a few other controls that StandardProjectConfigurations use to control or patch Robolectric\u2019s behavior.

      "},{"location":"platforms/gradle/dsl/#android-test","title":"Android Test","text":"

      By default, SGP disables androidTests in projects. These can be enabled via the androidTest() feature, which will enable the relevant controls in the Android plugin. This can also accept specified variants to enable/disable.

      This is important for opting in tests to AndroidTest APK Aggregation.

      "},{"location":"platforms/gradle/dsl/#resources","title":"Resources","text":"

      By default, we disable Android resources (different from Java resources) and libraries have to opt-in to using them.

      This can be enabled via the resources() feature, which will enable the relevant BuildFeature in the Android plugin and also takes a required prefix parameter that is used as the required resourcePrefix for that library\u2019s resources to avoid naming conflicts.

      "},{"location":"platforms/gradle/dsl/#android-application-features","title":"Android Application Features","text":""},{"location":"platforms/gradle/dsl/#permission-allowlist","title":"Permission AllowList","text":"

      This enables checking of a permission allowlist. See PermissionChecks for more details.

      "},{"location":"platforms/gradle/formatters-and-analysis/","title":"Formatters and Static Analysis","text":"

      SGP supports running a number of formatters and static analysis tools.

      Individual tools are usually gated on whether they have a version specified in libs.versions.toml. If they do not have a version specified, they are deemed not enabled.

      "},{"location":"platforms/gradle/formatters-and-analysis/#formatting","title":"Formatting","text":"

      The core set of formatters are:

      • ktfmt (Kotlin)
      • google-java-format (Java)
      • gson (JSON)
      • gradle-dependency-sorter (Gradle build file dependencies)
      • Spotless (general purpose Gradle plugin that runs most of the above)
      "},{"location":"platforms/gradle/formatters-and-analysis/#static-analysis","title":"Static Analysis","text":"

      The core set of analysis tools supported in SGP are:

      • Android Lint (Kotlin, Java, XML resources, build files, etc.)
      • Detekt (Kotlin)
      • Error Prone (Java)
      "},{"location":"platforms/gradle/formatters-and-analysis/#git-hooks","title":"Git Hooks","text":"

      SGP ships with a standard set of git hooks (pre-commit, etc) that it can bootstrap in projects by running ./gradlew installCommitHooks. These hooks rely on checking in relevant binaries for each formatter/checker, it\u2019s strongly recommended to use git-lfs for these. These files should be edited as needed to best serve the project they\u2019re running in.

      SGP can configure these hooks in the project automatically during bootstrap if you add the foundry.git.hooksPath gradle property and point it at the hooks directory that the above command output to, or wherever the host project opts to store them.

      Note that Detekt is not yet supported in git hooks as these require extra parameters for baselines.

      "},{"location":"platforms/gradle/formatters-and-analysis/#downloading-binaries","title":"Downloading binaries","text":"

      Each tool (ktfmt, gjf, etc) has corresponding ./gradlew update<tool name> tasks that you can run to download and install them, by default to config/bin/<tool name>. You should re-run these any time you update a tool to re-run them.

      "},{"location":"platforms/gradle/lint/","title":"Lint","text":"

      TODO

      "},{"location":"platforms/gradle/mod-score/","title":"Mod Score","text":"

      TODO

      "},{"location":"platforms/gradle/properties/","title":"Properties","text":"

      TODO

      "},{"location":"platforms/gradle/testing/","title":"Testing","text":"

      TODO

      "},{"location":"platforms/gradle/thermals-logging/","title":"Thermals Logging","text":"

      TODO

      "},{"location":"platforms/gradle/utilities/","title":"Utilities","text":"

      There are a bunch of miscellaneous utilities and tools in this project that don\u2019t necessarily warrant their own dedicated docs page.

      "},{"location":"platforms/gradle/utilities/#androidsourcesconfigurer","title":"AndroidSourcesConfigurer","text":"

      When testing new Android SDK betas, the compile SDK version is available months before sources are. Developers want to build against these APIs, but we don\u2019t want to make their experience in the IDE worse than necessary. The problem with using a compile SDK version that doesn\u2019t have sources is that the IDE can\u2019t provide any documentation for the APIs and will just show stub files instead.

      To work mitigate this, we will patch the SDK by putting a copy of the previous version\u2019s sources in the location of the new SDK. This allows most sources to still index properly during the beta period. Then, once the new sources are available, the consuming repo needs only to update the foundry.latestCompileSdkWithSources gradle property to that new SDK version and the patcher will clear out that copy and let AGP download the real ones.

      This runs automatically in the root plugin.

      "},{"location":"platforms/gradle/utilities/#androidtest-apk-aggregation","title":"AndroidTest APK Aggregation","text":"

      At Slack we use FTL + Fladle for running our instrumentation tests. In order to add more test APKs from modularized instrumentation tests in other subprojects, we have to aggregate a list of their locations and pass them on to Fladle. This is done via AndroidTestApksTask, which is registered in the root project and can be wired to pipe its output file into Fladle\u2019s config input.

      Example

      val aggregatedApksProvider = rootProject.tasks\n  .named<AndroidTestApksTask>(\"aggregateAndroidTestApks\")\n  .flatMap { it.outputFile }\n  .map { it.asFile.readLines() }\n\ntasks\n  .withType<YamlConfigWriterTask>()\n  .named { it == \"writeConfigProps${fladleTarget}\" }\n  .configureEach { additionalTestApks.value(testInputsProvider) }\n

      This task is automatically added to whenever a subproject uses the androidTest() DSL feature.

      "},{"location":"platforms/gradle/utilities/#permissionchecks","title":"PermissionChecks","text":"

      Permissions are an integral part of Android apps, and oversight into what permissions are required in the app is critical to a release pipeline. PermissionChecks is a feature to help with this.

      The workflow we use at Slack is like this:

      • We check in a permissionsAllowlist.txt file in the Slack android repo.
      • This file is owned in GitHub by a specific codeowner rule that adds a permission reviewers group.
      • This file is passed into the allowListFile DSL feature in the application project.
      • On each build, SGP automatically checks that the permissions present in the release APK manifest match the ones defined in the allowlist.

      This way new permissions are not accidentally or secretly added to the app.

      "},{"location":"tools/cli/","title":"Foundry CLIs","text":"

      An artifact containing basic CLI utilities for Kotlin.

      "},{"location":"tools/cli/#installation","title":"Installation","text":"

      // In Gradle\ndependencies {\n  implementation(\"com.slack.foundry:cli:<version>\")\n}\n\n// In kotlin script\n@file:DependsOn(\"com.slack.foundry:cli:{version}\")\n

      "},{"location":"tools/cli/#local-testing","title":"Local testing","text":"

      If consuming these utilities from a kotlin script file, you can test changes like so:

      1. Set the version in gradle.properties, such as 2.5.0-LOCAL1.
      2. Run ./gradlew publishToMavenLocal to publish the current version to your local maven repository.
      3. In your script file, add the local repository and update the version: 
        @file:Repository(\"file:///Users/{username}/.m2/repository\")\n@file:DependsOn(\"com.slack.foundry:cli:{version you set in gradle.properties}\")\n
      4. Repeat as needed while testing, incrementing the version number each time to avoid caching issues.
      "},{"location":"tools/skippy/","title":"Skippy","text":"

      TODO

      "}]} \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index 8109a5d0cfdf3baae431ad5d1c208b5dd2f2be24..bd75785e9f55eebcb834795801164a4fb2c317ee 100644 GIT binary patch delta 13 Ucmb=gXP58h;9$6FJ(0Zv02-hJ-~a#s delta 13 Ucmb=gXP58h;9%%Co5)@P02wX=l>h($