Creare la prima app WinUI

Creare la prima app WinUI e vederla venire in vita su Windows. Questa guida rapida ti porta dalla configurazione degli strumenti a un'app in esecuzione, quindi illustra il tuo primo aggiornamento dell'interfaccia.

Prima di iniziare

Cosa imparerai

  • Scegliere e configurare gli strumenti di sviluppo.
  • Creare ed eseguire un'app WinUI.
  • Aggiorna l'interfaccia e visualizza la modifica nell'app in esecuzione.

Scegliere gli strumenti di sviluppo

Segui uno dei percorsi consigliati in questa guida rapida:

  • winapp CLI: Lavora da un terminale nel tuo editor preferito. Questo flusso di lavoro da riga di comando funziona anche bene per la codifica agentic.
  • Visual Studio: Usa un'esperienza integrata di sviluppo e debug.

Se gli strumenti sono già installati, vai a Creazione della prima app.

Installazione degli strumenti

  1. Attiva Modalità sviluppatore. Puoi aprire le sue impostazioni con Impostazioni sviluppatore.

  2. Installare .NET 10 SDK e app di Windows Development CLI. Se si utilizza WinGet, eseguire:

    winget install --id Microsoft.DotNet.SDK.10 --exact --source winget
winget install --id Microsoft.WinAppCLI --exact --source winget

    Ignorare un'installazione se lo strumento necessario è già installato.

  3. Aprire un nuovo terminale in modo che carichi i comandi installati, quindi controllare le versioni:

    dotnet --version
winapp --version

    Usa .NET SDK 10 o versione successiva e winapp CLI 0.6 o versione successiva per questo workflow.

Note

winapp CLI è disponibile in anteprima pubblica. winapp newgestisce i modelli di progetto WinUI, ma non installa .NET SDK. Consulta l'annuncio di CLI 0.6 per il nuovo progetto e i comandi di esecuzione.

Creare la tua prima app

Usa il flusso di lavoro installato in precedenza per creare e avviare il progetto.

Da una cartella in cui si mantengono i progetti, eseguire:

winapp new --name MyWinUIApp --template winui --use-defaults
cd MyWinUIApp
winapp run

winapp new crea l'app WinUI vuota. winapp run compila il progetto e lo avvia; non è necessario un comando separato di compilazione o di registrazione del pacchetto.

L'app apre una finestra sul desktop. Continua con Apporta una modifica qui sotto.

Apportare una modifica

Mantieni il progetto appena creato. Aggiungere un messaggio all'interfaccia esistente:

  1. Chiudere l'app in esecuzione. Aprire MainPage.xaml nell'editor. Se il modello non contiene quel file, apri invece MainWindow.xaml.

  2. Trovare il pannello di layout che contiene il contenuto dell'app. Nel modello CLI vuoto corrente, MainPage.xaml contiene un elemento <Grid /> vuoto. Sostituire la griglia vuota con:

    <Grid>
    <TextBlock
        Text="Hello, WinUI!"
        HorizontalAlignment="Center"
        VerticalAlignment="Center" />
</Grid>

    Se il pannello contiene già controlli, aggiungere solo all'interno TextBlock di tale pannello. Mantenere i controlli, i nomi e i gestori eventi esistenti. Non sostituire l'elemento circostante Page o Windowo la cornice e la barra del titolo in MainWindow.xaml.

  3. Salva il file. Eseguire winapp run di nuovo dalla cartella del progetto oppure premere F5 in Visual Studio.

Congratulazioni! Hai creato, eseguito e aggiornato la prima app WinUI. La finestra ora visualizza Hello, WinUI!

Troubleshooting

Problema Controlli da eseguire
winapp o dotnet non viene riconosciuto. Riaprire il terminale dopo l'installazione. Usare i comandi di versione nella scheda interfaccia della riga di comando per verificare che entrambi gli strumenti siano disponibili.
winapp new non viene riconosciuto. Questo flusso di lavoro richiede winapp CLI versione 0.6 o successiva. Aggiornare l'interfaccia della riga di comando usando il metodo di installazione scelto.
I modelli WinUI non vengono visualizzati in Visual Studio. Apri Visual Studio Installer, seleziona Modifica e verifica che sia installato il carico di lavoro Sviluppo di applicazioni WinUI. Riavvia Visual Studio successivamente.
La compilazione segnala un errore dell'SDK o di ripristino. Controllare i prerequisiti del flusso di lavoro selezionato e il primo errore nell'output di compilazione. Usare SDK per app di Windows supporto per controllare i requisiti di versione prima di modificare le proprietà del progetto.
La distribuzione dell'app segnala che la Modalità sviluppatore è disabilitata. Abilitare la modalità sviluppatore, quindi eseguire di nuovo l'app.
Il nuovo messaggio non viene visualizzato. Salvare il file XAML e riavviare il progetto. Nei modelli con un MainPage.xaml, aggiungere il messaggio a quella pagina anziché sostituire il frame di hosting della finestra.

Passaggi successivi

Crea un'app per prendere appunti

L'esercitazione Note usa un progetto separato WinUINotes per insegnare pagine, navigazione, data binding e archiviazione locale. Puoi anche trovare esempi specifici di controlli in Risorse.

  • Last updated on