Skip to content

fix(docs): Add ProGuard related properties to MAUI MSBuild page #14995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alexsohn1126 merged 7 commits into from
Sep 24, 2025
Merged

fix(docs): Add ProGuard related properties to MAUI MSBuild page #14995

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
e8d6807
fix(docs): Add ProGuard related properties to MAUI MSBuild page
alexsohn1126 Sep 19, 2025
c9011be
Merge branch 'master' into alexsohn/fix/add-proguard-related-info-to-…
jamescrosswell Sep 19, 2025
ed97386
Update docs/platforms/dotnet/common/configuration/msbuild.mdx
alexsohn1126 Sep 22, 2025
9bee8a6
Update docs/platforms/dotnet/common/configuration/msbuild.mdx
alexsohn1126 Sep 22, 2025
2270e06
Update msbuild.mdx
alexsohn1126 Sep 22, 2025
9cea97a
Improve wording and layout
alexsohn1126 Sep 22, 2025
90276e3
Change Proguard to ProGuard in msbuild example
alexsohn1126 Sep 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 28 additions & 1 deletion docs/platforms/dotnet/common/configuration/msbuild.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ if you only want these features enabled in a GitHub Actions CI workflow, you cou
<SentryUploadSources>true</SentryUploadSources>

<!-- If you are targeting Android, sends proguard mapping file to Sentry. -->
<SentryUploadAndroidProguardMapping>true</SentryUploadAndroidProguardMapping>
<SentryUploadAndroidProGuardMapping>true</SentryUploadAndroidProGuardMapping>

</PropertyGroup>

Expand Down Expand Up @@ -174,6 +174,14 @@ Sentry will try to determine the release version automatically by checking the f

</ConfigKey>

<ConfigKey name="SentryProGuardUUID" supported={["dotnet.maui"]}>

Define the UUID used to link an APK and its ProGuard mapping file.

If not defined, Sentry will [generate a UUID](#SentryUploadAndroidProGuardMapping) for you.

</ConfigKey>

<ConfigKey name="SentrySetCommits">

Enable `SentrySetCommits` to automatically [associate commits with the release](/cli/releases/#commit-integration).
Expand All @@ -186,6 +194,25 @@ By default, when `SentrySetCommits` is enabled, the SDK will set commits with th

</ConfigKey>

<ConfigKey name="SentryUploadAndroidProGuardMapping" supported={["dotnet.maui"]}>

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.

<Alert>
Do not overwrite the `io.sentry.proguard-uuid` metadata directly. Use [SentryProGuardUUID](#SentryProGuardUUID) if you need to provide a custom UUID.
</Alert>

</ConfigKey>

<ConfigKey name="SentryUploadSymbols">

Controls uploading symbols to Sentry during the build. Defaults to `false` (disabled).
Expand Down
Loading