· · 2 minut czytania

Windows App Dev CLI v0.3: F5 z terminala i UI Automation dla agentów

Windows App Development CLI v0.3 przynosi winapp run do uruchamiania i debugowania z terminala, winapp ui do automatyzacji interfejsu oraz nowy pakiet NuGet umożliwiający działanie dotnet run z zapakowanymi aplikacjami.

windows dotnet winui wpf developer-tools cli ai
Ten post jest dostępny również w:English, Català, Español, Deutsch, Français, Português, Italiano, 日本語, 中文, 한국어, Русский, हिन्दी, Türkçe, العربية, Bahasa Indonesia, Nederlands

Ten artykuł został przetłumaczony automatycznie. Aby zobaczyć oryginał, kliknij tutaj.

Doświadczenie F5 w Visual Studio jest świetne. Ale otwieranie VS tylko po to, żeby uruchomić i debugować zapakowaną aplikację Windows — czy to w potoku CI, zautomatyzowanym workflowie, czy gdy agent AI wykonuje testy — to zbędny narzut.

Windows App Development CLI v0.3 właśnie wyszło i rozwiązuje ten problem bezpośrednio dzięki dwóm głównym funkcjom: winapp run i winapp ui.

winapp run: F5 z dowolnego miejsca

winapp run przyjmuje folder niezapakowanej aplikacji i manifest, wykonując wszystko, co VS robi przy uruchamianiu debugowania: rejestruje luźny pakiet, uruchamia aplikację i zachowuje LocalState między ponownymi deploymentami.

# Zbuduj aplikację, a następnie uruchom ją jako zapakowaną aplikację
winapp run ./bin/Debug

Działa dla WinUI, WPF, WinForms, Console, Avalonia i innych. Tryby są zaprojektowane zarówno dla deweloperów, jak i zautomatyzowanych workflowów:

  • --detach: Uruchamia i natychmiast zwraca kontrolę do terminala. Idealny dla CI.
  • --unregister-on-exit: Usuwa zarejestrowany pakiet przy zamknięciu aplikacji.
  • --debug-output: Przechwytuje komunikaty OutputDebugString i wyjątki w czasie rzeczywistym.

Nowy pakiet NuGet: dotnet run dla zapakowanych aplikacji

Dla deweloperów .NET jest nowy pakiet NuGet: Microsoft.Windows.SDK.BuildTools.WinApp. Po instalacji dotnet run obsługuje cały inner loop: budowanie, przygotowanie pakietu loose-layout, rejestrację w Windows i uruchomienie — wszystko w jednym kroku.

winapp init
# lub
dotnet add package Microsoft.Windows.SDK.BuildTools.WinApp

winapp ui: UI Automation z wiersza poleceń

To funkcja otwierająca scenariusze agentyczne. winapp ui zapewnia pełny dostęp UI Automation do dowolnej działającej aplikacji Windows — WPF, WinForms, Win32, Electron, WinUI3 — bezpośrednio z terminala.

Co można robić:

  • Wylistować wszystkie okna najwyższego poziomu
  • Nawigować po pełnym drzewie UI Automation dowolnego okna
  • Wyszukiwać elementy po nazwie, typie lub ID automatyzacji
  • Klikać, wywoływać i ustawiać wartości
  • Robić zrzuty ekranu
  • Czekać na pojawienie się elementów — idealne do synchronizacji testów

Połączenie winapp ui z winapp run daje kompletny workflow build → uruchomienie → weryfikacja z terminala. Agent może uruchomić aplikację, sprawdzić stan UI, programowo z nią interagować i zwalidować wynik.

Inne nowości

  • winapp unregister: Usuwa sideloadowany pakiet po zakończeniu pracy.
  • winapp manifest add-alias: Dodaje alias do uruchamiania aplikacji po nazwie z terminala.
  • Uzupełnianie tabulatorem: Jedno polecenie do skonfigurowania uzupełniania w PowerShell.

Jak zdobyć

winget install Microsoft.WinAppCli
# lub
npm install -g @microsoft/winappcli

CLI jest w publicznym podglądzie. Pełna dokumentacja dostępna w repozytorium GitHub, a wszystkie szczegóły w oryginalnym ogłoszeniu.

Udostępnij:
Zobacz kod źródłowy tego posta na GitHub ↗
← azd + GitHub Copilot: Konfiguracja projektu z AI i inteligentne rozwiązywanie błędów
Hooki azd w Python, TypeScript i .NET: koniec ze skryptami shell →