Guida introduttiva: Creare e pubblicare un'app Windows con intelligenza artificiale

In questa guida rapida si parte da una cartella vuota per arrivare a un'app Windows pubblicata, con l'assistenza dell'IA durante tutto il processo. Nessun Visual Studio obbligatorio.

Note

Preferisce lavorare in Visual Studio? Vedere Impostare GitHub Copilot per lo sviluppo Windows. Questa guida introduttiva utilizza VS Code e la CLI di winapp.

  • Installare gli strumenti gratuiti necessari (~5 minuti)
  • Creare un'app WinUI dalla riga di comando
  • Usare l'agente winui-dev di intelligenza artificiale per aggiungere funzionalità
  • Creare un pacchetto e pubblicarlo nel Microsoft Store

Tempo di completamento: circa 30 minuti
Cost: gratuito (GitHub Copilot livello gratuito è sufficiente)

Prerequisiti

Installare gli strumenti seguenti prima di iniziare. Tutti sono gratuiti.

1. Visual Studio Code

winget install Microsoft.VisualStudioCode

2. .NET SDK 10 o versione successiva

winget install Microsoft.DotNet.SDK.10

3. CLI per lo sviluppo di app Windows (winapp CLI)

winget install Microsoft.winappcli --source winget

4. WinUI dotnet nuovi modelli

dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates

5. GitHub CLI (necessario per i comandi gh copilot — richiede un abbonamento a GitHub Copilot, è disponibile un piano gratuito)

winget install GitHub.cli

Important

Chiudere e riaprire il terminale al termine dell'installazione. Il gh comando non sarà disponibile fino a quando una nuova sessione della shell non preleva il percorso aggiornato.

gh auth login
gh extension install github/gh-copilot

6. Plugin WinUI Agent per GitHub Copilot

gh copilot plugin install winui@awesome-copilot

7. Estensione WinApp per VS Code

code --install-extension microsoft-winappcli.winapp

In alternativa, cercare WinApp nel pannello Estensioni (CTRL+MAIUSC+X). Per un riferimento completo dei comandi, vedere strumenti di VS Code.

Verificare la configurazione

winapp --version

Tip

Per ottenere risultati ottimali, connettere anche l'agente di intelligenza artificiale al server Microsoft Learn MCP, recuperando i documenti correnti dell'API WinUI 3 in fase di query anziché basandosi sui dati di training.

Passaggio 1: Creare una nuova app WinUI

Creare una nuova cartella e generare la struttura di un'app WinUI con layout NavigationView:

mkdir MyFirstApp
cd MyFirstApp
dotnet new winui-navview

Passaggio 2: Eseguire l'app

Compilare ed eseguire l'app per verificare che tutto funzioni prima di iniziare ad aggiungere funzionalità:

dotnet run

L'app viene avviata come pacchetto di layout libero: non è necessaria alcuna installazione MSIX. Dovresti vedere un'app WinUI 3 con una NavigationView contenente le pagine Home, Informazioni e Impostazioni:

Schermata di MyFirstApp in esecuzione — una finestra WinUI 3 con un NavigationView che mostra gli elementi Home, About e Settings, con la pagina Home selezionata che visualizza 'Questa è la pagina Home'.

Al termine dell'avvio, aprire il progetto in VS Code:

code .

Note

Non premere F5 prima del primo dotnet run riuscito. Il debugger di VS Code cerca un oggetto .exe che non esiste ancora. Dopo che dotnet run è stato completato correttamente, F5 e il pulsante Esegui nel pannello dell'estensione WinApp funzionano normalmente.

Passaggio 3: Usare l'agente di intelligenza artificiale per aggiungere una funzionalità

In VS Code aprire GitHub Copilot Chat (Ctrl+ALT+I), passare alla modalità Agent e selezionare l'agente winui-dev. Digitare una richiesta, ad esempio:

Add a settings page to my WinUI NavigationView app with a toggle for dark mode

L'agente genera il codice, crea tutti i file necessari e aggiorna la struttura di spostamento. Esaminare le modifiche, quindi verificare il risultato:

dotnet run

Passare alla pagina Impostazioni nell'app in esecuzione per verificare che la funzionalità sia stata aggiunta correttamente.

Tip

Si vuole automatizzare la verifica dell'interfaccia utente? Vedi Testare le app WinUI per winapp ui i comandi che ispezionano, cercano e acquisiscono schermate dell'albero dell'interfaccia utente della tua app, utili per le pipeline CI.

Passaggio 4: Creare un pacchetto dell'app

Pubblicare l'app in una cartella, quindi crearne il pacchetto come programma di installazione MSIX.

Important

Il passaggio di creazione del pacchetto installa un certificato nell'archivio radice attendibile del computer e richiede un terminale con privilegi elevati (amministratore). Fare clic con il pulsante destro del mouse su PowerShell o Terminale Windows e selezionare Esegui come amministratore, quindi tornare alla cartella del progetto.

dotnet publish -o ./publish
winapp pack ./publish --generate-cert --install-cert

--generate-cert --install-cert crea e installa un certificato di sviluppo locale per il test. Per l'invio allo Store, usare invece il certificato del Centro per i partner.

Passaggio 5: Pubblicare nel Microsoft Store

Inviare l'app direttamente dalla riga di comando:

winapp store publish ./*.msix --appId <your-app-id>

Note

La pubblicazione richiede un account del Centro per i partner. La certificazione delle app richiede in genere 1-3 giorni lavorativi.

Passaggi successivi

È stata creata e pubblicata un'app Windows usando solo strumenti gratuiti e assistenza per l'intelligenza artificiale. Ecco dove procedere:

  • Last updated on