Download e funzionamento di winapp, nuovo strumento da riga di comando per sviluppare software Windows.
Microsoft ha annunciato oggi la disponibilità della prima anteprima pubblica di winapp, nuovo tool open source pensato per sviluppare con facilità software compatibile con la piattaforma Windows. Tutto quello che devi sapere è spiegato nel dettaglio qui in basso.
winapp, la CLI per lo sviluppo di app Windows
La CLI winapp è specificamente progettata per framework multipiattaforma e sviluppatori che lavorano al di fuori di Visual Studio o MSBuild. Che si tratti di uno sviluppatore web che lavora con Electron, un veterano di C++ che usa CMake, o uno sviluppatore .NET, Rust o Dart che crea app per Windows, la CLI può semplificare le complessità dello sviluppo Windows: dalla configurazione dell'ambiente alla pacchettizzazione per la distribuzione. Ciò rende significativamente più facile l'accesso alle API moderne, incluse le Windows AI APIs, le funzionalità di sicurezza e le integrazioni della shell, direttamente da qualsiasi toolchain.
Lo sviluppo per Windows comporta spesso la gestione di più SDK, la creazione e la modifica di più manifesti, la generazione di certificati e la gestione di intricati requisiti di pacchettizzazione. L'obiettivo di questo progetto è unificare queste attività in un'unica CLI, permettendo di concentrarsi sulla creazione di grandi app piuttosto che combattere con la configurazione. Sebbene la CLI sia ancora agli inizi e ci siano molti scenari di sviluppo Windows ancora in lavorazione, Microsoft sta condividendo questa anteprima pubblica ora per imparare dall'utilizzo reale, raccogliere feedback e richieste di funzionalità, e concentrare gli investimenti nelle aree che contano di più per gli sviluppatori.
Ecco uno sguardo a ciò che la CLI winapp può offrire.
Configurazione dell'ambiente con un comando
Il comando
init esegue il bootstrap dell'intero spazio di lavoro. Scarica i pacchetti SDK necessari, genera le proiezioni (C++/WinRT per iniziare) e configura il progetto per lo sviluppo. Un processo che in precedenza richiedeva più passaggi manuali soggetti a errori è ora un singolo comando CLI che gestisce la creazione di manifesti e risorse, la generazione di certificati e la gestione delle dipendenze, evitando di dover configurare manualmente l'ambiente di sviluppo per ogni progetto. Per iniziare, nella radice del progetto, eseguire:
winapp init
Per i progetti condivisi su più macchine o sviluppatori, utilizzare winapp restore per ricreare l'esatto stato dell'ambiente definito nella configurazione. E per gli ambienti CI/CD, utilizzare l'azione GitHub e Azure DevOps per installare automaticamente la CLI.
Identità del pacchetto per il debug
Molte moderne API di Windows (come le Windows AI APIs, Sicurezza, Notifiche, MCP Host e altro) richiedono che l'applicazione abbia la Package Identity. Tradizionalmente, questo significava dover pacchettizzare e installare completamente l'app solo per testare una singola funzionalità, richiedendo molteplici passaggi di configurazione manuali e dettagliati, rallentando significativamente il ciclo interno di sviluppo.
Con la CLI winapp, è possibile aggiungere l'identità del pacchetto all'eseguibile con un singolo comando, consentendo di continuare a utilizzare lo stesso ciclo di sviluppo per testare e debuggare qualsiasi codice che richieda la Package Identity.
Basta eseguire:
winapp create-debug-identity my-app.exe
È possibile visitare gli esempi e le guide per snippet su come integrare questo comando in diverse toolchain per una migliore esperienza di debug.
Lavorare con manifesti e certificati
Creare un appxmanifest.xml valido e impostare un certificato di sviluppo affidabile sono spesso ostacoli per i nuovi sviluppatori Windows. La CLI winapp automatizza questo interamente con il comando
init come descritto sopra, ma espone anche comandi per creare e gestire direttamente manifesti e certificati di sviluppo.
È possibile generare un nuovo manifesto basato sul progetto o sull'eseguibile, aggiornare le risorse immagine nel file appxmanifest.xml esistente da un logo esistente, o creare e installare un certificato di sviluppo autofirmato con un singolo comando. La CLI può opzionalmente installare il certificato di sviluppo localmente in modo da poter testare i pacchetti senza configurazioni aggiuntive.
Ad esempio, utilizzare questo comando per aggiornare tutte le risorse immagine referenziate nell'appxmanifest.xml da un'immagine fornita nelle corrette proporzioni:
winapp manifest update-assets C:\images\my-logo.png
Allo stesso modo, per generare un certificato di sviluppo che può essere utilizzato per l'autofirma durante il sideloading e il test, è possibile utilizzare il seguente comando:
winapp cert generate
Pacchettizzazione MSIX semplificata
Quando si è pronti per la distribuzione, pacchettizzare l'applicazione come MSIX richiede solo un comando. La CLI gestisce il processo di pacchettizzazione e firma, producendo un pacchetto pronto per lo store o per il sideloading dall'output della build.
winapp pack ./my-app-files --cert ./devcert.pfx
Integrazione con Electron
Per gli sviluppatori Electron, Microsoft ha pacchettizzato la CLI come pacchetto npm e aggiunto comandi per colmare il divario tra Node.js e il codice nativo Windows. La CLI può creare impalcature per addon nativi C++ o C#, preconfigurati per accedere a Windows App SDK e Windows SDK. Questo rende più facile che mai integrare funzionalità native ad alte prestazioni o capacità AI come Phi Silica direttamente nell'app Electron.
Viene inoltre semplificato il ciclo di debug. Con winapp node add-electron-debug-identity, è possibile iniettare la Package Identity direttamente nel processo Electron in esecuzione. Questo permette di testare e debuggare API che richiedono identità (come le Windows AI APIs) semplicemente chiamando npm start. Gestisce anche il bootstrap del Windows App SDK, in modo che ci si possa concentrare sul codice, senza preoccuparti dell'installazione. Guarda il video qui sotto per vedere tutto questo in azione:
Inoltre, per aiutare a validare la CLI e semplificare l'utilizzo di certe API, è stato iniziato l'utilizzo della CLI per costruire proiezioni sperimentali NodeJS per API come LanguageModel. È possibile controllare il pacchetto npm @microsoft/winapp-windows-ai per utilizzare le Windows AI APIs direttamente da NodeJS.
Inizia oggi stesso
La CLI per lo sviluppo di app Windows è disponibile ora in anteprima pubblica. Visitare il repository GitHub per documentazione, guide e per segnalare problemi.
Microsoft desidera ricevere feedback!
Per iniziare:
Installare tramite WinGet (per uso generale):
winget install microsoft.winappcli
Installare tramite npm (per progetti Electron):
npm install --save-dev @microsoft/winappcli
Consultare le guide Electron, .NET, C++/CMAKE, o Rust per iniziare rapidamente. Trovi tutti i link alle ulteriori risorse utili nell'annuncio ufficiale di Microsoft qui.
