Creare la prima app

In questa esercitazione si apprenderà come creare ed eseguire la prima app .NET Multipiattaforma app (.NET MAUI) in Visual Studio 2022 in Windows o Visual Studio 2022 per Mac.

Prerequisiti

  • Visual Studio 2022 17.3 o versione successiva, con il carico di lavoro dell'interfaccia utente dell'app multipiattaforma .NET installato. Per altre informazioni, vedere Installazione.

Creare un'app

In questa esercitazione si creerà la prima app MAUI .NET in Visual Studio 2022 ed eseguirla in un emulatore Android:

Lo sviluppo di app .NET MAUI per iOS in Windows richiede un host di compilazione Mac. Se non è necessario specificamente puntare a iOS e non si ha un Mac, prendere in considerazione l'introduzione ad Android o Windows.

In questa esercitazione si creerà la prima app .NET MAUI in Visual Studio ed eseguirla in un simulatore iOS:

In questa esercitazione si creerà la prima app MAUI .NET in Visual Studio 2022 ed eseguirla in Windows:

  1. Avviare Visual Studio 2022 e nella finestra iniziale fare clic su Crea un nuovo progetto per creare un nuovo progetto :

    Nuova soluzione.

  2. Nella finestra Crea un nuovo progetto selezionare MAUI nell'elenco a discesa Tutti i tipi di progetto , selezionare il modello di app .NET MAUI e fare clic sul pulsante Avanti :

    Scegliere un modello.

  3. Nella finestra Configura il nuovo progetto assegnare un nome al progetto, scegliere un percorso appropriato e fare clic sul pulsante Avanti :

    Configurare il progetto.

  4. Nella finestra Informazioni aggiuntive scegliere la versione di .NET di destinazione e fare clic sul pulsante Crea :

    Informazioni aggiuntive.

  5. Attendere che il progetto venga creato e che le relative dipendenze vengano ripristinate:

    Dipendenze ripristinate.

  1. Nella barra degli strumenti di Visual Studio usare l'elenco a discesa Destinazione debug per selezionare Emulatori Android e quindi la voce Emulatore Android :

    Selezionare la destinazione di debug dell'emulatore Android per .NET MAUI.

  2. Nella barra degli strumenti di Visual Studio premere il pulsante Emulatore Android :

    Pulsante dell'emulatore Android.

    Visual Studio inizierà a installare Android SDK predefinito e Android Emulator.

  3. Nella finestra Android SDK - Contratto di licenza premere il pulsante Accetta :

    Prima finestra del Contratto di licenza di Android SDK.

  4. Nella finestra Android SDK - Contratto di licenza premere il pulsante Accetta :

    Seconda finestra contratto di licenza di Android SDK.

  5. Nella finestra di dialogo Controllo account utente premere il pulsante :

    Finestra di dialogo di controllo dell'account utente della licenza di Android SDK.

  6. Nella finestra Accettazione licenze premere il pulsante Accetta :

    Finestra della licenza del dispositivo Android.

    Attendere che Visual Studio scarica Android SDK e Android Emulator.

  7. Nella barra degli strumenti di Visual Studio premere il pulsante Emulatore Android :

    Pulsante dell'emulatore Android.

    Visual Studio inizierà a creare un emulatore Android predefinito.

  8. Nella finestra di dialogo Controllo account utente premere il pulsante :

    Finestra di dialogo di controllo dell'account utente di Android Gestione dispositivi.

  9. Nella finestra Nuovo dispositivo premere il pulsante Crea :

    Nuova finestra dispositivo Android.

    Attendere che Visual Studio download, decomprima e crei un emulatore Android.

  10. Chiudere la finestra di Gestione dispositivi Android:

    Finestra di Gestione dispositivi Android.

  11. Nella barra degli strumenti di Visual Studio premere il pulsante Pixel 5 - API 30 (Android 11.0 - API 30) per compilare ed eseguire l'app:

    Pulsante dell'emulatore dell'API Pixel 5 30.

    Visual Studio avvia l'emulatore Android, compila l'app e distribuisce l'app nell'emulatore.

    Avviso

    L'accelerazione hardware deve essere abilitata per ottimizzare le prestazioni dell'emulatore Android. Non è possibile eseguire questa operazione con l'emulatore in esecuzione molto lentamente. Per altre informazioni, vedere Come abilitare l'accelerazione hardware con emulatori Android (Hyper-V & HAXM).

  12. Nell'app in esecuzione nell'emulatore Android premere il pulsante Click me più volte e osservare che il numero di clic del pulsante viene incrementato.

    App in esecuzione nell'emulatore Android.

