gradle-plugin/dev.zacsweers.metro.gradle/MetroPluginExtension/reportsDestination

reportsDestination

@DelicateMetroGradleApi(message = "This should only be used for debugging purposes and is not intended to be always enabled.")

val reportsDestination: DirectoryProperty(source)

If set, the Metro compiler will dump verbose report diagnostics about resolved dependency graphs to the given destination. Outputs are per-compilation granularity (i.e. build/metro/main/...).

This behaves similar to the compose-compiler's option of the same name.

This also enables report tasks for each compilation. For example, generateInternalDebugMetroGraphMetadata combines graph JSON for Android's internalDebug compilation. Task names include the capitalized target and compilation names. A blank target name is omitted. Reports are written under build/reports/metro/{target}/{compilation}/.

This enables a nontrivial amount of logging and overhead and should only be used for debugging.

Optionally, you can specify a metro.reportsDestination Gradle property whose value is a relative path from the project's build directory.