Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Importante
La CLI de desarrollo de Windows App se encuentra actualmente en public preview. Las características y comandos pueden cambiar antes de la versión final. Comparta sus comentarios creando una incidencia.
La CLI de desarrollo de aplicaciones de Windows (CLI de winapp) es una interfaz de línea de comandos unificada para administrar los SDK de Windows, empaquetar, generar identidades de aplicación, manifiestos, certificados y usar herramientas de compilación con cualquier marco de aplicación. Esta herramienta puentea la brecha entre el desarrollo multiplataforma y las funcionalidades nativas de Windows.
Ya sea que estés trabajando con .NET/Win32, CMake, Electron o Rust, esta CLI te da acceso a:
- APIs modernas de Windows - Windows App SDK y Windows SDK con configuración automática y generación de código
- Identidad del paquete: depuración y prueba mediante la adición de la identidad del paquete sin empaquetado completo
- Empaquetado MSIX - empaquetado de aplicaciones con firma y preparación para el Store
- Developer Tools: manifiestos, certificados, recursos e integración de compilación
¿Por qué la identidad del paquete?
Muchas APIs de Windows potentes requieren que su aplicación tenga identidad de paquete, lo que le permite hacer uso de los componentes del sistema operativo que Windows ofrece y a los cuales no tendría acceso de otro modo. Con la identidad, la aplicación obtiene acceso a características como las notificaciones, la integración del sistema operativo y la inteligencia artificial en el dispositivo.
Ejemplos de lo que desbloquean la identidad del paquete y el empaquetado MSIX:
- Administración de notificaciones y notificaciones nativas interactivas
- Integración con el Explorador de Windows, la Barra de Tareas, la hoja para compartir y otras superficies de la interfaz de shell
-
Controladores de protocolo (
yourapp://URI) - INTELIGENCIA ARTIFICIAL en el dispositivo (LLM local, API de IA de texto e imagen)
- Tareas en segundo plano (se ejecutan cuando se cierra la aplicación)
- Asociaciones de tipo de archivo
- Instalación/desinstalación limpia y actualizaciones automáticas
Installation
WinGet
La manera más fácil de instalar la CLI es a través de WinGet (Windows Package Manager):
winget install Microsoft.winappcli --source winget
NPM
Para proyectos de Electron, instale mediante NPM.
npm install @microsoft/winappcli --save-dev
GitHub Actions/Azure DevOps
Para las canalizaciones de CI/CD, use la acción setup-WinAppCli para instalar automáticamente la CLI en los runners o agentes.
Descarga manual
Descargue la compilación más reciente de GitHub Releases.
Comprobación de la instalación
Una vez instalado, compruebe la instalación llamando a la CLI:
winapp --help
O bien, si usa Electron/Node.js:
npx winapp --help
Marcos admitidos
La CLI de winapp funciona con una variedad de marcos de trabajo de aplicaciones:
| Marco de referencia | Guía |
|---|---|
| .NET/WPF/WinForms | Empiece con .NET |
| C++ (CMake) | Empieza con C++ |
| Electrón | Comienza con Electron |
| Óxido | Comienza con Rust |
| Tauri | Comienza con Tauri |
| Flutter | Empieza con Flutter |
Introducción a los comandos
| Categoría | Commands |
|---|---|
| Setup | init, restore, update |
| Embalaje | pack, create-debug-identity |
| Manifiestos | generar manifiesto, actualizar activos de manifiesto |
| Certificados y firma | generar certificado, instalar certificado, firmar |
| Utilities | tool, store, get-winapp-path |
| Node.js/Electron | node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity |
Para obtener la referencia completa de la CLI, consulte Referencia de la CLI.
Open source
La CLI de winapp está open source. Puede encontrar el código fuente, los problemas de archivo y contribuir en GitHub.