How appium/appium-wincore-driver works
Appium WinCore Driver automates Windows desktop applications through an Appium-facing TypeScript driver and a native C# JSON-RPC server. The core workflow is session setup, locator conversion/search, and element or window operations against the live UI Automation tree; results return through the server client. The README also documents hybrid WebView/CDP, Internet Explorer, accessibility, clipboard, and screen-recording capabilities. Some native command implementations and integrations are unsampled, so their documented presence is shown without guessing internal call paths.
Main entry points: CommandDispatcher.cs Command Dispatcher · driver.ts Appium Driver · UIA.cs UI Automation · SessionCommands.cs Session Setup
Components 27
Appium Driver
- Appium Driver
lib/driver.ts - Driver Commands
lib/commands - Selector Processing
lib/uia-selector/parser.ts - CSS Conversion
lib/css/index.ts - Server Client
lib/server/client.ts
Native Automation Server
- Server Entry
csharp/WincoreServer/Program.cs - JSON-RPC Server
csharp/WincoreServer/Server/JsonRpcServer.cs - Command Dispatcher
csharp/WincoreServer/Server/CommandDispatcher.cs - Session State
csharp/WincoreServer/State/SessionState.cs - Session Setup
csharp/WincoreServer/Commands/SessionCommands.cs - Element Search
csharp/WincoreServer/Commands/FindCommands.cs - XPath Search
csharp/WincoreServer/Commands/XPathCommands.cs - Page Source
csharp/WincoreServer/Commands/PageSourceCommands.cs - UIA Patterns
csharp/WincoreServer/Commands/PatternCommands.cs - Accessibility Values
csharp/WincoreServer/Commands/AccessibilityCommands.cs - Window And Device APIs
csharp/WincoreServer/Commands - UI Automation
csharp/WincoreServer/Uia3/UIA.cs - Condition Builder
csharp/WincoreServer/Server/ConditionBuilder.cs - Provider SDK
csharp/WincoreServerSdk/ITreeProvider.cs - Plugin Hosting
csharp/WincoreServer/Plugins/PluginHost.cs
Browser Integrations
- IE DOM Client
lib/ie/session.ts - IE DOM Bridge
csharp/IEBridge/IEBridge.cs - WebView CDP
lib/commands/extension.ts
Windows Platform
- Windows Input API
lib/winapi/user32.ts
Other components
- Automation Client
- Windows Application
- Embedded Browser
Connections 31
- Automation Client → Appium Driver: sends commands
README.md - Appium Driver → Driver Commands: binds commands
lib/driver.ts - Appium Driver → Selector Processing: locates elements
lib/driver.ts - Appium Driver → CSS Conversion: converts CSS
lib/driver.ts - Appium Driver → Server Client: sends RPC
lib/driver.ts - Server Client → Server Entry: spawns server
lib/server/client.ts - Server Entry → JSON-RPC Server: starts server
csharp/WincoreServer/Program.cs - JSON-RPC Server → Command Dispatcher: dispatches methods
csharp/WincoreServer/Server/JsonRpcServer.cs - Command Dispatcher → Session State: uses session
csharp/WincoreServer/Server/CommandDispatcher.cs - Command Dispatcher → Element Search: routes searches
csharp/WincoreServer/Server/CommandDispatcher.cs - Command Dispatcher → XPath Search: routes XPath
csharp/WincoreServer/Server/CommandDispatcher.cs - Command Dispatcher → Page Source: routes source
csharp/WincoreServer/Server/CommandDispatcher.cs - Command Dispatcher → UIA Patterns: routes patterns
csharp/WincoreServer/Server/CommandDispatcher.cs - Command Dispatcher → Accessibility Values: routes accessibility
csharp/WincoreServer/Server/CommandDispatcher.cs - Command Dispatcher → Window And Device APIs: routes commands
csharp/WincoreServer/Server/CommandDispatcher.cs - Command Dispatcher → Session Setup: routes sessions
csharp/WincoreServer/Server/CommandDispatcher.cs - Session Setup → Session State: sets session state
csharp/WincoreServer/Commands/SessionCommands.cs - Session State → UI Automation: initializes UIA
csharp/WincoreServer/State/SessionState.cs - Session Setup → Condition Builder: builds conditions
csharp/WincoreServer/Commands/SessionCommands.cs - Selector Processing → Condition Builder: encodes conditions
lib/uia-selector/parser.ts - Element Search → UI Automation: searches tree
- XPath Search → UI Automation: evaluates XPath
- Command Dispatcher → Plugin Hosting: routes plugin calls
csharp/WincoreServer/Server/CommandDispatcher.cs - Plugin Hosting → Provider SDK: uses provider contract
csharp/WincoreServer/Plugins/PluginHost.cs - Appium Driver → IE DOM Client: supports IE sessions
README.md - IE DOM Client → IE DOM Bridge: communicates with bridge
README.md - Appium Driver → WebView CDP: supports hybrid mode
README.md - WebView CDP → Embedded Browser: automates embedded content
README.md - Driver Commands → Windows Input API: uses native input
lib/commands/app.ts - Windows Input API → Windows Application: sends input
- UI Automation → Windows Application: reads UI tree
README.md