Condividi tramite

interfaccia della riga di comando per lo sviluppo di app di Windows (winapp CLI)

Importante

L'interfaccia della riga di comando app di Windows Development è attualmente disponibile in public preview. Le funzionalità e i comandi possono cambiare prima della versione finale. Condividi il feedback segnalando un problema.

La CLI di sviluppo app di Windows (winapp CLI) è un'interfaccia a riga di comando unificata per gestire gli SDK di Windows, creare pacchetti, generare identità dell'app, manifesti, certificati e utilizzare strumenti di compilazione con qualsiasi framework di app. Questo strumento consente di colmare il divario tra lo sviluppo multipiattaforma e le funzionalità native di Windows.

Indipendentemente dal fatto che si stia creando con .NET/Win32, CMake, Electron o Rust, questa interfaccia della riga di comando consente di accedere a:

  • API Windows Moderne - SDK per app di Windows e Windows SDK con installazione e generazione automatica del codice
  • Identità del pacchetto - Effettuare il debug e il test aggiungendo l'identità del pacchetto senza una confezione completa
  • Confezionamento MSIX - Confezionamento di pacchetti di app con firma e prontezza per lo Store
  • Developer Tools - Manifesti, certificati, asset e integrazione della compilazione

Perché l'identità del pacchetto?

Molte API Windows potenti richiedono che l'app disponga dell'identità del pacchetto. Con l'identità, l'app ottiene accesso a funzionalità come notifiche, integrazione di sistema operativo e intelligenza artificiale sul dispositivo. Per un elenco completo di ciò che sblocca l'identità del pacchetto e per aiutarti a scegliere il modello di packaging più adatto, vedere Panoramica della creazione di pacchetti.

Installazione

WinGet

Il modo più semplice per installare l'interfaccia della riga di comando è tramite WinGet (Windows Gestione pacchetti):

winget install Microsoft.winappcli --source winget

NPM

Per i progetti Electron, installare tramite NPM:

npm install @microsoft/winappcli --save-dev

GitHub Actions/Azure DevOps

Per le pipeline CI/CD, utilizzare l'azione setup-WinAppCli per installare automaticamente la CLI sui runner/agenti.

Download manuale

Scaricare la build più recente da GitHub Releases.

Verifica l'installazione

Dopo l'installazione, verificare l'installazione chiamando l'interfaccia della riga di comando:

winapp --help

Oppure, se stai utilizzando Electron/Node.js:

npx winapp --help

Framework supportati

L'interfaccia della riga di comando di winapp funziona con un'ampia gamma di framework di app:

Struttura Guida
.NET/macchine virtuali Windows/WinForms Introduzione a .NET
C++ (CMake) Inizia con C++
Elettrone Inizia con Electron
Rust Inizia con Rust
Tauri Inizia con Tauri
Flutter Inizia con Flutter

Panoramica dei comandi

Categoria Comandi
Setup init, ripristino, aggiornamento
Imballaggio pack, create-debug-identity
Manifesti manifest generate (generare manifest), manifest update-assets (aggiornare asset del manifest)
Certificati e firma Generazione del certificato, installazione del certificato, firma
utilità tool, store, get-winapp-path
Node.js/Electron node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity

Per la documentazione completa della CLI, vedere riferimento CLI.

Open source

L'interfaccia della riga di comando di winapp è open source. È possibile trovare il codice sorgente, i problemi relativi ai file e contribuire a GitHub.

  • Last updated on