Nos complace anunciar el avance público de CLI de desarrollo de aplicaciones de Windows (winapp), una nueva herramienta de línea de comandos de código abierto diseñada para simplificar el ciclo de vida de desarrollo de aplicaciones de Windows en una amplia variedad de marcos y cadenas de herramientas.
La CLI de Winapp está diseñada específicamente para marcos multiplataforma y desarrolladores que trabajan fuera de Visual Studio o MSBuild. Ya sea que sea un desarrollador web que crea con Electron, un veterano de C++ que usa CMake o un desarrollador de .NET, Rust o Dart que crea aplicaciones para Windows, la CLI puede simplificar las complejidades del desarrollo de Windows, desde la configuración de su entorno hasta el empaquetado y la distribución. Esto hace que sea mucho más fácil acceder a las API modernas (incluidas las API de IA de Windows, las funciones de seguridad y las integraciones de shell) directamente desde cualquier cadena de herramientas.
El desarrollo de Windows a menudo implica administrar múltiples SDK, crear y editar múltiples manifiestos, generar certificados y navegar por requisitos de paquetes complejos. El objetivo de este proyecto es unificar estas tareas en una única CLI para que pueda concentrarse en crear excelentes aplicaciones en lugar de tener que luchar con la configuración. Si bien la CLI aún está en sus inicios y todavía hay muchos escenarios de desarrollo de Windows en proceso, ahora compartimos esta vista previa pública para aprender del uso en el mundo real, recopilar comentarios y solicitudes de funciones, y centrar nuestras inversiones en las áreas que más importan a los desarrolladores.
He aquí un vistazo a lo que winapp CLI puede hacer por usted.
🛠️ Configurar un entorno de un solo comando
El initEl comando inicia todo su espacio de trabajo. Descarga los paquetes SDK necesarios, genera proyecciones (C++/WinRT para comenzar) y configura su proyecto para el desarrollo. Un proceso que anteriormente requería múltiples pasos manuales propensos a errores ahora es un único comando CLI que maneja la creación de manifiestos y activos, la generación de certificados y la administración de dependencias, lo que le evita configurar manualmente su entorno de desarrollo por proyecto.
Para comenzar, ejecute en la raíz de su proyecto:
> winapp init
Para proyectos compartidos entre varias máquinas o desarrolladores, utilice winapp restorepara recrear el estado del entorno exacto definido en su configuración. Y para entornos CI/CD, use la acción GitHub y Azure DevOps para instalar automáticamente la CLI.
🚀 Entidad de paquete para depuración
Muchas API de Windows modernas (como las API de IA de Windows, seguridad, mensajería, hosts MCP y más) requieren que su aplicación tenga una identidad de paquete. Tradicionalmente, esto significaba que tenía que empaquetar e instalar completamente su aplicación para probar una sola característica, lo que requería múltiples pasos de configuración manuales y detallados, lo que ralentizaba significativamente su bucle interno.
Con la CLI de winapp, puede agregar la identidad del paquete a su ejecutable con un solo comando, de modo que pueda continuar usando el mismo bucle de desarrollador para probar y depurar cualquier código que requiera la identidad del paquete.
Simplemente ejecuta:
> winapp create-debug-identity my-app.exe
Visite nuestros ejemplos y tutoriales para obtener fragmentos sobre cómo integrar este comando en varias cadenas de herramientas para mejorar la experiencia de depuración.
📜 Trabajar con manifiestos y certificados
Crear un appxmanifest.xml válido y configurar un certificado de desarrollo confiable suelen ser obstáculos para los nuevos desarrolladores de Windows. Winapp CLI automatiza esto completamente con inicio comando como se describe anteriormente, pero también expone comandos para crear y administrar directamente certificados de manifiesto y desarrollo.
Genere un nuevo manifiesto basado en su proyecto o ejecutable, actualice los recursos de imagen en su appxmanifest.xml existente a partir de un logotipo existente o cree e instale un certificado de desarrollo autofirmado con un solo comando. Opcionalmente, la CLI puede instalar el certificado de desarrollo localmente para que pueda probar sus paquetes sin configuración adicional.
Utilice p.e. este comando para actualizar todos los recursos de imagen a los que se hace referencia en su appxmanifest.xml desde una imagen determinada en los formatos de imagen correctos:
> winapp manifest update-assets C:\images\my-logo.png
De manera similar, puede usar el siguiente comando al generar un certificado de desarrollo que se puede usar para la autofirma durante la carga y prueba de la página:> winapp cert generate
📦 Empaquetado MSIX simplificado
Cuando esté listo para enviar, empaquetar su aplicación como MSIX está a solo un comando de distancia. La CLI maneja el proceso de empaquetado y firma y produce un paquete listo para almacenar o descargar a partir del resultado de su compilación.> winapp pack ./my-app-files --cert ./devcert.pfx
⚡ Integración electrónica
Para los desarrolladores de Electron, empaquetamos la CLI como un paquete npm y agregamos comandos para unir Node.js con el código nativo de Windows. La CLI puede implementar complementos nativos de C++ o C#, preconfigurados para acceder al SDK de aplicaciones de Windows y al SDK de Windows. Esto hace que sea más fácil que nunca integrar funciones integradas de alto rendimiento o de inteligencia artificial como Phi Silica directamente en su aplicación Electron.
También simplificamos el ciclo de depuración. Con winapp node add-electron-debug-identitypuede inyectar la identidad del paquete directamente en su proceso Electron en ejecución. Esto le permite probar y depurar API que requieren identidad (como las API de IA de Windows) simplemente llamando npm start . Incluso se encarga de iniciar el SDK de la aplicación de Windows por usted, para que pueda concentrarse en su código, no en la plomería. Mire el vídeo a continuación para ver todo esto en acción:
Además, para ayudar a validar la CLI y simplificar el uso de ciertas API, comenzamos a aprovechar la CLI para crear proyecciones experimentales de NodeJS para API como LanguageModel. Consulte nuestro paquete npm @microsoft/winapp-windows-ai para usar las API de IA de Windows directamente desde NodeJS.
Comience hoy
La CLI de desarrollo de aplicaciones de Windows ya está disponible en versión preliminar pública. Visite nuestro repositorio de GitHub para obtener documentación, tutoriales y problemas de archivo.
¡Nos encantaría escuchar tus comentarios!
Cómo empezar:
Instalar a través de WinGet (para uso general):winget install microsoft.winappcli
Instalar a través de npm (para proyectos de Electron):npm install --save-dev @microsoft/winappcli
Consulte nuestras guías de Electron, .NET, C++/CMAKE o Rust para comenzar rápidamente.
¡Feliz codificación!
