docs(dotnet): document .NET native options for Android and Apple by jamescrosswell · Pull Request #16664 · getsentry/sentry-docs

jamescrosswell · 2026-03-04T01:04:17Z

DESCRIBE YOUR PR

Documents the options.Native.* configuration surface for the embedded native SDKs in .NET for Android and .NET for Apple.

Previously these options were undocumented. This adds dedicated reference pages for both platforms.

Changes:

New: docs/platforms/dotnet/guides/android/configuration/native-options.mdx
New: docs/platforms/dotnet/guides/apple/configuration/native-options.mdx
Updated: Android, Apple, and MAUI guide index pages to link to the new docs

Closes #11745
Based on #16663

IS YOUR CHANGE URGENT?

None: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

Checked Vercel preview for correctness, including links
PR was reviewed and approved by any necessary SMEs
PR was reviewed and approved by a member of the Sentry docs team

Add dedicated reference pages for options.Native.* configuration on .NET for Android and .NET for Apple platforms (iOS, macOS, Mac Catalyst). - docs/platforms/dotnet/guides/android/configuration/native-options.mdx - docs/platforms/dotnet/guides/apple/configuration/native-options.mdx Covers: ANR detection, breadcrumbs, performance tracing, screenshots, app hangs, swizzling, session replay (experimental), error handling, NDK, networking, stack trace filtering, and profiling. Also updates the Android, Apple, and MAUI guide index pages to link to the new native options reference docs. Closes #11745 Co-Authored-By: Claude <noreply@anthropic.com>

vercel · 2026-03-04T01:04:22Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
sentry-docs	Ready	Preview, Comment	Mar 5, 2026 2:20am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ignored	Preview	Mar 5, 2026 2:20am

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx

Flash0ver · 2026-03-04T21:11:25Z

.github/copilot-instructions.md

@@ -0,0 +1 @@
+../AGENTS.md


suggestion: We may want to add this in a separate PR, as it's not .NET specific

Flash0ver · 2026-03-04T21:16:23Z

docs/platforms/dotnet/guides/android/index.mdx


-            // All the native Android SDK options are available below
-            // https://docs.sentry.io/platforms/android/configuration/
-            // Enable Native Android SDK ANR detection


question: intended to remove this comment?

Flash0ver · 2026-03-04T21:19:16Z

docs/platforms/dotnet/guides/android/index.mdx

-            // https://docs.sentry.io/platforms/android/configuration/
-            // Enable Native Android SDK ANR detection
+            // Native Android SDK options are available via options.Native
+            // See: /platforms/dotnet/guides/android/configuration/native-options/


issue: this link is not quite helpful

Should this be https://docs.sentry.io/platforms/dotnet/guides/android/configuration/native-options/

docs/platforms/dotnet/guides/android/configuration/native-options.mdx

Flash0ver · 2026-03-04T21:29:33Z

docs/platforms/dotnet/guides/android/configuration/native-options.mdx

+
+Adds breadcrumbs for `Activity` lifecycle events (created, started, resumed, paused, stopped, destroyed).
+
+See [Automatic Breadcrumbs](/platforms/android/enriching-events/breadcrumbs/).


question: should we - for all Automatic Breadcrumbs links - link to the #automatic-breadcrumbs anchor ... but to be fair, that section is quite short and does not really give related information

Flash0ver · 2026-03-04T22:20:47Z

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx

+
+<SdkOption name="Native.ExperimentalOptions.SessionReplay.OnErrorSampleRate" type="double?" defaultValue="null">
+
+Sample rate for sessions that encountered an error, between `0.0` and `1.0`. Set to `0.0` or leave as `null` to disable session replay for errored sessions.


question: errored

same comment as here: https://github.com/getsentry/sentry-docs/pull/16664/changes#r2886300004

Flash0ver · 2026-03-04T22:21:20Z

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx

+
+<SdkOption name="Native.ExperimentalOptions.SessionReplay.MaskAllText" type="bool" defaultValue="true">
+
+Masks all text content in session replay recordings to protect user privacy. Enabled by default.


todo: we need to mention "best effort" when it comes to automatic masking

Flash0ver · 2026-03-04T22:21:24Z

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx

+
+<SdkOption name="Native.ExperimentalOptions.SessionReplay.MaskAllImages" type="bool" defaultValue="true">
+
+Masks all images in session replay recordings to protect user privacy. Enabled by default.


todo: we need to mention "best effort" when it comes to automatic masking

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx

Flash0ver · 2026-03-04T22:26:13Z

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx

