Compartir a través de


CLI de desarrollo de aplicaciones de Windows (CLI de winapp)

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:

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.