diff --git a/docs/platforms/dotnet/common/configuration/msbuild.mdx b/docs/platforms/dotnet/common/configuration/msbuild.mdx index 14f8861da89ed..d9b0868c088fe 100644 --- a/docs/platforms/dotnet/common/configuration/msbuild.mdx +++ b/docs/platforms/dotnet/common/configuration/msbuild.mdx @@ -115,7 +115,7 @@ if you only want these features enabled in a GitHub Actions CI workflow, you cou true - true + true @@ -174,6 +174,14 @@ Sentry will try to determine the release version automatically by checking the f + + +Define the UUID used to link an APK and its ProGuard mapping file. + +If not defined, Sentry will [generate a UUID](#SentryUploadAndroidProGuardMapping) for you. + + + Enable `SentrySetCommits` to automatically [associate commits with the release](/cli/releases/#commit-integration). @@ -186,6 +194,25 @@ By default, when `SentrySetCommits` is enabled, the SDK will set commits with th + + +Controls whether a ProGuard mapping file is uploaded to Sentry. + +Defaults to `false` (disabled). + +When set to `true`: +- A ProGuard UUID is generated automatically, unless you configure your own via [SentryProGuardUUID](#SentryProGuardUUID). +- This UUID is injected into the APK as manifest metadata under the key `io.sentry.proguard-uuid`. +- The same UUID is used to associate the uploaded ProGuard mapping file with the build in Sentry. + +This ensures that obfuscated stack traces from your Android app can be correctly de-obfuscated in Sentry. + + +Do not overwrite the `io.sentry.proguard-uuid` metadata directly. Use [SentryProGuardUUID](#SentryProGuardUUID) if you need to provide a custom UUID. + + + + Controls uploading symbols to Sentry during the build. Defaults to `false` (disabled).