feat(java): Add Gradle sections describing dependencies metadata report (#5712)

Co-authored-by: lizokm <[email protected]>
Co-authored-by: Isabel <[email protected]>

Author: 3 people

src/platforms/android/common/gradle.mdx

@@ -5,8 +5,13 @@ description: "Learn about using the Sentry Android Gradle Plugin."
 ---
 
 The [Sentry Android Gradle Plugin](https://github.com/getsentry/sentry-android-gradle-plugin) is an addition to the main Android and Hybrid SDKs (like React Native and Flutter) and offers
-seamless integration with the Gradle build system. It supports the upload of ProGuard/R8 mappings and of Native debug symbols and sources, as well as
-auto-instrumentation tracing through bytecode manipulation.
+seamless integration with the Gradle build system. It supports the following features:
+
+- ProGuard/R8 mappings upload
+- Native debug symbols and sources upload
+- Auto-instrumentation tracing through bytecode manipulation
+- Auto-installation of the Sentry Android SDK and its integrations
+- External dependencies report
 
 ## Setup
 
@@ -109,6 +114,14 @@ sentry {
       // Defaults to the latest published sentry version.
       sentryVersion = '{{ packages.version('sentry.java.android', '5.0.0') }}'
     }
+    
+    // Disables or enables dependencies metadata reporting for Sentry.
+    // If enabled, the plugin will collect external dependencies and
+    // upload them to Sentry as part of events. If disabled, all the logic
+    // related to the dependencies metadata report will be excluded.
+    //
+    // Default is enabled.
+    includeDependenciesReport = true
 }
 ```
 
@@ -174,6 +187,15 @@ sentry {
       // Defaults to the latest published sentry version.
       sentryVersion.set("{{ packages.version('sentry.java.android', '5.0.0') }}")
     }
+    
+    // Disables or enables dependencies metadata reporting for Sentry.
+    // If enabled, the plugin will collect external dependencies and 
+    // upload them to Sentry as part of events. If disabled, all the logic
+    // related to the dependencies metadata report will be excluded.
+    //
+    // Default is enabled.
+    //
+    includeDependenciesReport.set(true)
 }
 ```
 

src/platforms/java/common/dependencies-report.png

@@ -0,0 +1,78 @@
+---
+title: Gradle
+sidebar_order: 100
+description: "Learn about using the Sentry Gradle Plugin."
+---
+
+The [Sentry Gradle Plugin](https://github.com/getsentry/sentry-android-gradle-plugin) is an addition to the main Java SDK and offers
+seamless integration with the Gradle build system. It supports the reporting of your application's external dependencies as part of events.
+
+## Setup
+
+### Install
+
+Using Gradle in your application module's `build.gradle` add:
+
+```groovy
+buildscript {
+    repositories {
+        mavenCentral()
+    }
+}
+
+plugins {
+    id "io.sentry.android.gradle" version "{{ packages.version('sentry.java.android.gradle-plugin', '3.0.0') }}"
+}
+```
+
+```kotlin
+buildscript {
+    repositories {
+        mavenCentral()
+    }
+}
+
+plugins {
+    id("io.sentry.android.gradle") version "{{ packages.version('sentry.java.android.gradle-plugin', '3.0.0') }}"
+}
+```
+
+<Note>
+
+Although the plugin id contains `android`, it can be used for non-android projects. However, for non-android projects, the plugin only collects external dependencies.
+
+</Note>
+
+### Configure
+
+We expose the following configuration values directly in `build.gradle`:
+
+```groovy
+sentry {
+    // Disables or enables dependencies metadata reporting for Sentry.
+    // If enabled, the plugin will collect external dependencies and
+    // upload them to Sentry as part of events. If disabled, all the logic
+    // related to the dependencies metadata report will be excluded.
+    //
+    // Default is enabled.
+    includeDependenciesReport = true
+}
+```
+
+```kotlin
+sentry {
+    // Disables or enables dependencies metadata reporting for Sentry.
+    // If enabled, the plugin will collect external dependencies and 
+    // upload them to Sentry as part of events. If disabled, all the logic
+    // related to the dependencies metadata report will be excluded.
+    //
+    // Default is enabled.
+    includeDependenciesReport.set(true)
+}
+```
+
+## Dependencies Report
+
+The plugin automatically collects an application's external dependencies (including transitive ones), and generates a compile-time report. The Sentry Java SDK picks up the report at runtime and sends it along with every Sentry event. The event dependencies metadata will look something like this:
+
+![Java dependencies report](dependencies-report.png)