Document custom debugger initialization on mobile platforms

[vitek-karas]

Summary

• Add a guide for custom ICorDebug-based debugger initialization in .NET 11 mobile apps that use CoreCLR.
• Cover the in-process profiler component, native library deployment, startup configuration, debugger creation, and attachment ordering. Link to the official .NET profiler samples.
• Add the guide to the debugging overview and the tools/diagnostics navigation. Exclude NativeAOT and avoid implying general-purpose mobile profiler support.

Content sources and authorship

Adapted from an engineering outline, with AI-assisted drafting followed by author revisions. No source prose was copied verbatim; the article retains ai-usage: ai-generated.

Source area	Treatment
Title and architecture	Adapted; author revised the mobile in-process rationale.
Profiler startup mechanism	Adapted; verified the DllGetClassObject export and linked the official samples.
DBI/DAC deployment	Adapted; author refined the deployment requirements.
DBI creation API	Adapted; recommends CoreCLRCreateCordbObjectEx.
Startup configuration	Adapted to the documented DOTNET_ environment variables.
Startup synchronization	Adapted to a concise attachment-order requirement.
Profiler-interface-version guidance	Omitted to keep the guide focused on initialization.
General debugger responsibilities	Reduced to the normal Unix ICorDebug model after initialization.

The API lifecycle links, scope clarifications, and navigation entries are newly added material. Technical review should focus on the mobile-specific component deployment and startup/attachment sequence; public API and sample checks do not establish an end-to-end mobile validation.

Validation

• Markdown lint passes for both changed Markdown files.
• Relative links and navigation targets verified.
• git diff --check passes.
• No executable samples were added, and no end-to-end mobile debugger run was performed.

---

Internal previews

File	Preview link
docs/core/unmanaged-api/debugging/index.md	Learn preview
docs/core/unmanaged-api/debugging/initialize-debugger-mobile.md	Learn preview
docs/navigate/tools-diagnostics/toc.yml	Learn preview

Build report

[Copilot]

Copilot review overview

🟡 Changes recommended

The initialization guide has unresolved correctness and implementation details that block approval.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 2

Open (2)

• Clarify supported mobile runtimes for local debugging · New
• Specify CoreCLRCreateCordbObjectEx arguments and in-process mapping · New

What changed in this PR

Adds documentation for initializing custom CoreCLR debuggers in .NET 11 mobile apps.

Changes:

• Documents profiler deployment, startup configuration, debugger creation, and attachment.
• Links the guide from debugging documentation and navigation.

File	Review summary
docs/​navigate/​tools-diagnostics/​toc.yml	Adds the guide to Tools/Diagnostics navigation.
docs/​core/​unmanaged-api/​debugging/​initialize-debugger-mobile.md	Six moderate issues concerning platform support, version matching, API arguments, Android packaging, callback interfaces, and startup synchronization.
docs/​core/​unmanaged-api/​debugging/​index.md	Links to the new mobile debugger guide.

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

[vitek-karas]

I think this is ready - just needs another review.