Vývojové rozhraní příkazového řádku aplikace pro Windows (winapp CLI)

Důležité

Rozhraní příkazového řádku pro vývoj aplikací pro Windows je aktuálně ve verzi veřejná ukázka. Funkce a příkazy se můžou před finální verzí změnit. Podělte se o svůj názor vytvářením problému.

Rozhraní příkazového řádku pro vývoj aplikací pro Windows (winapp CLI) je jednotné rozhraní příkazového řádku pro správu SDKs pro Windows, balení, generování identity aplikací, manifestů, certifikátů a používání nástrojů pro sestavení s libovolným frameworkem aplikace. Tento nástroj překlenuje mezeru mezi možnostmi vývoje napříč platformami a Windows nativními funkcemi.

Ať už vytváříte aplikace v .NET/Win32, CMake, Electron nebo Rust, toto rozhraní příkazového řádku vám poskytuje přístup k:

  • Modern Windows API - Windows App SDK a Windows SDK s automatickým nastavením a generováním kódu
  • Identita balíčku – Ladění a testování přidáním identity balíčku bez úplného balení
  • Balení MSIX – Balení aplikací s připraveností pro podepisování a Store
  • Developer Tools – manifesty, certifikáty, zdroje a integrační sestavení

Proč identita balíčku?

Řada výkonných rozhraní API Windows vyžaduje, aby vaše aplikace měla identitu balíčku. Díky identitě získá vaše aplikace access k funkcím, jako jsou oznámení, integrace operačního systému a AI na zařízení. Úplný seznam toho, co identita balíčku odemkne, a pomoc s výběrem správného modelu balení, najdete v tématu Přehled balení.

Instalace

WinGet

Nejjednodušší způsob instalace rozhraní příkazového řádku je přes WinGet (Windows Správce balíčků):

winget install Microsoft.winappcli --source winget

NPM

Pro projekty Electron nainstalujte prostřednictvím NPM:

npm install @microsoft/winappcli --save-dev

GitHub Actions / Azure DevOps

Pro pipelines CI/CD použijte akci setup-WinAppCli k automatické instalaci rozhraní příkazového řádku na spouštěče nebo agenty.

Ruční stažení

Stáhněte si nejnovější build z GitHub release.

Ověření instalace

Po instalaci ověřte instalaci voláním rozhraní příkazového řádku:

winapp --help

Nebo pokud používáte elektron/Node.js:

npx winapp --help

Podporované architektury

Rozhraní příkazového řádku winapp funguje s různými architekturami aplikací:

.NET Framework Guide
.NET / WPF (Windows Presentation Foundation) / WinForms Začněte s .NET
C++ (CMake) Začínáme s C++
Elektron Začněte s Electronem
Rust Začněte s Rustem
Tauri Začněte s Tauri
Třepetat Začněte s Flutterem

Další příručky:

  • Balení EXE/CLI: podrobný průvodce balením existujícího EXE/CLI jako MSIX
  • Doplňování příkazů: Povolení doplňování pro příkazy, možnosti a hodnoty v PowerShellu, bash, zsh a fish.

Přehled příkazů

Kategorie Příkazy
Setup init, restore, update
Ladění a identity run, create-debug-identity, unregister
Balení balíček
Manifesty generování manifestu, manifest aktualizace prostředků, manifest přidání aliasu
Certifikáty a podepisování generovat certifikát, instalovat certifikát, podepsat, vytvořit externí katalog
nástrojů tool, store, get-winapp-path, complete
automatizace uživatelského rozhraní Ui
Node.js/Elektron node create-addon, node add-elektron-debug-identity, node clear-elektron-debug-identity

Úplné referenční informace k rozhraní příkazového řádku najdete v referenčních informacích k rozhraní příkazového řádku.

Otevřený zdrojový kód

Příkazový řádek CLI winapp je otevřený zdroj. Zdrojový kód, problémy se soubory a přispívání na GitHub.