feat(preprod): Parameterize gradle upload component for distribution

Created a reusable GradleConfigBlock component to share gradle upload documentation between size analysis and build distribution. This allows both features to use the same documentation structure while only changing the config block name (sizeAnalysis vs distribution).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: runningcode

docs/platforms/android/build-distribution/index.mdx

@@ -17,7 +17,7 @@ description: Upload Android builds to Sentry for distribution to internal teams
 
 ### Uploading With Gradle
 
-<Include name="size-analysis/upload-gradle" />
+<Include name="build-distribution/upload-gradle" />
 
 ### Uploading With the Sentry CLI
 

includes/build-distribution/upload-gradle.mdx

@@ -0,0 +1,59 @@
+The Gradle plugin automatically detects build metadata from your git repository. On GitHub Actions, all metadata is automatically detected. On other CI systems, you may need to manually set some values using the `vcsInfo` extension.
+
+1. Configure the [Sentry Android Gradle plugin](/platforms/android/configuration/gradle/) with at least version `6.0.0-beta1`
+
+2. Set the auth token as an environment variable to be used when running your release build.
+
+   <OrgAuthTokenNote />
+
+   ```bash
+   export SENTRY_AUTH_TOKEN=___ORG_AUTH_TOKEN___
+   ```
+
+3. Enable uploading for build distribution for CI builds.
+
+   <GradleConfigBlock configBlock="distribution" />
+
+4. Invoke the following Gradle tasks to build your app and trigger the upload.
+
+   ```aab {filename:aab}
+   ./gradlew bundleRelease
+   ```
+
+   ```apk {filename:apk}
+   ./gradlew assembleRelease
+   ```
+
+5. After an upload has successfully processed, confirm the metadata is correct in the Sentry UI
+
+   ![Upload metadata =400x](./images/android-metadata.png)
+
+### Overriding Metadata
+
+The Gradle plugin automatically detects build metadata from your git repository. On GitHub Actions, all metadata is automatically detected. On other CI systems, you may need to manually set some values using the `vcsInfo` extension.
+
+Configure overrides in your Gradle build configuration:
+
+<GradleConfigBlock configBlock="distribution" vcsInfo={{
+  headSha: "abc123",
+  baseSha: "def456",
+  vcsProvider: "github",
+  headRepoName: "organization/repository",
+  baseRepoName: "organization/repository",
+  headRef: "feature-branch",
+  baseRef: "main",
+  prNumber: 42
+}} />
+
+Available `vcsInfo` properties:
+
+| Property       | Type   | Description                       |
+| -------------- | ------ | --------------------------------- |
+| `headSha`      | String | Current commit SHA                |
+| `baseSha`      | String | Base commit SHA (for comparison)  |
+| `vcsProvider`  | String | VCS provider (e.g., "github")     |
+| `headRepoName` | String | Repository name (org/repo format) |
+| `baseRepoName` | String | Base repository name              |
+| `headRef`      | String | Branch or tag name                |
+| `baseRef`      | String | Base branch name                  |
+| `prNumber`     | Int    | Pull request number               |

includes/size-analysis/upload-gradle.mdx

@@ -12,21 +12,7 @@ The Gradle plugin automatically detects build metadata from your git repository.
 
 3. Enable uploading for size analysis for CI builds.
 
-   ```kotlin {filename:build.gradle.kts}
-   sentry {
-     sizeAnalysis {
-       enabled = providers.environmentVariable("GITHUB_ACTIONS").isPresent
-     }
-   }
-   ```
-
-   ```groovy {filename:build.gradle}
-   sentry {
-     sizeAnalysis {
-       enabled = providers.environmentVariable("GITHUB_ACTIONS").present
-     }
-   }
-   ```
+   <GradleConfigBlock configBlock="sizeAnalysis" />
 
 4. Invoke the following Gradle tasks to build your app and trigger the upload.
 
@@ -48,43 +34,16 @@ The Gradle plugin automatically detects build metadata from your git repository.
 
 Configure overrides in your Gradle build configuration:
 
