Skip to content

Releases

Release v0.8.0

Choose a tag to compare

@azchohfi azchohfi released this 07 Nov 05:48

Version: 0.8.0
Commit: e5cedcc04921f6f74535cf45668292203e439d45

What's Changed

Other Changes

Read more

Release v0.7.1

Choose a tag to compare

@azchohfi azchohfi released this 01 Oct 22:54

Version: 0.7.1
Commit: e3cd0b94f3e7b776ac51ba0564f4908094e979b5

What's Changed

Other Changes

Full Changelog: v0.7.0...v0.7.1


Installation Options

MSIX Installer (Recommended)

  1. Download winappcli_x64.msix for x64 or winappcli_arm64.msix for ARM64
  2. Double-click to install
  3. Automatically added to PATH

Standalone CLI Binaries

  1. Download winappcli-x64.zip for x64 or winappcli-arm64.zip for ARM64
  2. Extract to your desired location
  3. Add to PATH or run directly: winapp.exe

NPM Package (for Electron or NodeJS)

npm install microsoft-winappcli.tgz

What's Included

  • MSIX installer packages (x64 and ARM64)
  • Standalone CLI binaries (x64 and ARM64)
  • NPM package for NodeJS/Electron integration

Release v0.7.0

Choose a tag to compare

@azchohfi azchohfi released this 24 Sep 01:44

Version: 0.7.0
Commit: 2fdd020c5b7db093e8b3e317b22bdd8135a47e89

What's Changed

Other Changes

Read more

Release v0.6.1

Release v0.6.1 Pre-release
Pre-release

Choose a tag to compare

@azchohfi azchohfi released this 19 Aug 00:22

Version: 0.6.1
Commit: d9a8d0f8ef192fa3ce07febdbe178606ea5fb4f5

Full Changelog: v0.6.0...v0.6.1


Installation Options

MSIX Installer (Recommended)

  1. Download winappcli_x64.msix for x64 or winappcli_arm64.msix for ARM64
  2. Double-click to install
  3. Automatically added to PATH

Standalone CLI Binaries

  1. Download winappcli-x64.zip for x64 or winappcli-arm64.zip for ARM64
  2. Extract to your desired location
  3. Add to PATH or run directly: winapp.exe

NPM Package (for Electron or NodeJS)

npm install microsoft-winappcli.tgz

What's Included

  • MSIX installer packages (x64 and ARM64)
  • Standalone CLI binaries (x64 and ARM64)
  • NPM package for NodeJS/Electron integration

Release v0.6.0

Choose a tag to compare

@azchohfi azchohfi released this 12 Aug 02:16

Version: 0.6.0
Commit: b7494ed3b324d6e378cb17b477f2b1a9729765d0

What's Changed

New Features

Other Changes

New Contributors

Full Changelog: v0.5.0...v0.6.0


Installation Options

MSIX Installer (Recommended)

  1. Download winappcli_x64.msix for x64 or winappcli_arm64.msix for ARM64
  2. Double-click to install
  3. Automatically added to PATH

Standalone CLI Binaries

  1. Download winappcli-x64.zip for x64 or winappcli-arm64.zip for ARM64
  2. Extract to your desired location
  3. Add to PATH or run directly: winapp.exe

NPM Package (for Electron or NodeJS)

npm install microsoft-winappcli.tgz

What's Included

  • MSIX installer packages (x64 and ARM64)
  • Standalone CLI binaries (x64 and ARM64)
  • NPM package for NodeJS/Electron integration

Release v0.5.0

Choose a tag to compare

@azchohfi azchohfi released this 20 Jul 18:27

Version: 0.5.0
Commit: fd7cb6f235fa54dd2c6e26386e65e967a2c8797a

