Ansight.Maui 1.11.0

dotnet add package Ansight.Maui --version 1.11.0
                    
NuGet\Install-Package Ansight.Maui -Version 1.11.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Ansight.Maui" Version="1.11.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Ansight.Maui" Version="1.11.0" />
                    
Directory.Packages.props
<PackageReference Include="Ansight.Maui" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Ansight.Maui --version 1.11.0
                    
#r "nuget: Ansight.Maui, 1.11.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Ansight.Maui@1.11.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Ansight.Maui&version=1.11.0
                    
Install as a Cake Addin
#tool nuget:?package=Ansight.Maui&version=1.11.0
                    
Install as a Cake Tool

Ansight.Maui

All-in-one Ansight package for .NET MAUI apps.

This package references Ansight, adds the MAUI remote tools, and provides MauiAppBuilder setup helpers with automatic MAUI telemetry wiring. Ansight.Annotations and Ansight.OfflineCapture are included transitively but remain opt-in.

See the .NET MAUI getting-started guide for package installation, the development-build guard, and CLI verification.

dotnet add package Ansight.Maui --prerelease

License

The Ansight SDK is source-available software under the PolyForm Shield 1.0.0. It permits use, modification and redistribution for purposes allowed by the licence, which excludes providing competing products. Local development features require no Ansight account or subscription.

#if DEBUG
using Ansight.Maui;
#endif

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();

    builder.UseMauiApp<App>();

#if DEBUG
    builder.UseAnsight<App>();
#endif

    return builder.Build();
}

Use UseAnsight<App>() to initialize and activate the runtime from the MAUI builder. It also automatically records foreground/background lifecycle transitions and records a screen-view event whenever a MAUI page appears. No AppDelegate, Android Application, or page OnAppearing calls are required for the default telemetry.

Start the local host with ansight host run. Simulators and Mac Catalyst register automatically through loopback; no explicit connection call is required. Verify with ansight session list --connected --json and ansight app tools <session-id> --json.

For a physical device, run ansight pairing issue --qr, then scan it from a developer-only button or command:

await Runtime.HostConnection.ConnectAsync(HostConnectionRequest.QrCode());

No pairing file, build property, host address, or Android activity callback is required. Ansight stores this app installation's registration and reconnects automatically on later launches.

The all-in-one MAUI setup registers annotations in Debug builds:

using Ansight.Annotations;

builder.UseAnsight<App>();

// From a button or other in-app action:
await Annotate.PresentAsync();

WithAnnotatedFeedback(...) in the UseAnsight callback customizes capture. Release application builds remain disabled. Registered native and MAUI visual trees are captured before the editor opens.

Important: The MAUI all-in-one defaults include session JPEG capture. Screen capture will result in an FPS drop while frames are captured, encoded, and transported. Disable session JPEG capture for performance-focused runs unless visual evidence is required.

using Ansight.Maui;
using Ansight.Tools.SecureStorage;

builder.UseAnsight<App>(ansight =>
{
    ansight.WithAdditionalLogger(new CustomAnsightLogger());
    ansight.WithSecureStorageTools(secure =>
    {
        secure.WithStorageIdentifier("ExampleApp");
        secure.AllowKeyPrefix("ansight.secure.");
    });
});

The callback runs before default tool-suite registration. If it registers secure storage, preferences, MAUI tools, or another suite, the all-in-one setup skips the default registration for that suite and keeps the configured version. Full tool access is applied before the callback, so the callback can also narrow the guard.

Host auto-probe is enabled by the all-in-one defaults. Ansight remembers successful host sessions per Wi-Fi network reported by the connected host, stores the latest host/LAN address for that network, and retries those profiles so the app can reconnect after the host disappears and later reappears. Profiles expire after 14 days by default, and a successful reconnect refreshes the matching Wi-Fi profile. Configure retention in the same callback:

builder.UseAnsight<App>(ansight =>
{
    ansight.WithHostConnectionProfileRetention(TimeSpan.FromDays(30));
});

If options are built manually, call the MauiAppBuilder overload with those options so the MAUI lifecycle and page-view hooks are registered:

var options = Options.CreateBuilder()
    .WithAnsightMaui()
    .Build();

builder
    .UseMauiApp<App>()
    .UseAnsight(options);

WithAnsightMaui(...) configures runtime defaults and MAUI tools only. UseAnsight(...) is the API that registers automatic foreground/background and Application.PageAppearing telemetry.

Remote tool scanning is controlled by AnsightRemoteToolsPolicy. The default AllowedWithWarnings policy logs detected tool type and assembly details and emits a build warning when tool packages are included. Because this all-in-one package intentionally includes remote tools, Disallowed will fail builds that reference it. Use Ansight.Core plus fine-grained Ansight.Tools.* references when you need protected Release or CI builds that exercise Disallowed. Set AnsightLogRemoteTools=false to suppress the detected-tool list.

Unsupported MAUI Targets

builder.UseAnsight<App>(), builder.UseAnsight(configure), and builder.UseAnsight(options) are no-ops on unsupported targets such as Windows. The neutral .NET assembly supplies the same extension signatures, so a shared MauiProgram no longer needs a #if !WINDOWS guard around registration. Android, iOS, and Mac Catalyst keep their normal behavior.

On an unsupported target the builder is returned unchanged: no runtime activation, service registration, lifecycle hooks, or configuration callback invocation occurs. This enables compilation; it does not add Windows capture support. Platform-specific code inside the callback still has to compile for that target.

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-android35.0 is compatible.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-ios18.0 is compatible.  net9.0-maccatalyst was computed.  net9.0-maccatalyst18.0 is compatible.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.11.0 107 11/6/2026
1.10.0 96 11/4/2026
1.9.0 130 10/23/2026
1.8.1 159 10/11/2026
1.8.0 120 10/11/2026
1.7.1 112 10/7/2026
1.7.0 114 10/6/2026
1.6.3 126 10/1/2026
1.6.2 115 10/1/2026
1.6.1 129 9/23/2026
1.6.0 114 9/17/2026
1.5.0 124 9/14/2026
1.4.0 139 9/7/2026
1.4.0-preview.5 89 8/26/2026
1.4.0-preview.3 95 8/25/2026
1.4.0-preview.1 105 8/24/2026
1.3.0-preview.12 90 8/24/2026
1.3.0-preview.11 103 8/23/2026
1.3.0-preview.10 97 8/21/2026
1.3.0-preview.9 94 8/20/2026
Loading failed