.NET MAUI Doctor

Validate and fix .NET MAUI development environments. All version requirements are discovered dynamically from NuGet APIs, never hardcode versions.

When to Use

• Setting up a new .NET MAUI development environment
• Build errors mentioning missing SDKs, workloads, JDK, or Android components
• Errors like "Android SDK not found", "Java version", or "Xcode not found"
• Verifying environment health after SDK or OS updates

When Not to Use

• Non-MAUI .NET projects (use standard .NET SDK troubleshooting instead)
• Xamarin.Forms apps (different toolchain and workload requirements)
• Runtime app crashes unrelated to environment setup
• App store publishing or signing issues
• IDE-specific issues (Visual Studio or VS Code configuration)

Important: .NET Version Currency

Your training data may be outdated regarding .NET versions. .NET ships new major releases annually (November). Always check the releases-index.json (Task 2) to discover the latest active major release, do not assume your training data reflects the current version. For example, if you know about .NET 9.0 but the releases index shows .NET 10.0 as active, use .NET 10.0.

Inputs

• A development machine running macOS, Windows, or Linux
• Shell access (Bash on macOS/Linux, PowerShell on Windows)
• Internet access for NuGet API queries and SDK downloads
• Admin/sudo access may be required for installing SDKs and workloads
• Bash prerequisites: curl, jq, and unzip (macOS/Linux)
• PowerShell prerequisites: Invoke-RestMethod and System.IO.Compression (built-in on Windows)

Behavior

• Run through ALL tasks autonomously
• Re-validate after each fix
• Iterate until complete or no further actions possible
• After detecting platform (Task 1), load only the matching platform-specific references

Workflow

Task 1: Detect Environment

# macOS
sw_vers && uname -m

# Windows
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"