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. 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. 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

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.

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.