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

Importante

La CLI de desarrollo de Aplicación de Windows 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 (winapp CLI) es una interfaz de línea de comandos única para administrar SDKs de Windows, empaquetamiento, generación de identidades de aplicaciones, manifiestos, certificados y uso de herramientas de compilación con cualquier marco de aplicaciones. Esta herramienta puentea la brecha entre el desarrollo multiplataforma y las funcionalidades nativas de Windows.

Tanto si va a compilar con .NET/Win32, CMake, Electron o Rust, esta CLI le proporciona acceso a:

  • APIs modernas de Windows - SDK de Aplicaciones para Windows 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 API de Windows eficaces requieren que la aplicación tenga la identidad del paquete. Gracias a la identidad, tu aplicación obtiene acceso a funciones como las notificaciones, la integración del sistema operativo y la inteligencia artificial en el dispositivo. Para obtener una lista completa de qué identidad de paquete desbloquea y ayuda a elegir el modelo de empaquetado adecuado, consulte Introducción al empaquetado.

Installation

WinGet

La manera más fácil de instalar la CLI es a través de WinGet (Windows Administrador de paquetes):

winget install Microsoft.winappcli --source winget

NPM

Para proyectos de Electron, instale mediante NPM.

npm install @microsoft/winappcli --save-dev

Acciones de GitHub/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 Comienza con .NET
C++ (CMake) Empieza con C++
Electrón Comienza con Electron
Óxido Comienza con Rust
Tauri Comienza con Tauri
Flutter Empieza con Flutter

Guías adicionales:

Introducción a los comandos

Categoría Commands
Setup init, restore, update
Identidad y depuración run, create-debug-identity, unregister
Embalaje empaquetar
Manifiestos generar manifiesto, actualizar-activos del manifiesto, agregar-alias al manifiesto
Certificados y firma generar certificado, instalar certificado, firmar, crear-catálogo-externo
Utilities tool, store, get-winapp-path, complete
Automatización de interfaz de usuario ui
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.

Código Abierto

La CLI de winapp está código abierto. Puede encontrar el código fuente, los problemas de archivo y contribuir en GitHub.