Ailoha.Agent.WinUI
0.2.3
See the version list below for details.
dotnet add package Ailoha.Agent.WinUI --version 0.2.3
NuGet\Install-Package Ailoha.Agent.WinUI -Version 0.2.3
<PackageReference Include="Ailoha.Agent.WinUI" Version="0.2.3" />
<PackageVersion Include="Ailoha.Agent.WinUI" Version="0.2.3" />
<PackageReference Include="Ailoha.Agent.WinUI" />
paket add Ailoha.Agent.WinUI --version 0.2.3
#r "nuget: Ailoha.Agent.WinUI, 0.2.3"
#:package Ailoha.Agent.WinUI@0.2.3
#addin nuget:?package=Ailoha.Agent.WinUI&version=0.2.3
#tool nuget:?package=Ailoha.Agent.WinUI&version=0.2.3
Ailoha Agent for WinUI
Ailoha.Agent.WinUI embeds the Ailoha DevFlow Agent Protocol in native WinUI 3 applications. It walks the WinUI visual tree directly with VisualTreeHelper, maps WinUI controls to protocol ElementInfo nodes, and exposes inspection, action, screenshot, device, storage, WebView2, and unsupported-capability endpoints over the standard local HTTP agent port.
Installation
<PackageReference Include="Ailoha.Agent.WinUI" Version="0.1.*" />
Keep startup behind a debug/internal guard; the agent binds a local HTTP server inside the app process.
Debug startup
#if DEBUG
_agent = WinUiDevFlowAgent.Start(window, options =>
{
options.Port = 9233;
options.AppName = "My WinUI App";
});
#endif
For apps with route names, set options.RouteResolver so /api/v1/ui/actions/navigate can call application navigation code without needing a platform-specific protocol extension.
Configuration
Portdefaults to9233and can be overridden withAILOHA_PORT.EnableBrokerRegistrationregisters the app with the local broker on port19323so the CLI can discover it.RouteResolverandBackHandlerlet apps connect protocol navigation actions to their own navigation model.WindowsProvidercan expose additional WinUI windows for multi-window apps.
Validation
From the repository root on Windows:
dotnet build winui\agent\Ailoha.Agent.WinUI\Ailoha.Agent.WinUI.csproj
dotnet test winui\tests\WinUI.IntegrationTests.csproj
Notes
- Stable element IDs prefer
AutomationProperties.AutomationId, thenFrameworkElement.Name, then a generated visual-tree path. - Screenshots use
RenderTargetBitmap; WebView2 usesCoreWebView2.CapturePreviewAsync. - Some Windows APIs require packaged identity. The agent reports unsupported behavior for secure storage and other identity-sensitive surfaces until those are implemented.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0-windows10.0.19041 is compatible. |
-
net10.0-windows10.0.19041
- Ailoha.Agent.Windows (>= 0.2.3)
- Ailoha.Logging (>= 0.2.3)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Http (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Web.WebView2 (>= 1.0.3856.49)
- Microsoft.WindowsAppSDK (>= 1.8.251106002)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.