Introduzione a WinUI

Informazioni iniziali sullo sviluppo di app con WinUI. Questa guida illustra i passaggi necessari per iniziare. Fornirà anche informazioni sulle risorse che aiuteranno a ottenere altre informazioni sullo sviluppo di Windows.

1. Installare Visual Studio

Per creare l'app WinUI, si userà Visual Studio, l'ambiente di sviluppo integrato (integrated development environment, IDE) completo di Microsoft. Si tratta dello strumento di sviluppo preferito di molti sviluppatori Windows e consente di scrivere le app, eseguirne il debug e distribuirle. I modelli di progetto in Visual Studio consentono di avviare rapidamente i progetti per Windows e molte altre piattaforme.

Suggerimento

Prima di installare questi strumenti, assicurarsi che il computer di sviluppo soddisfi i requisiti di sistema per lo sviluppo di app Windows.

Usare questo collegamento per scaricare e installare la versione più recente di Visual Studio. Il programma di installazione descrive i passaggi, ma se sono necessarie istruzioni dettagliate, vedere Installazione di Visual Studio.

Download di Visual Studio

Visual Studio Community Edition in versione gratuita include tutto il necessario per creare le app. Se si collabora con un team o un'azienda di sviluppo, potrebbe essere necessario Visual Studio Professional o Visual Studio Enterprise. Vedere Che cos'è Visual Studio? per altre informazioni.

Carichi di lavoro e componenti richiesti

Durante l'installazione di Visual Studio, occorre installare i carichi di lavoro e i componenti necessari per lo sviluppo con WinUI e Windows App SDK. Dopo l'installazione, è possibile aprire l'applicazione Visual Studio Installer e selezionare Modifica per aggiungere i carichi di lavoro e i componenti.

Nella scheda Carichi di lavoro dell'app Visual Studio Installer, selezionare i carichi di lavoro e i componenti seguenti:

Visual Studio 2022 versione 17.10 e successive

• Per lo sviluppo di app C# con Windows App SDK, selezionare Sviluppo di applicazioni Windows.

• Per lo sviluppo di app C+ con Windows App SDK, selezionare Sviluppo di applicazioni Windows.
  • Quindi, nel riquadro Dettagli installazione, sotto al nodo Sviluppo di applicazioni Windows, selezionare Strumenti di sviluppo di app WinUI C++. (In questo modo verranno selezionati anche tutti i componenti aggiuntivi necessari).

Visual Studio 2022 versioni dalla 17.1 alla 17.9

• Per lo sviluppo di app C# con Windows App SDK, selezionare Sviluppo per desktop .NET.
  • Quindi, nel riquadro Dettagli di installazione della finestra di dialogo di installazione, selezionare Modelli C# Windows App SDK (accanto alla parte inferiore dell'elenco).
• Per lo sviluppo di app C++ con Windows App SDK, selezionare Sviluppo per desktop con C++
  • Quindi, nel riquadro Dettagli della finestra di dialogo di installazione, selezionare Modelli C++ Windows App SDK (nella parte inferiore dell'elenco).
  • Nella scheda Singoli componenti tab della finestra di dialogo di installazione, nella sezione SDK, librerie e framework, assicurarsi di aver selezionato la versione più recente di Windows SDK. Sarà simile a Windows 11 SDK (10.0.22621.0). Per cercarlo più facilmente, digitare "Windows SDK".

2. Abilitare la modalità sviluppatore

Windows offre una modalità speciale per gli sviluppatori che regola le impostazioni di sicurezza per consentire l'esecuzione delle app su cui si sta lavorando. Prima di poter compilare, distribuire e testare un'app con Visual Studio, è necessario abilitare la modalità sviluppatore.

Suggerimento

Se non la si abilita subito, verrà richiesto di abilitarla quando si tenta di compilare l'app in Visual Studio.

Per abilitare la modalità sviluppatore:

• Aprire Impostazioni di Windows Settings e passare alla pagina Sistema > Per sviluppatori.
• Spostare l'interruttore della Modalità sviluppatore su On e confermare la scelta nella finestra di dialogo di conferma.

Per altre informazioni sulla modalità sviluppatore, vedere Abilitare il dispositivo per lo sviluppo.

3. Creazione e avvio della prima app WinUI

I modelli di progetto di Visual Studio includono tutti i file necessari per creare rapidamente un'app. Infatti, una volta creato il progetto da un modello di app WinUI, l'app sarà già eseguibile e le si potrà aggiungere il codice.

Per creare un nuovo progetto usando il modello di progetto C# WinUI:

1. Aprire Visual Studio e selezionare Crea un nuovo progetto dalla pagina di avvio. (Se Visual Studio è già aperto nell'editor, selezionare File>Nuovo>Progetto):

2. Cercare WinUI e selezionare il modello di progetto C# Blank App, Packaged (WinUI 3 in Desktop), quindi fare clic su Avanti:

3. Specificare un nome di progetto, quindi fare clic su Crea. Facoltativamente, è possibile specificare un nome e una directory della soluzione oppure lasciare le impostazioni predefinite. In questa immagine, il progetto Hello World appartiene a una soluzione Hello World, che sarà attiva in C:\Projects\:

4. Fare clic sul pulsante "Avvia" debug per compilare ed eseguire il progetto:
   
   Il progetto Hello World verrà compilato, distribuito nel computer locale ed eseguito in modalità di debug:
   

5. Per arrestare il debug, chiudere la finestra dell'app o fare clic sul pulsante "Arresta" debug in Visual Studio.

4. Eseguire l'aggiornamento alla versione più recente di WinUI/Windows App SDK

Windows App SDK (e WinUI, che ne fa parte) viene distribuito come pacchetto NuGet. Ciò significa che gli aggiornamenti possono essere rilasciati non in sincrono con Windows e Visual Studio. Di conseguenza, il modello di Visual Studio usato per creare il progetto potrebbe non fare riferimento al pacchetto NuGet più recente di Windows App SDK. Per assicurarsi di disporre delle funzionalità e delle correzioni più recenti, è consigliabile aggiornare i pacchetti NuGet ogni volta che si crea un nuovo progetto in Visual Studio.

Per aggiornare il pacchetto NuGet di Windows App SDK per il progetto:

• In Visual Studio, con il progetto caricato, selezionare Strumenti>Gestione pacchetti NuGet>Gestisci pacchetti NuGet per la soluzione....
• Se è disponibile un aggiornamento, verrà visualizzato nella pagina Aggiornamenti. Spuntare la casella accanto all'aggiornamento elencato. (Per includere gli aggiornamenti delle versioni preliminari, spuntare l'opzione "includi versioni preliminari". Per altre informazioni su ciò che è incluso in un aggiornamento, vedere le note sulla versione).
• Fare clic sul pulsante Aggiorna, quindi selezionare Applica nella finestra di dialogo Anteprima modifiche, infine accettare le condizioni di licenza per completare l'installazione dell'aggiornamento.

Ora il progetto usa le funzionalità winUI più recenti disponibili ed è pronto per la personalizzazione.

Passaggi successivi

• Completare un'esercitazione per aggiungere altro codice all'app Hello World.
• Per avere un'idea dell'offerta di WinUI, vedere l'app Raccolta WinUI.

  L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli e delle funzionalità di WinUI 3. Scaricare l'app da Microsoft Store od ottenere il codice sorgente su GitHub

• Altre informazioni sui concetti fondamentali di WinUI.
• Esplorare i principi di Fluent Design.
• Trovare esempi e strumenti per sviluppare app in modo più efficiente.