-```kotlin {filename:build.gradle.kts}
-sentry {
-  sizeAnalysis {
-    enabled = providers.environmentVariable("GITHUB_ACTIONS").isPresent
-  }
-
-  vcsInfo {
-    headSha.set("abc123")
-    baseSha.set("def456")
-    vcsProvider.set("github")
-    headRepoName.set("organization/repository")
-    baseRepoName.set("organization/repository")
-    headRef.set("feature-branch")
-    baseRef.set("main")
-    prNumber.set(42)
-  }
-}
-```
-
-```groovy {filename:build.gradle}
-sentry {
-  sizeAnalysis {
-    enabled = providers.environmentVariable("GITHUB_ACTIONS").present
-  }
-
-  vcsInfo {
-    headSha = 'abc123'
-    baseSha = 'def456'
-    vcsProvider = 'github'
-    headRepoName = 'organization/repository'
-    baseRepoName = 'organization/repository'
-    headRef = 'feature-branch'
-    baseRef = 'main'
-    prNumber = 42
-  }
-}
-```
+<GradleConfigBlock configBlock="sizeAnalysis" vcsInfo={{
+  headSha: "abc123",
+  baseSha: "def456",
+  vcsProvider: "github",
+  headRepoName: "organization/repository",
+  baseRepoName: "organization/repository",
+  headRef: "feature-branch",
+  baseRef: "main",
+  prNumber: 42
+}} />
 
 Available `vcsInfo` properties:
 

src/components/gradleConfigBlock.tsx

@@ -0,0 +1,72 @@
+import {Fragment} from 'react';
+
+import {CodeBlock} from './codeBlock';
+import {PlatformSection} from './platformSection';
+
+type VcsInfo = {
+  baseSha?: string;
+  baseRef?: string;
+  baseRepoName?: string;
+  headRef?: string;
+  headRepoName?: string;
+  headSha?: string;
+  prNumber?: number;
+  vcsProvider?: string;
+};
+
+type Props = {
+  configBlock?: string;
+  vcsInfo?: VcsInfo;
+};
+
+export function GradleConfigBlock({configBlock = 'sizeAnalysis', vcsInfo}: Props) {
+  const kotlinVcsInfo = vcsInfo
+    ? `\n\n  vcsInfo {
+    headSha.set("${vcsInfo.headSha}")
+    baseSha.set("${vcsInfo.baseSha}")
+    vcsProvider.set("${vcsInfo.vcsProvider}")
+    headRepoName.set("${vcsInfo.headRepoName}")
+    baseRepoName.set("${vcsInfo.baseRepoName}")
+    headRef.set("${vcsInfo.headRef}")
+    baseRef.set("${vcsInfo.baseRef}")
+    prNumber.set(${vcsInfo.prNumber})
+  }`
+    : '';
+
+  const groovyVcsInfo = vcsInfo
+    ? `\n\n  vcsInfo {
+    headSha = '${vcsInfo.headSha}'
+    baseSha = '${vcsInfo.baseSha}'
+    vcsProvider = '${vcsInfo.vcsProvider}'
+    headRepoName = '${vcsInfo.headRepoName}'
+    baseRepoName = '${vcsInfo.baseRepoName}'
+    headRef = '${vcsInfo.headRef}'
+    baseRef = '${vcsInfo.baseRef}'
+    prNumber = ${vcsInfo.prNumber}
+  }`
+    : '';
+
+  return (
+    <Fragment>
+      <PlatformSection supported={['android.android-gradle-kotlin']}>
+        <CodeBlock language="kotlin" filename="build.gradle.kts">
+          {`sentry {
+  ${configBlock} {
+    enabled = providers.environmentVariable("GITHUB_ACTIONS").isPresent
+  }${kotlinVcsInfo}
+}`}
+        </CodeBlock>
+      </PlatformSection>
+
+      <PlatformSection supported={['android.android-gradle-groovy']}>
+        <CodeBlock language="groovy" filename="build.gradle">
+          {`sentry {
+  ${configBlock} {
+    enabled = providers.environmentVariable("GITHUB_ACTIONS").present
+  }${groovyVcsInfo}
+}`}
+        </CodeBlock>
+      </PlatformSection>
+    </Fragment>
+  );
+}

src/mdxComponents.ts

@@ -15,6 +15,7 @@ import {DevDocsCardGrid} from './components/devDocsCardGrid';
 import DocImage from './components/docImage';
 import {Expandable} from './components/expandable';
 import {GitHubDomainChecker} from './components/githubDomainChecker';
+import {GradleConfigBlock} from './components/gradleConfigBlock';
 import {GuideGrid} from './components/guideGrid';
 import {JsBundleList} from './components/jsBundleList';
 import {LambdaLayerDetail} from './components/lambdaLayerDetail';
@@ -77,6 +78,7 @@ export function mdxComponents(
     TableOfContents,
     CreateGitHubAppForm,
     GitHubDomainChecker,
+    GradleConfigBlock,
     ConfigValue,
     DefinitionList,
     Expandable,