Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
L'interface CLI de développement Windows App 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 Windows App (interface CLI winapp) est une interface de ligne de commande unique permettant de gérer les kits SDK Windows, l’empaquetage, la génération d’identités d’application, les manifestes, les certificats et l’utilisation d’outils de génération avec n’importe quelle infrastructure d’application. Cet outil permet de combler le fossé entre le développement multiplateforme et les fonctionnalités natives windows.
Que vous générez avec .NET/Win32, CMake, Electron ou Rust, cette interface CLI vous donne access à :
- API Windows modernes - Windows App SDK et Kit de développement logiciel (SDK) Windows 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 puissantes de Windows nécessitent que votre application dispose d'une identité du package, ce qui vous permet ainsi de tirer parti des composants du système d'exploitation offerts par Windows auxquels vous n'auriez pas autrement accès. 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.
Exemples de ce que l'identité de package et l'empaquetage MSIX permettent de débloquer :
- Notifications natives interactives et gestion des notifications
- Intégration à l’Explorateur Windows, à la barre des tâches, à la feuille de partage et à d’autres surfaces de l'interface utilisateur
-
Gestionnaires de protocole (
yourapp://URI) - IA sur appareil (API de LLM local, API d'IA locales pour texte et image)
- Tâches en arrière-plan (exécutées lorsque l’application est fermée)
- Associations de types de fichiers
- Nettoyer l’installation/désinstaller et les mises à jour automatiques
Installation
WinGet
Le moyen le plus simple d’installer l’interface CLI consiste à utiliser WinGet (Windows Package Manager) :
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 |
Vue d’ensemble des commandes
| Catégorie | Commandes |
|---|---|
| Installation | init, restore, update |
| Emballage | pack, create-debug-identity |
| Manifestes | manifest generate, manifest update-assets |
| Certificats & Signature | Générer un certificat, installer un certificat, signer |
| Utilities | tool, store, get-winapp-path |
| 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.
Rubriques connexes
Windows developer