CLI de développement d'application Windows (CLI winapp)

Important

L’interface CLI de développement d'applications Windows est actuellement en préversion publique. Les fonctionnalités et les commandes peuvent changer avant la version finale. Partagez vos commentaires en création d’un problème.

L'interface CLI de développement application Windows (winapp CLI) est une interface de ligne de commande unique pour la gestion des SDKs Windows, l'empaquetage, la génération d'identités d'application, des manifestes, des certificats et l'utilisation d'outils de build avec n'importe quel framework d'application. Cet outil permet de combler le fossé entre le développement multiplateforme et les fonctionnalités natives de Windows.

Que vous générez avec .NET/Win32, CMake, Electron ou Rust, cette interface CLI vous donne accès à :

  • API Modern Windows - SDK d'application Windows et Windows SDK avec configuration automatique et génération de code
  • Identité de package - Déboguer et tester en ajoutant l’identité du package sans empaquetage complet
  • Empaquetage MSIX - Empaquetage d’applications avec signature et préparation du Store
  • Developer Tools - Manifestes, certificats, ressources et intégration de build

Pourquoi l’identité du package ?

De nombreuses API Windows puissantes nécessitent que votre application dispose d’une identité de package. Avec l’identité, votre application gagne access aux fonctionnalités telles que les notifications, l’intégration du système d’exploitation et l’IA sur appareil. Pour obtenir la liste complète de ce que l’identité de package déverrouille et aide à choisir le modèle d’empaquetage approprié, consultez Vue d’ensemble de l’empaquetage.

Installation

WinGet

Le moyen le plus simple d’installer l’interface CLI consiste à utiliser WinGet (Windows Gestionnaire de package) :

winget install Microsoft.winappcli --source winget

NPM

Pour les projets Electron, installez via npm :

npm install @microsoft/winappcli --save-dev

GitHub Actions / Azure DevOps

Pour les pipelines CI/CD, utilisez l’action setup-WinAppCli pour installer automatiquement l’interface CLI sur vos exécuteurs/agents.

Téléchargement manuel

Téléchargez la dernière build à partir de GitHub Versions.

Vérifier l’installation

Une fois installé, vérifiez l’installation en appelant l’interface CLI :

winapp --help

Ou si vous utilisez Electron/Node.js:

npx winapp --help

Frameworks pris en charge

Winapp CLI fonctionne avec un large éventail d’infrastructures d’application :

Cadre Guide
.NET / WPF / WinForms Commencez avec .NET
C++ (CMake) Commencez avec C++
Électron Commencez avec Electron
Rust Commencez avec Rust
Tauri Commencez avec Tauri
Flutter Commencer avec Flutter

Guides supplémentaires :

  • Empaquetage d’un EXE/CLI : guide pas à pas pour empaqueter un EXE/CLI existant en tant que MSIX
  • Complétion de shell : activer la complétion par tabulation pour les commandes, les options et les valeurs dans PowerShell, bash, zsh et fish

Vue d’ensemble des commandes

Catégorie Commandes
Installation init, restore, update
Identity &Debugging run, create-debug-identity, unregister
Emballage emballer
Manifestes générer le manifeste, mettre à jour les actifs du manifeste, ajouter un alias au manifeste
Certificats & Signature générer-certificat, installer-certificat, signer, créer-catalogue-externe
Utilities tool, store, get-winapp-path, complete
UI Automation ui
Node.js/Electron node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity

Pour obtenir la référence CLI complète, consultez la référence CLI.

Open source

winapp CLI est open source. Vous pouvez trouver le code source, les problèmes de fichier et contribuer à GitHub.

  • Last updated on