Add includePreviewParamPreviews extension for allowing users to opt-out of preview param support

gradle-plugin/plugin/src/main/kotlin/com/emergetools/android/gradle/EmergePlugin.kt

@@ -276,6 +276,10 @@ class EmergePlugin : Plugin<Project> {
         "includePrivatePreviews: ${extension.snapshotOptions.includePrivatePreviews.orEmpty()}",
         snapshotsHeading
       )
+      addItem(
+        "includePreviewParamPreviews: ${extension.snapshotOptions.includePreviewParamPreviews.orEmpty()}",
+        snapshotsHeading
+      )
       addItem("tag (optional): ${extension.snapshotOptions.tag.orEmpty()}", snapshotsHeading)
       addItem("enabled: ${extension.snapshotOptions.enabled.getOrElse(true)}", snapshotsHeading)
 

gradle-plugin/plugin/src/main/kotlin/com/emergetools/android/gradle/EmergePluginExtension.kt

@@ -195,6 +195,12 @@ abstract class SnapshotOptions : ProductOptions() {
    * Include private previews in snapshot generation, defaults to true
    */
   abstract val includePrivatePreviews: Property<Boolean>
+
+  /**
+   * Include previews with PreviewParameter annotated Previews in snapshot generation,
+   * defaults to true
+   */
+  abstract val includePreviewParamPreviews: Property<Boolean>
 }
 
 abstract class ReaperOptions : ProductOptions() {

gradle-plugin/plugin/src/main/kotlin/com/emergetools/android/gradle/tasks/snapshots/LocalSnapshots.kt

@@ -64,6 +64,10 @@ abstract class LocalSnapshots : DefaultTask() {
   @get:Optional
   abstract val includePrivatePreviews: Property<Boolean>
 
+  @get:Input
+  @get:Optional
+  abstract val includePreviewParamPreviews: Property<Boolean>
+
   @TaskAction
   fun execute() {
     val artifactMetadataFiles = packageDir.asFileTree.matching {
@@ -105,6 +109,7 @@ abstract class LocalSnapshots : DefaultTask() {
     val composeSnapshots = PreviewUtils.findPreviews(
       extractedApkDir,
       includePrivatePreviews.getOrElse(true),
+      includePreviewParamPreviews.getOrElse(true),
       previews,
       logger
     )

gradle-plugin/plugin/src/main/kotlin/com/emergetools/android/gradle/tasks/snapshots/Register.kt

@@ -126,6 +126,7 @@ private fun registerSnapshotLocalTask(
     it.testAppId.set(testAppId)
     it.testInstrumentationRunner.set(testInstrumentationRunner)
     it.includePrivatePreviews.set(extension.snapshotOptions.includePrivatePreviews)
+    it.includePreviewParamPreviews.set(extension.snapshotOptions.includePreviewParamPreviews)
     it.dependsOn(packageTask)
   }
 }
@@ -153,6 +154,7 @@ private fun registerSnapshotUploadTask(
       packageTask.flatMap { packageTask -> packageTask.artifactMetadataPath })
     it.apiVersion.set(extension.snapshotOptions.apiVersion)
     it.includePrivatePreviews.set(extension.snapshotOptions.includePrivatePreviews)
+    it.includePreviewParamPreviews.set(extension.snapshotOptions.includePreviewParamPreviews)
     it.setUploadTaskInputs(extension, appProject, variant)
     it.setTagFromProductOptions(extension.snapshotOptions, variant)
     it.dependsOn(packageTask)

gradle-plugin/plugin/src/main/kotlin/com/emergetools/android/gradle/tasks/snapshots/UploadSnapshotBundle.kt

@@ -33,6 +33,10 @@ abstract class UploadSnapshotBundle : BaseUploadTask() {
   @get:Optional
   abstract val includePrivatePreviews: Property<Boolean>
 
+  @get:Input
+  @get:Optional
+  abstract val includePreviewParamPreviews: Property<Boolean>
+
   @get:InputFile
   abstract val artifactMetadataPath: RegularFileProperty
 
@@ -70,6 +74,7 @@ abstract class UploadSnapshotBundle : BaseUploadTask() {
       androidSnapshotsEnabled = true,
       androidSnapshotsApiVersion = apiVersion.orNull,
       androidSnapshotsPrivateEnabled = includePrivatePreviews.getOrElse(true),
+      androidSnapshotsPreviewParamsEnabled = includePreviewParamPreviews.getOrElse(true),
     )
   }
 

gradle-plugin/plugin/src/main/kotlin/com/emergetools/android/gradle/tasks/snapshots/utils/PreviewUtils.kt

@@ -33,6 +33,7 @@ object PreviewUtils {
   fun findPreviews(
     extractedApkDirectory: File,
     includePrivatePreviews: Boolean,
+    includePreviewParamPreviews: Boolean,
     previewFunctions: List<String>,
     logger: Logger,
   ): ComposeSnapshots {
@@ -76,7 +77,7 @@ object PreviewUtils {
           return@forEach
         }
 
-        if (!hasSupportedMethodParameters(method, logger)) {
+        if (!hasSupportedMethodParameters(method, includePreviewParamPreviews, logger)) {
           logger.info("Ignoring snapshot for method: $methodKey as params are not supported.")
           return@forEach
         }
@@ -102,7 +103,11 @@ object PreviewUtils {
     return signature.replace('/', '.').substring(1, signature.length - 1)
   }
 
-  private fun hasSupportedMethodParameters(method: DexBackedMethod, logger: Logger): Boolean {
+  private fun hasSupportedMethodParameters(
+    method: DexBackedMethod,
+    includePreviewParamPreviews: Boolean,
+    logger: Logger,
+  ): Boolean {
     // Only supporting 0-1 preview params
     val methodParamCount = method.parameters.size
     if (methodParamCount < 2 || methodParamCount > 3) {
@@ -118,6 +123,7 @@ object PreviewUtils {
     }
 
     if (methodParamCount == 3) {
+
       // Check first param annotated with @PreviewParameter
       val firstParam = method.parameters[0]
       val hasPreviewParameterAnnotation = firstParam.annotations.any { annotation ->
@@ -129,7 +135,12 @@ object PreviewUtils {
         return false
       }
 
-      logger.info("Method ${method.name} has 3 parameters, and the first one is annotated with @PreviewParameter!")
+      if (!includePreviewParamPreviews) {
+        logger.info("Method ${method.name} has 3 parameters and the first one is annotated with @PreviewParameter but includePreviewParamPreviews is set to false")
+        return false
+      }
+
+      logger.info("Method ${method.name} has 3 parameters and the first one is annotated with @PreviewParameter!")
     }
 
     logger.info("Method ${method.name} has supported parameters!")

gradle-plugin/plugin/src/main/kotlin/com/emergetools/android/gradle/util/network/EmergeUploadRequest.kt

@@ -32,6 +32,7 @@ data class EmergeUploadRequestData(
   val androidSnapshotsEnabled: Boolean,
   val androidSnapshotsApiVersion: Int? = null,
   val androidSnapshotsPrivateEnabled: Boolean = true,
+  val androidSnapshotsPreviewParamsEnabled: Boolean = true,
 )
 
 @Serializable