AvaloniaUI.DeveloperTools 2.2.0-beta2

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of AvaloniaUI.DeveloperTools. 
dotnet tool install --global AvaloniaUI.DeveloperTools --version 2.2.0-beta2
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local AvaloniaUI.DeveloperTools --version 2.2.0-beta2
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=AvaloniaUI.DeveloperTools&version=2.2.0-beta2&prerelease
                    


                    

                
nuke :add-package AvaloniaUI.DeveloperTools --version 2.2.0-beta2

Avalonia Developer Tools

The Avalonia Developer Tools is a standalone application that provides debugging and inspection capabilities for Avalonia applications. It connects to applications that have the Diagnostics Support package installed.

Prerequisites

Developer Tools requires .NET 6.0 or newer runtime to be installed on your system.

Installation

Install as .NET Global Tool

Install the Developer Tools globally using the .NET CLI:

  • For .NET 10+

    dotnet tool install --global AvaloniaUI.DeveloperTools

  • For .NET 6 to .NET 9

    You need to install platform-specific package:

    Windows:

    dotnet tool install --global AvaloniaUI.DeveloperTools.Windows

    macOS:

    dotnet tool install --global AvaloniaUI.DeveloperTools.macOS

    Linux:

    dotnet tool install --global AvaloniaUI.DeveloperTools.Linux

After installation, you can launch it from terminal using:

avdt

Getting Started

For a complete setup guide including how to configure your application with the Diagnostics Support package, see the Developer Tools Getting Started Guide.

Usage

  1. Configure your Avalonia application with the AvaloniaUI.DiagnosticsSupport package
  2. Launch the Developer Tools application
  3. Run your configured Avalonia application
  4. In your application, press F12 to establish connection
  5. Activate the tool with your AvaloniaUI Portal credentials (first time only)

Troubleshooting

If you encounter connection issues or other problems, check the Developer Tools FAQ for common solutions and troubleshooting steps.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
2.2.0-beta2 95 1/23/2026
2.2.0-beta1 111 1/19/2026
2.1.1 2,086 11/13/2025
2.1.0 1,967 10/13/2025

# 2.2.0

Don't forget to update both the .NET tool and the `AvaloniaUI.DiagnosticsSupport` package in your project.

## Enhancements

* DevTools MCP server is now available.
* DevTools can now discover and connect to running local desktop Avalonia applications directly from the Welcome screen, without needing to press F12 from the app.
* Added Visual/Logical/Merged tree toggle, replacing the old "Aggregate Templates" option (now Merged mode).
* The `AvaloniaUI.DiagnosticsSupport` package now displays a dialog when DevTools is not installed.
* Added new error dialogs for DevTools connection and protocol failures.
* Added support for the `DOTNET_CLI_HOME` environment variable for non-standard DevTools installation locations.
* Added a new `DeveloperToolsRunner.DotNetLocalTool` runner option, distinct from `DeveloperToolsRunner.DotNetTool`, which uses the global tool installation.
* The connected application is now focused when inspect mode is activated.

## Fixes

* Fixed crashes with 12.0 Avalonia nightly builds due to new breaking changes (Binding Diagnostics are not yet supported with 12.0).
* Fixed several connectivity issues between the application and DevTools.
* Fixed an issue where elements tree search would stop if an element was detached from the tree during the search.

# 2.1.1

## Enhancements

* Added a filter option to restore old devtools behavior by showing all property setters instead of only the selected one.
* Added "Listen on any IP" setting, allowing connections outside of localhost.
* Elements tree nodes are now centered on selection.
* Removed spacing between elements tree nodes.

## Fixes

* Fixed issue with "Show Rulers" setting being ignored.
* Fixed potential race condition with property grid editors.
* Fixed application not running on Windows on ARM.
* Fixed error sometimes occurring when opening routed events flyout.

# 2.1.0

## Enhancements

* Layout Visualizer has returned.
* The `Sign In` experience is now shared between the Parcel and VS extensions, with updated dialog visuals.
* .NET 10-compatible NuGet package — the tool can now be installed as `AvaloniaUI.DeveloperTools` without a platform suffix.
* The Profiler tool is no longer experimental and is now always enabled.
* Improved TitleBar integration on Windows.
* On Windows and macOS, the tool creates a shortcut in the Start Menu / Applications folder. This can be disabled with the `AVALONIA_TOOLRUNNER_DISABLE_SHORTCUT` environment variable.

## Fixes

* Fixed flashing console window when opening on Windows.
* Fixed bug popups that appeared before DevTools connected.
* Fixed file logger sometimes creating a file in the drive root directory.
* Fixed "Update is available" notification showing when the tool is up to date.

# 2.0.4

## Enhancements

* New "Freeze Popups" context menu on the Window element node and a hotkey, allowing you to keep all popups open until unchecked.
* DevTools window is now the active window when an element is inspected from the connected app.
* The Apple build is now a universal (fat) package, including arm64 and x64 (previously Rosetta was required).

## Fixes

* Variable PropertyGrid row columns across different pages, making settings and resources more accessible.
* Fixed bug with DevTools not being able to connect to Android/iOS apps.
* Fixed bug with popups not properly displayed in the elements tree.
* Fixed bug with `OverlayLayer` being ignored in the elements tree.
* `MetricsSupport` is now enabled by default in the user project in Debug configuration.

# 2.0.3

## Enhancements

* Automatic scroll for Logs and Events data grid pages. (#22)
* Previewer no longer opens DevTools when `ConnectOnStartup` is enabled. Instead, an `AutoConnectFromDesignMode` option was added for the previewer scenario. (#20)
* When the application cannot reach Developer Tools via `F12` or `ConnectOnStartup`, it will throw an exception on the dispatcher thread instead of silently ignoring it. This exception can be suppressed via `Dispatcher.UIThread.UnhandledException` if necessary.
* The `Inspect mode` hotkey/button now automatically enables highlighting with tooltips on the connected app when hovering.

# 2.0.2

## Enhancements

* New application icon.
* By default, the application now uses the system theme instead of forcing the dark variant.
* Experimental Compact mode was added.