plugins {
  id("com.emergetools.android") version "<latest-version>"
}

› ./gradlew :app:emergeSizeAnalysisPreflightRelease

> Task :app:emergeSizeAnalysisPreflightRelease

╔════════════════════════════════════════════════════╗
║ Size analysis preflight check was successful (2/2) ║
╠════════════════════════════════════════════════════╝
╠═ ✅ Emerge API token set
╚═ ✅ Size analysis enabled


╔═════════════════════════════════════╗
║ VCS Info check was successful (4/4) ║
╠═════════════════════════════════════╝
╠═ ✅ SHA: 123456789..
╠═ ✅ Base SHA: 987654321..
╠═ ✅ Branch name: main
╚═ ✅ PR number: 123

Size analysis preflight was successful!
Upload & run size analysis on Emerge with ./gradlew :app:emergeUploadReleaseAab

// app-module build.gradle.kts
plugins {
  id("com.emergetools.android")
}

emerge {
  // If not explicitly set, Emerge uses the EMERGE_API_TOKEN env variable
  apiToken.set(System.getenv("EMERGE_API_TOKEN"))

  // Defaults to true, if true, dependency info (module & third party) is included in upload to Emerge
  includeDependencyInformation.set(true)

  // Optional, defaults to false, use to execute tasks without uploading to Emerge
  dryRun.set(false)

  verbose.set(false)

  vcs {
    // Optional, will attempt to set automatically using Git information.
    sha.set("..")
    // Optional, will attempt to set automatically using Git information.
    baseSha.set("..")
    // Optional, will attempt to set automatically using Git information.
    previousSha.set(".."
    // Optional, will attempt to set automatically using Git information.
    branchName.set("my-feature")

    prNumber.set("123")

    gitHub {
      // Required for CI status checks (only if using GitHub) - Emerge will attempt to set with GitHub event info
      repoOwner.set("..")
      // Required for CI status checks (only if using GitHub) - Emerge will attempt to set with GitHub event info
      repoName.set("..")
      // Optional, defaults to true, include GitHub event data in upload for debugging
      includeEventInformation.set(true)
    }

    gitLab {
      // Required for CI status checks (only if using GitLab)
      projectId.set("..")
    }
  }

  size {
    // Optional, defaults to 'release'
    tag.set("release")
    // Alternatively, use `setFromVariant()` to set the tag from the Android build variant name
    tag.setFromVariant()

    // If size tasks/project configuration are enabled.
    enabled.set(true)
  }

  snapshots {
    // Storage of locally generated snapshots
    snapshotsStorageDirectory.set("/src/main/snapshots")
    // Android API version to run snapshots on, must be 29, 31, 33 or 34.
    apiVersion.set(33)
    // Include private previews in snapshot generation - defaults to true
    includePrivatePreviews.set(false)

    // Optional, snapshots use debug builds, we recommend using a separate tag.
    tag.set("snapshots")
    // Alternatively, use `setFromVariant()` to set the tag from the Android build variant name
    tag.setFromVariant()

    // If snapshot tasks/project configuration are enabled.
    enabled.set(true)
  }

  reaper {
    // The build variants Reaper is enabled for.
    // When Reaper is enabled the application bytecode will be instrumented to support Reaper.
    enabledVariants.set(listOf("release", "releaseVariant2"))
    // The key used to identify Reaper reports for your organization. Emerge recommends setting this as an environment variable
    // Note: This key is not the same as the API key used for uploading to Emerge - you can find this
    publishableApiKey.set(System.getenv("REAPER_API_TOKEN"))

    // Optional, defaults to 'release'
    tag.set("release")
    // Alternatively, use `setFromVariant()` to set the tag from the Android build variant name
    tag.setFromVariant()

  }

  performance {
    // Required for performance testing
    projectPath.set(":perf")

    // Optional, defaults to 'release'
    tag.set("release")
    // Alternatively, use `setFromVariant()` to set the tag from the Android build variant
    tag.setFromVariant()

    // If performance tasks/project configuration are enabled.
    enabled.set(true)
  }
}

emerge {
  vcs {
    sha.set("...") // Optional, will be set automatically using Git information.
    baseSha.set("...") // Optional, will be set automatically using Git information.
    branchName.set("my-feature") // Optional, will be set automatically using Git information.
    prNumber.set("123") // Required for PR status checks & comments, not set automatically.
  }
}

emerge {
  vcs {
    ..

    gitHub {
      includeEventInformation.set(true) // Default true, whether to include GitHub event data for debugging.
    }
  }
}

emerge {
  vcs {
    ..

    gitLab {
      projectId.set("...") // Required for CI status checks (only if using GitLab)
    }
  }
}

emerge {
  ...

  size {
    tag.set("release") // Optional, tag to use for grouping builds in the Emerge dashboard
    // Alternatively, use `setFromVariant()` to set the tag from the Android build variant
    tag.setFromVariant()

    // If size tasks/project configuration are enabled.
    enabled.set(true)
  }
}

emerge {
  ...

  snapshots {
    // Path to local snapshot image storage, defaults to `/build/emerge/snapshots/outputs`
    snapshotsStorageDirectory.set("/src/main/snapshots")

    // Android API version to run snapshots on, must be 29, 31, 33 or 34.
    apiVersion.set(33)

    // Include private previews in snapshot generation - defaults to true
    includePrivatePreviews.set(false)

    // Tag to use for grouping builds in the Emerge dashboard
    tag.set("snapshots")
    // Alternatively, use `setFromVariant()` to set the tag from the Android build variant
    tag.setFromVariant()

    // If performance tasks/project configuration are enabled.
    enabled.set(true)
  }
}

emerge {
  ...

  reaper {
    // The build variants Reaper is enabled for.
    // When Reaper is enabled the application bytecode will be instrumented to support Reaper.
    enabledVariants.set(listOf("release", "releaseVariant2"))
    // The key used to identify Reaper reports for your organization. Emerge recommends setting this as an environment variable
    // Note: This key is not the same as the API key used for uploading to Emerge - you can find this
    publishableApiKey.set(System.getenv("REAPER_API_TOKEN"))

    // Optional, defaults to 'release'
    tag.set("release")
    // Alternatively, use `setFromVariant()` to set the tag from the Android build variant name
    tag.setFromVariant()
  }
}

emerge {
  ...

  performance {
    projectPath.set(":perf") // Required, Module path to the Emerge performance module
    tag.set("release") // Optional, tag to use for grouping builds in the Emerge dashboard
    // Alternatively, use `setFromVariant()` to set the tag from the Android build variant
    tag.setFromVariant()
  }
}