+
+<SdkOption name="Native.ExperimentalOptions.SessionReplay.EnableSessionReplayInUnreliableEnvironment" type="bool" defaultValue="false">
+
+Forces session replay to be enabled even in unreliable environments (iOS 26+ with Liquid Glass). By default, session replay is disabled on iOS 26 and later because masking of text and images cannot be reliably guaranteed.


thought: I'm not sure we should every write reliably guaranteed when it comes to automatic masking

See also the first warning of https://docs.sentry.io/platforms/apple/guides/ios/session-replay/.
We shouldn't imply that - even without Liquid Glass - automatic masking can be "guaranteed".

Not sure how to rephrase it, though 🙁

docs/platforms/dotnet/guides/android/configuration/native-options.mdx

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx

Co-authored-by: Stefan Pölz <38893694+Flash0ver@users.noreply.github.com>

codeowner-assignment bot requested a review from a team March 4, 2026 01:06

sentry bot reviewed Mar 4, 2026

View reviewed changes

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx Show resolved Hide resolved

vercel bot deployed to Preview – sentry-docs March 4, 2026 01:12 View deployment

Flash0ver reviewed Mar 4, 2026

View reviewed changes

jamescrosswell commented Mar 5, 2026

View reviewed changes

docs/platforms/dotnet/guides/android/configuration/native-options.mdx Outdated Show resolved Hide resolved

jamescrosswell commented Mar 5, 2026

View reviewed changes

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx Outdated Show resolved Hide resolved

jamescrosswell commented Mar 5, 2026

View reviewed changes

docs/platforms/dotnet/guides/apple/configuration/native-options.mdx Outdated Show resolved Hide resolved

Apply suggestions from code review

5996c26

Co-authored-by: Stefan Pölz <38893694+Flash0ver@users.noreply.github.com>

codeowner-assignment bot requested a review from a team March 5, 2026 02:09

vercel bot deployed to Preview – sentry-docs March 5, 2026 02:20 View deployment

jamescrosswell changed the base branch from master to copilot-symlink March 5, 2026 03:30

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs(dotnet): document .NET native options for Android and Apple#16664

docs(dotnet): document .NET native options for Android and Apple#16664
jamescrosswell wants to merge 2 commits intocopilot-symlinkfrom
native-options

jamescrosswell commented Mar 4, 2026 •

edited by Flash0ver

Loading

Uh oh!

vercel bot commented Mar 4, 2026 •

edited

Loading

Uh oh!

Uh oh!

Flash0ver Mar 4, 2026

Uh oh!

Flash0ver Mar 4, 2026

Uh oh!

Flash0ver Mar 4, 2026

Uh oh!

Uh oh!

Flash0ver Mar 4, 2026

Uh oh!

Flash0ver Mar 4, 2026

Uh oh!

Flash0ver Mar 4, 2026

Uh oh!

Flash0ver Mar 4, 2026

Uh oh!

Uh oh!

Flash0ver Mar 4, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		Adds breadcrumbs for `Activity` lifecycle events (created, started, resumed, paused, stopped, destroyed).

		See [Automatic Breadcrumbs](/platforms/android/enriching-events/breadcrumbs/).


		<SdkOption name="Native.ExperimentalOptions.SessionReplay.OnErrorSampleRate" type="double?" defaultValue="null">

		Sample rate for sessions that encountered an error, between `0.0` and `1.0`. Set to `0.0` or leave as `null` to disable session replay for errored sessions.


		<SdkOption name="Native.ExperimentalOptions.SessionReplay.MaskAllText" type="bool" defaultValue="true">

		Masks all text content in session replay recordings to protect user privacy. Enabled by default.


		<SdkOption name="Native.ExperimentalOptions.SessionReplay.MaskAllImages" type="bool" defaultValue="true">

		Masks all images in session replay recordings to protect user privacy. Enabled by default.


		<SdkOption name="Native.ExperimentalOptions.SessionReplay.EnableSessionReplayInUnreliableEnvironment" type="bool" defaultValue="false">

		Forces session replay to be enabled even in unreliable environments (iOS 26+ with Liquid Glass). By default, session replay is disabled on iOS 26 and later because masking of text and images cannot be reliably guaranteed.

		@@ -0,0 +1 @@
		../AGENTS.md No newline at end of file

Uh oh!

Conversation

jamescrosswell commented Mar 4, 2026 • edited by Flash0ver Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

DESCRIBE YOUR PR

IS YOUR CHANGE URGENT?

PRE-MERGE CHECKLIST

Uh oh!

vercel bot commented Mar 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jamescrosswell commented Mar 4, 2026 •

edited by Flash0ver

Loading

vercel bot commented Mar 4, 2026 •

edited

Loading