.NET Packages

Choose the all-in-one .NET or .NET MAUI SDK, the core runtime, optional workflows, and individual remote tool packages.

Use Ansight.Maui for a .NET MAUI app and Ansight for a native .NET Android, iOS, or Mac Catalyst app. These all-in-one packages are the shortest path through the .NET quickstart.

Choose Ansight.Core only when the app needs manual runtime and tool registration.

Supported Targets

The core package targets:

  • net9.0
  • net9.0-android
  • net9.0-ios
  • net9.0-maccatalyst

Runtime and Workflow Packages

The NuGet badges link to each package and show its current prerelease version.

PackageNuGetUse whenIncludes
AnsightNuGetYou want the standard non-MAUI app setup.Ansight.Core, native pairing where supported, all non-MAUI remote tool packages, annotated feedback, offline capture, and the WithAnsightSdk(...) setup API.
Ansight.MauiNuGetYou are integrating a .NET MAUI app.Ansight, Ansight.Tools.Maui, annotated feedback, offline capture, and MauiAppBuilder setup helpers.
Ansight.CoreNuGetYou want direct control over runtime and tool registration.Core runtime, telemetry, pairing protocol, tool abstractions, host connection, JPEG capture, and build-time safety targets.
Ansight.AnnotationsNuGetYou want Debug-only annotated in-app feedback without an all-in-one package.Native editor, screenshot and visual-tree evidence, hooks, artifacts, outbox, and live/offline delivery.
Ansight.OfflineCaptureNuGetYou want evidence capture without a live host connection.Local storage, retention, runtime mutation, screenshots, annotation bundles, ZIP/AES export, and team upload.

The runtime namespace remains Ansight even when the NuGet package id is Ansight.Core. The all-in-one packages reference annotated feedback and offline capture, but neither workflow starts automatically.

What Ansight.Core Includes

  • sampling and retention configuration
  • built-in memory and FPS metrics
  • opt-in battery, open-file-handle, and Android JNI-reference-count metrics
  • screen-view, lifecycle, log, custom channel, screenshot, and touch capture
  • durable native crash capture and next-launch delivery
  • app artifact providers and streamed artifact requests
  • package-owned runtime extensions through IRuntimeFeature
  • runtime-owned host connection and reconnection
  • opt-in cellular connection policy and native unattended test provisioning
  • tool abstractions, custom tools, tool guard policy, and build-time enforcement

Tool Packages

Warning: Keep tool packages scoped to local development builds only.

Install tool packages separately only when using Ansight.Core. The all-in-one packages already include their respective tool sets.

ToolPackageNuGet
VisualTreeAnsight.Tools.VisualTreeNuGet
MAUIAnsight.Tools.MauiNuGet
ReflectionAnsight.Tools.ReflectionNuGet
DatabaseAnsight.Tools.DatabaseNuGet
FileSystemAnsight.Tools.FileSystemNuGet
PreferencesAnsight.Tools.PreferencesNuGet
SecureStorageAnsight.Tools.SecureStorageNuGet

See the complete remote tools guide for registration APIs, capabilities, and guard policy.

Core-Only Installation

dotnet add package Ansight.Core --prerelease

Add Ansight.Pairing separately when a core-only app should own native QR acquisition. Add individual Ansight.Tools.* packages only for the tool suites the workflow needs.

Follow .NET Setup for the recommended all-in-one installation and startup flow. Review .NET Security before choosing the package layout for distributable builds.