New Features

  • Add ui record command for MP4 capture (#599) — Users can now record app interactions and output them as MP4 files, enhancing the ability to create tutorials and demos directly from winapp CLI.
  • Add ui touch and ui pen commands (#600) — New commands allow for simulation of touch and pen inputs, making it easier to automate scenarios for touch-enabled applications.
  • Add --allow-system-keys to ui send-keys (#603) — This option enables the use of system keys in keyboard simulations, broadening the range of inputs that can be automated in applications.

Breaking Changes

  • Standardize UI coordinate terminology (#660) — The term "app" has been replaced with "screen" in the coordinate definitions. Users should adjust their coordinate references in scripts and documentation to accommodate this change.

Bug Fixes

  • Fix ui send-keys --via send-input silently dropping characters (#657) — This fix ensures all characters are sent accurately, particularly for longer texts, improving automation reliability.
  • Fix ui send-keys --via post-message silently dropping input (#666) — Input handling has been improved to prevent missed key events during automation, enhancing overall functionality.
  • Fix misleading code coverage measurement (#630) — Addresses prior issues with coverage reporting, providing more accurate information for test evaluations.

Documentation

  • Add native PowerShell winget cmdlet to README.md (#594) — Updated documentation now includes guidance for using the native PowerShell winget cmdlet, helping users understand package management more effectively.

Infrastructure

  • Bump the npm_and_yarn group across 1 directory with 2 updates (#675) — This update ensures that the tool benefits from the latest features and fixes available in the npm and Yarn ecosystems.

Installation Options

MSIX Installer (Recommended)

  1. Download winappcli_x64.msix for x64 or winappcli_arm64.msix for ARM64
  2. Double-click to install
  3. Automatically added to PATH

Standalone CLI Binaries

  1. Download winappcli-x64.zip for x64 or winappcli-arm64.zip for ARM64
  2. Extract to your desired location
  3. Add to PATH or run directly: winapp.exe

NPM Package (for Electron or NodeJS)

npm install microsoft-winappcli.tgz

What's Included

  • MSIX installer packages (x64 and ARM64)
  • Standalone CLI binaries (x64 and ARM64)
  • NPM package for NodeJS/Electron integration

Release v0.4.0

Choose a tag to compare

@azchohfi azchohfi released this 25 Jun 17:09

Version: 0.4.0
Commit: 6bcad3ae827f0ecf34773ad5e7dbfe9e1920a712

New Features

  • Integrate JS/TS WinRT bindings (#536) — The winapp init command now supports JavaScript and TypeScript WinRT bindings, enabling developers to manage their projects with these languages directly.
  • Add "ui hover" command (#583) — Introduced a new command ui hover to capture tooltips, flyouts, and other UI elements, enhancing debugging and interaction testing.
  • List visible windows option (#571) — The list windows command now shows visible windows without titles by default and includes a new --show-hidden flag for optional display of all windows.

Bug Fixes

  • Fix cert bug with multi-component publisher validation (#573) — Resolved an issue that prevented proper validation of certificates when multiple components were involved, improving reliability in app submissions.
  • Screenshot command directory creation (#576) — The screenshot command now automatically creates non-existent output directories instead of throwing an error, simplifying the screenshot process.
  • Fix for PoliCheck non-inclusive language findings (#580) — Addressed non-inclusive language issues identified by PoliCheck, enhancing compliance with language standards.

Infrastructure

  • Dependency updates — Bumped multiple dependencies for undici (#584), form-data (#581), markdown-it (#582), js-yaml (#578), and esbuild (#577) to their latest versions, improving overall performance and security.

Installation Options

MSIX Installer (Recommended)

  1. Download winappcli_x64.msix for x64 or winappcli_arm64.msix for ARM64
  2. Double-click to install
  3. Automatically added to PATH

Standalone CLI Binaries

  1. Download winappcli-x64.zip for x64 or winappcli-arm64.zip for ARM64
  2. Extract to your desired location
  3. Add to PATH or run directly: winapp.exe

NPM Package (for Electron or NodeJS)

npm install microsoft-winappcli.tgz

What's Included

  • MSIX installer packages (x64 and ARM64)
  • Standalone CLI binaries (x64 and ARM64)
  • NPM package for NodeJS/Electron integration

Release v0.3.2

Choose a tag to compare

@azchohfi azchohfi released this 03 Jun 00:36
1c6e75e

Version: 0.3.2
Commit: 1c6e75e90f3d0eff890021335261254fa01dd8c7

New Features

  • MSIX Bundle Support for pack Command (#546) — The pack command now supports creating MSIX bundles, streamlining the packaging process for Windows apps.
  • App Update Notification (#503) — A daily check now notifies users of any available updates for the CLI on their first command run each day, ensuring developers stay informed about new versions.
  • Enhanced winapp init Behavior (#530) — Improved project detection and file placement during initialization, along with warnings for incompatible directories, enhances the usability of the init command.
  • Higher quality screenshots for winapp ui screenshot (#522) — Updated ui screenshot command to produce higher quality screenshots, and added support for --focus flag.

Breaking Changes

  • Publishing VSCE Integrated into CI (#499) — The pipeline now includes an automated process for publishing VS Code extensions. Users need to manage the new SkipVscRelease parameter in the pipeline configuration, which defaults to true until they are ready for publishing:
    parameters:
      - name: SkipVscRelease
        displayName: Skip VSC Release
        type: boolean
        default: true

Bug Fixes

  • winapp init Crash Fixed (#559) — Resolved an issue that caused winapp init to crash in non-interactive shells, now default behaviors apply as expected.
  • Removed Duplicates in MSIX Packing (#554) — Fixed a bug where files from the runtime would overwrite existing resources in the final MSIX package.
  • Improved Process Name Ambiguity Reporting (#564) — Fixed issues with reporting ambiguity on partial process name matches, improving command execution reliability.
  • Update Check Timeout Resolved (#558) — Addressed a timeout bug in the update check, allowing for seamless notifications of available updates.

Documentation

  • Automating MS Learn Documentation Updates (#518) — Introduced a new pipeline step to automatically update documentation on Microsoft Learn, ensuring consistency across resources.
  • Enhancements to VS Code Extension Release Documentation (#519) — Improved formatting and clarity in the VS Code extension release process documentation.

Infrastructure

  • Dependency Updates — Updated various dependencies, including qs (#561), @tootallnate/once (#560, #547), brace-expansion (#539), tmp (#553), and fast-uri (#527, #528).

Installation Options

MSIX Installer (Recommended)

  1. Download winappcli_x64.msix for x64 or winappcli_arm64.msix for ARM64
  2. Double-click to install
  3. Automatically added to PATH

Standalone CLI Binaries

  1. Download winappcli-x64.zip for x64 or winappcli-arm64.zip for ARM64
  2. Extract to your desired location
  3. Add to PATH or run directly: winapp.exe

NPM Package (for Electron or NodeJS)

npm install microsoft-winappcli.tgz

What's Included

  • MSIX installer packages (x64 and ARM64)
  • Standalone CLI binaries (x64 and ARM64)
  • NPM package for NodeJS/Electron integration

Release v0.3.1

Choose a tag to compare

@azchohfi azchohfi released this 01 May 19:10
c8ada4a

Version: 0.3.1
Commit: c8ada4a403c43b96780b87abc454cba51f649c60

Breaking Changes

  • winapp ui --json envelope reshape (#511) — JSON output shapes are not backward compatible. Update any scripts/tools parsing these outputs:
    • ui inspect --json — elements are now nested under { depth, interactive, hideDisabled, hideOffscreen, windows: [{ hwnd, title, className, elementCount, elements: [{ ..., children: [...] }] }] } (was a flat { elements: [...] } list). Per-element id, depth, parentSelector, and windowHandle fields have been removed — selector is the public handle.
    • ui inspect --ancestors --json — ancestors are now nested via a Depth=i parent → child chain (previously emitted as sibling roots).
    • ui get-focused --json — emits a { hasFocus: false } or { hasFocus: true, element: {...} } envelope (was a bare null when nothing was focused).
    • ui search --json / ui wait-for --json — internal id, parentSelector, and windowHandle fields are scrubbed from results (top-level and nested invokableAncestor).

New Features

  • winapp run support for -- passthrough arguments (#506) — Pass application arguments directly using -- without escaping them in quotes. For example, instead of:
    winapp run . --args "--my-flag value"
    you can now write:
    winapp run . -- --my-flag value
  • Plain progress streaming in CI and AI-agent terminals (#507) — Auto-detects environments that can't honour cursor control (GitHub Actions, Azure DevOps, Copilot CLI, Claude Code, etc.) and falls back to append-only line-buffered progress output. Real interactive terminals continue to render the animated spinner tree; --quiet / --json remain silent. No new flags or env vars.
  • ui inspect --interactive ancestor surfacing (#511) — Non-interactive ancestors are collapsed and surfaced as ancestorPath on surviving descendants; +more markers indicate truncated subtrees in both text and JSON modes.

Bug Fixes

  • winapp run no longer picks createdump.exe (#496) — Fixed an issue where winapp run could incorrectly select createdump.exe over the intended application executable when multiple .exe files existed. Detection logic is now shared with winapp package.
  • winapp register: accurate error for package-already-exists conflicts (#512) — HRESULT 0x80073CFB was being misreported as a Developer Mode error. The Developer Mode mapping is now correctly scoped to 0x800704EC, and conflicts emit an actionable hint with the real package identity (parsed from the manifest).
  • winapp unregister: safer per-package unregistration (#512) — Fixed two data-loss bugs: a per-package safety check that could be bypassed when multiple packages were classified together, and sibling-directory misclassification caused by a prefix StartsWith containment check. Rewritten as a two-pass classify-then-remove loop with segment-aware path containment.
  • Status output: real exception messages instead of (null) (#512) — Failed operations now surface ex.Message; falls back to "Operation failed without an error message." when no message is available. Stack traces are appended only at Debug log level.
  • NuGet version range parsing on cache-warm runs (#512) — ParseMinimumVersion no longer silently breaks when brackets are pre-stripped (which only manifested after git clean of .winapp while the global NuGet cache still had the package).
  • WinAppSDK 2.0.1 forward compatibility (#512) — Supports the new major-only framework package naming (Microsoft.WindowsAppRuntime.2 instead of Microsoft.WindowsAppRuntime.2.0).

Compliance

  • NuGet package metadata (#489) — Microsoft.Windows.SDK.BuildTools.WinApp now includes a compliant <Copyright> element required by Microsoft NuGet policy.

Installation Options

MSIX Installer (Recommended)

  1. Download winappcli_x64.msix for x64 or winappcli_arm64.msix for ARM64
  2. Double-click to install
  3. Automatically added to PATH

Standalone CLI Binaries

  1. Download winappcli-x64.zip for x64 or winappcli-arm64.zip for ARM64
  2. Extract to your desired location
  3. Add to PATH or run directly: winapp.exe

NPM Package (for Electron or NodeJS)

npm install microsoft-winappcli.tgz

What's Included

  • MSIX installer packages (x64 and ARM64)
  • Standalone CLI binaries (x64 and ARM64)
  • NPM package for NodeJS/Electron integration

Release v0.3.0

Choose a tag to compare

@azchohfi azchohfi released this 22 Apr 06:19

Version: 0.3.0
Commit: f3ce442ddd1ea2aea3ada40a0d7a5a2a411cfe00

New Features

  • winapp run command (#341) — Introduces the winapp run command allowing developers to pack a folder and run their application as a packaged app, streamlining the process of launching packaged applications. Usage example:
    winapp run .\bin\Debug\net10.0-windows10.0.26100.0\win-x64 --manifest .\appxmanifest.xml
  • UI automation with winapp ui (#380) — Adds a new command group for UI automation, enabling programmatic interaction with UI elements in Windows applications using Microsoft UI Automation (UIA). Key commands include ui list-windows, ui inspect, and ui click.

Bug Fixes

  • Fallback in get-winapp-path (#475) — Fixes an issue where the command would fail if the local cache was missing, now gracefully falling back to the global cache.

Installation Options

MSIX Installer (Recommended)

  1. Download winappcli_x64.msix for x64 or winappcli_arm64.msix for ARM64
  2. Double-click to install
  3. Automatically added to PATH

Standalone CLI Binaries

  1. Download winappcli-x64.zip for x64 or winappcli-arm64.zip for ARM64
  2. Extract to your desired location
  3. Add to PATH or run directly: winapp.exe

NPM Package (for Electron or NodeJS)

npm install microsoft-winappcli.tgz

What's Included

  • MSIX installer packages (x64 and ARM64)
  • Standalone CLI binaries (x64 and ARM64)
  • NPM package for NodeJS/Electron integration