Risoluzione dei problemi

Se l'app non riesce a compilare, vedere Risoluzione dei problemi noti, che potrebbero avere una soluzione al problema. Se il problema è correlato all'emulatore Android, vedere Risoluzione dei problemi dell'emulatore Android.

  1. Nella barra degli strumenti di Visual Studio usare l'elenco a discesa Destinazione debug per selezionare Framework e quindi la voce net6.0-windows :

    Selezionare la destinazione di debug del computer Windows per .NET MAUI.

  2. Nella barra degli strumenti di Visual Studio premere il pulsante Computer Windows per compilare ed eseguire l'app:

    Eseguire l'app .NET MAUI nel pulsante Visual Studio.

    Se non è stata abilitata la modalità sviluppatore, Visual Studio richiederà di abilitarlo. Nella finestra di dialogo Abilita modalità sviluppatore per Windows fare clic su impostazioni per gli sviluppatori per aprire l'app Impostazioni:

    Abilitare la finestra di dialogo Modalità sviluppatore di Windows.

    Nell'app Impostazioni attivare la modalità sviluppatore e accettare la dichiarazione di responsabilità:

    Attiva la modalità sviluppatore nell'app impostazioni Windows 11.

    Chiudere l'app Impostazioni e quindi chiudere la finestra di dialogo Abilita modalità sviluppatore per Windows .

  3. Nell'app in esecuzione premere il pulsante Click me più volte e osservare che il numero di clic del pulsante viene incrementato:

    App .NET MAUI in esecuzione in Windows.

Risoluzione dei problemi

Se l'app non riesce a compilare, vedere Risoluzione dei problemi noti, che potrebbero avere una soluzione al problema.

  1. In Visual Studio associare l'IDE a un host di Compilazione Mac. Per altre informazioni, vedere Associare a Mac per lo sviluppo iOS.

  2. Nella barra degli strumenti di Visual Studio usare l'elenco a discesa Destinazione debug per selezionare simulatori iOS e quindi un simulatore iOS specifico:

    Destinazioni di debug dei simulatori iOS di Visual Studio.

  3. Nella barra degli strumenti di Visual Studio premere il pulsante Start per il simulatore iOS scelto per compilare ed eseguire l'app:

    Scelta di destinazione del simulatore iOS di Visual Studio.

    Visual Studio creerà l'app, avvia il simulatore iOS remoto per Windows e distribuisce l'app nel simulatore remoto. Per altre informazioni sul simulatore iOS remoto per Windows, vedere Simulatore iOS remoto per Windows.

  4. Nell'app in esecuzione premere il pulsante Click me più volte e osservare che il numero di clic del pulsante viene incrementato.

    App MAUI .NET in esecuzione in iOS Simulator in un Mac.

Risoluzione dei problemi

Se l'app non riesce a compilare, vedere Risoluzione dei problemi noti, che potrebbero avere una soluzione al problema.

Le app .NET MAUI destinate a Mac Catalyst possono essere avviate e debug solo usando Visual Studio 2022 per Mac.

Passaggi successivi

In questa esercitazione si è appreso come creare ed eseguire la prima app .NET Multipiattaforma dell'interfaccia utente dell'app (.NET MAUI).

Per informazioni sui concetti fondamentali della creazione di un'app con .NET MAUI, vedere Creare un'app MAUI .NET.