Ansight.Maui
1.11.0
dotnet add package Ansight.Maui --version 1.11.0
NuGet\Install-Package Ansight.Maui -Version 1.11.0
<PackageReference Include="Ansight.Maui" Version="1.11.0" />
<PackageVersion Include="Ansight.Maui" Version="1.11.0" />
<PackageReference Include="Ansight.Maui" />
paket add Ansight.Maui --version 1.11.0
#r "nuget: Ansight.Maui, 1.11.0"
#:package Ansight.Maui@1.11.0
#addin nuget:?package=Ansight.Maui&version=1.11.0
#tool nuget:?package=Ansight.Maui&version=1.11.0
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 | Versions 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. |
-
net9.0
- Ansight (>= 1.11.0)
- Ansight.Annotations (>= 1.11.0)
- Ansight.OfflineCapture (>= 1.11.0)
- Ansight.Tools.Maui (>= 1.11.0)
- Microsoft.Maui.Controls.Core (>= 9.0.120)
-
net9.0-android35.0
- Ansight (>= 1.11.0)
- Ansight.Annotations (>= 1.11.0)
- Ansight.OfflineCapture (>= 1.11.0)
- Ansight.Tools.Maui (>= 1.11.0)
- Microsoft.Maui.Controls (>= 9.0.120)
-
net9.0-ios18.0
- Ansight (>= 1.11.0)
- Ansight.Annotations (>= 1.11.0)
- Ansight.OfflineCapture (>= 1.11.0)
- Ansight.Tools.Maui (>= 1.11.0)
- Microsoft.Maui.Controls (>= 9.0.120)
-
net9.0-maccatalyst18.0
- Ansight (>= 1.11.0)
- Ansight.Annotations (>= 1.11.0)
- Ansight.OfflineCapture (>= 1.11.0)
- Ansight.Tools.Maui (>= 1.11.0)
- Microsoft.Maui.Controls (>= 9.0.120)
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 |