Windows-app Development CLI (winapp CLI)

De Windows-app Development CLI (winapp CLI) is een opdrachtregelprogramma voor het bouwen van Windows apps met het framework dat u kiest. Het werkt vanuit een terminal, de editor die u wilt gebruiken of een AI-coderingsagent.

• WinUI-apps:WinUI-apps maken, uitvoeren, debuggen, testen en verpakken zonder Visual Studio te openen.
• Platformoverschrijdende en andere frameworks: breng Windows functies naar uw bestaande Electron-, Flutter-, Tauri-, Rust-, .NET- of C++-app zonder frameworks te wijzigen. winapp CLI zet de Windows App SDK en Windows SDK op, geeft uw app pakketidentiteit zodat u API's zoals meldingen en AI op het apparaat kunt aanroepen, en verpakt uw app als MSIX voor de Microsoft Store of uw eigen distributie.

Belangrijkste voordelen van winapp CLI

Aan de slag met WinUI

Nadat u winapp CLI en de .NET SDK hebt geïnstalleerd, maakt en voert u een WinUI-app uit:

winapp new --name MyWinUIApp --template winui-navview --use-defaults
cd MyWinUIApp
winapp run

Wanneer u klaar bent om een pakket lokaal te testen, genereert u een ontwikkelingscertificaat en maakt u een ondertekend MSIX-pakket:

winapp cert generate --manifest ./Package.appxmanifest
winapp pack ./MyWinUIApp.csproj -c Release --cert ./devcert.pfx

Het ontwikkelingscertificaat maakt gebruik van een standaardwachtwoord en is alleen bedoeld voor lokaal testen. Voordat u uw app distribueert, moet u deze ondertekenen met een vertrouwd certificaat, bijvoorbeeld met winapp az-sign. Zie Securityvoor meer informatie.

Zie Uw eerste WinUI-app bouwen voor een stapsgewijze procedure met setup en uw eerste wijziging in de gebruikersinterface. Als u alle beschikbare sjablonen wilt zien, voert u de opdracht winapp new --list uit. Zie Winapp CLI gebruiken met WinUI voor de volledige werkstroom, waaronder foutopsporing, UI-automatisering en -pakketten.

Installatie

WinGet

De eenvoudigste manier om de CLI te installeren is via WinGet (Windows Pakketbeheer):

winget install Microsoft.winappcli --source winget

Als u de WinGet PowerShell-module gebruikt, voert u in plaats daarvan Install-WinGetPackage Microsoft.winappcli uit.

NPM

Voor Electron-projecten, installeer via de Node Package Manager (NPM).

npm install @microsoft/winappcli --save-dev

GitHub Actions/Azure DevOps

Voor CI/CD-pipelines gebruikt u de actie setup-WinAppCli om de CLI automatisch te installeren op uw runners/agents.

Handmatig downloaden

Download de nieuwste build van GitHub Releases.

Installatie controleren

Nadat de installatie is geïnstalleerd, controleert u de installatie door de CLI aan te roepen:

winapp --help

Of als u Electron/Node.jsgebruikt:

npx winapp --help

Gebruik winapp CLI met AI-agents

winapp CLI is ontworpen om goed te werken met AI-coderingsagenten. Opdrachten zoals find-ui en find-api geven machineleesbare uitvoer terug met --json, zodat een agent echte WinUI-voorbeelden en Windows Runtime API's kan opzoeken voordat code wordt geschreven.

Installeer de winapp-invoegtoepassing om uw agent vaardigheden te geven voor de winapp CLI-werkstroom:

# GitHub Copilot CLI
copilot plugin install microsoft/WinAppCli

# Claude Code
claude plugin marketplace add microsoft/WinAppCli
claude plugin install winappcli@winappcli

Als u in Visual Studio Code werkt, voert de WinApp VS Code-extensie winapp CLI-opdrachten uit vanuit de editor en start uw app met pakketidentiteit wanneer u op F5 drukt. Installeer deze vanuit de Visual Studio Marketplace.

Ondersteunde frameworks

winapp CLI werkt met WinUI en andere app-frameworks:

Aanvullende handleidingen:

• Een EXE/CLI verpakken: stapsgewijze handleiding voor het verpakken van een bestaande EXE/CLI als MSIX
• Sparse-verpakking: geef een niet-verpakte app een pakketidentiteit met een MSIX met alleen identiteit (sparse) en externe inhoud
• Shell-voltooiing: tabvoltooiing inschakelen voor opdrachten, opties en waarden in PowerShell, bash, zsh en fish
• Beveiligingsrichtlijnen: welke ontwikkelingscertificaten en ontwikkelaarsmodus op uw computer veranderen, hoe u deze kunt afhandelen devcert.pfxen hoe u zich kunt aanmelden voor productie

Overzicht van opdrachten

Zie CLI-handleiding voor de volledige CLI-naslaginformatie.

Samples

De map met voorbeelden op GitHub heeft een runnable project voor elk ondersteund framework:

Waarom pakketidentiteit?

Veel Windows API's vereisen dat uw app pakketidentiteit heeft. Met identiteit krijgt uw app toegang tot functies zoals meldingen, OS-integratie en AI op het apparaat. WinUI-app-sjablonen bevatten een pakketmanifest, dus winapp run geeft ze standaard een identiteit. Zie Het pakketoverzicht voor een volledige lijst van welke pakketidentiteit ontgrendelt en helpt bij het kiezen van het juiste verpakkingsmodel.

Open source

winapp CLI is open source. U kunt de broncode, bestandsproblemen en bijdragen vinden op GitHub. Zie Ondersteuning voor hulp.

Verwante onderwerpen

• Uw eerste WinUI-app bouwen
• Overzicht van WinUI
• CLI-naslaginformatie
• Foutopsporing met pakketidentiteit
• Beveiligingsrichtlijnen
• Automatisering van de gebruikersinterface
• uitvoering van Windows Sandbox
• NPM programmatische API
• Framework handleidingen
• documentatie Windows App SDK
• Documentatie voor MSIX-pakketten