Creare la prima app

In questa esercitazione si apprenderà come creare ed eseguire la prima app .NET multipiattaforma (.NET MAUI) in Visual Studio 2022 in Windows o Visual Studio Code in Windows, macOS o Linux. Ciò consentirà di garantire che l'ambiente di sviluppo sia configurato correttamente.

Visual Studio

Prerequisiti

• Visual Studio 2022 17.12 o versione successiva, con il carico di lavoro app multipiattaforma .NET installato. Per altre informazioni, vedere Installazione.

Crea 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 MAUI .NET per iOS in Windows richiede un host di compilazione Mac. Se non è necessario specificare come destinazione iOS e non si ha un Mac, è consigliabile iniziare a usare Android o Windows.

In questa esercitazione si creerà la prima app MAUI .NET 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. Nella finestra iniziale fare clic su Crea un nuovo progetto per creare un nuovo progetto:

   

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

   

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

   

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

   

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

   

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

   

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

   

   Visual Studio avvierà il processo di installazione dell'SDK Android predefinito e dell'emulatore Android.

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

   

9. Nella finestra di dialogo Controllo account utente premere il pulsante Sì:

   

   Attendere che Visual Studio scarichi l'SDK Android predefinito e l'emulatore Android.

10. Nella finestra di dialogo Controllo account utente premere il pulsante Sì:

    

11. Nella finestra di dialogo Android SDK Platform manca premere il pulsante Installa :

    

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

    

    Attendere che Visual Studio installi i componenti android SDK.

13. Nella finestra Nuovo dispositivo premere il pulsante Crea:

    

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

14. Chiudere la finestra Gestione dispositivi Android:

    

15. Nella barra degli strumenti di Visual Studio premere il pulsante Pixel 7 - API 35 (Android 15.0 - API 35):

    

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

    

17. Nella finestra di dialogo Controllo account utente premere il pulsante Sì:

    

    Attendere l'installazione di Visual Studio per scaricare Android SDK.

18. Nella barra degli strumenti di Visual Studio premere il pulsante Pixel 7 - API 35 (Android 15.0 - API 35) per compilare ed eseguire l'app:

    

    Visual Studio avvierà l'emulatore Android, compilerà l'app e distribuirà l'app nell'emulatore.

    Avviso

    L'accelerazione hardware deve essere abilitata per ottimizzare le prestazioni dell'emulatore Android. In caso contrario, l'emulatore verrà eseguito molto lentamente. Per altre informazioni, vedere Come abilitare l'accelerazione hardware con emulatori Android (Hyper-V e AEHD).

19. Nell'app in esecuzione nell'emulatore Android premere più volte il pulsante Fai clic su di me e osservare che il numero di clic sul pulsante viene incrementato.

    

Risoluzione dei problemi

Se la compilazione dell'app non riesce, 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.

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

   

7. Nell'app in esecuzione premere più volte il pulsante Fai clic su di me e verificare se il numero di clic del pulsante viene incrementato:

   

Risoluzione dei problemi

Se la compilazione dell'app non riesce, vedere Risoluzione dei problemi noti che potrebbero avere una soluzione al problema.

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

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

   

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

   

   Visual Studio compilerà l'app, avvierà il simulatore iOS remoto per Windows e distribuirà l'app nel simulatore remoto. Per altre informazioni sul simulatore iOS remoto per Windows, vedere Simulatore iOS remoto per Windows.

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

   

Risoluzione dei problemi

Se la compilazione dell'app non riesce, vedere Risoluzione dei problemi noti che potrebbero avere una soluzione al problema.

Le app MAUI .NET destinate a Mac Catalyst possono essere avviate e sottoposto a debug solo con Visual Studio Code.

Visual Studio Code

Prerequisiti

• Visual Studio Code, con l'estensione MAUI .NET installata e configurata:
  • Il tuo account Microsoft connesso a C# Dev Kit.
  • .NET SDK è installato.
  • È stato installato il .NET MAUI SDK.
  • Xcode installato nel Mac, inclusi i runtime del simulatore e gli strumenti da riga di comando Xcode, se destinati alle piattaforme Apple.
  • Microsoft OpenJDK, Android SDK e un emulatore Android installato sul tuo computer, se destinato ad Android.

Per altre informazioni, vedere Installazione.

Crea un'app

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

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

In questa esercitazione si creerà la prima app MAUI .NET su Visual Studio Code su un Mac ed eseguirla su macOS:

In questa esercitazione creerai la tua prima app .NET MAUI in Visual Studio Code su Windows e la eseguirai su Windows.

1. Avviare Visual Studio Code. Nell'explorer di premere Crea progetto .NET:

   

   In alternativa, premere CTRL+MAIUSC+P in Windows oppure CMD+MAIUSC+P in macOS e quindi il comando .NET: Nuovo progetto....

2. Nella palette dei comandi, seleziona il modello App MAUI .NET:

   

3. Nella finestra di dialogo Posizione progetto selezionare la posizione in cui desideri creare il nuovo progetto.

   Importante

   I progetti devono essere creati in una cartella vuota.

4. Nella paletta comandi, inserire un nome per il nuovo progetto e premere INVIO:

   

5. Nel riquadro comandi premere Crea progetto:

   

   Attendere che il progetto venga creato, accettando la cartella come percorso attendibile, se necessario.

6. Nel Explorer, espandi il nodo radice del tuo progetto e quindi apri un file C# come MainPage.xaml.cs:

   

7. In Visual Studio Code verificare che l'ambiente Android sia configurato correttamente premendo CTRL+MAIUSC+P in Windows oppure CMD+MAIUSC+P in macOS e quindi selezionando .NET MAUI: Configurare Android, seguito da Aggiorna ambiente Android. Eventuali errori rilevati devono essere risolti.

8. Nella barra di stato in basso di Visual Studio Code, premi il simbolo delle parentesi graffe { } e assicurati che il Debug Target sia impostato su un emulatore Android specifico:

   

   È anche possibile impostare la destinazione di debug premendo CTRL+MAIUSC+P in Windows oppure CMD+MAIUSC+P in macOS e selezionando .NET MAUI: Pick Android Device dal riquadro comandi.

9. Compilare ed eseguire l'app su Android premendo F5 o premendo il pulsante Esegui nell'angolo superiore destro di Visual Studio Code.

   

   Se viene chiesto di selezionare un debugger nel riquadro comandi, selezionare C# e quindi la configurazione di avvio per il progetto.

10. Nell'app in uso sul tuo emulatore Android scelto, premi più volte il pulsante Clicca qui e osserva che il conteggio dei clic aumenta.

    

Eseguire il debug dell'app in un dispositivo Android

Per eseguire il debug dell'app in un dispositivo Android:

1. Assicurarsi che il dispositivo sia configurato per la distribuzione. Per altre informazioni, vedere Configurare un dispositivo per la distribuzione.
2. Collegare il dispositivo al computer e selezionarlo come destinazione di debug in Visual Studio Code.
3. Esegui l'app.

7. In Visual Studio Code, verifica che l'ambiente Apple sia configurato correttamente premendo CMD+MAIUSC+P e quindi selezionando .NET MAUI: Configura Apple, seguito da Aggiorna ambiente Apple. Eventuali errori rilevati devono essere risolti.

8. Nella barra di stato nella parte inferiore di Visual Studio Code premere il simbolo parentesi graffe { } e assicurarsi che il destinazione di debug sia impostato su un simulatore iOS specifico:

   

   È anche possibile impostare la destinazione di debug premendo CMD+MAIUSC+P e selezionando .NET MAUI: Scegli dispositivo iOS dalla palette dei comandi.

9. Compilare ed eseguire l'app in iOS premendo F5 o premendo il pulsante Esegui nell'angolo superiore destro di Visual Studio Code:

   

   Se viene chiesto di selezionare un debugger nel riquadro comandi, selezionare C# e quindi la configurazione di avvio per il progetto.

10. Nell'app in esecuzione nel simulatore iOS scelto, premi il pulsante Clicca su di me più volte e osserva che il conteggio dei clic sul pulsante viene incrementato:

    

Eseguire il debug dell'app in un dispositivo iOS

Per eseguire il debug dell'app in un dispositivo iOS:

1. Assicurati di aver aggiunto il tuo ID Apple a Xcode in Xcode > Impostazioni > Account.
2. Assicurati che il tuo dispositivo sia stato registrato con il tuo team, se appartieni al Programma Apple Developer.
3. Abilitare la modalità sviluppatore nel dispositivo. La prima volta che esegui l'app potresti ricevere un popup nel dispositivo, assicurati di selezionare Consenti. Per altre informazioni sulla modalità sviluppatore, vedere Abilitazione della modalità sviluppatore in un dispositivo in developer.apple.com.
4. Collegare il dispositivo al computer e selezionarlo come destinazione di debug in Visual Studio Code.
5. Esegui l'app.

7. In Visual Studio Code, verifica che l'ambiente Apple sia configurato correttamente premendo CMD+MAIUSC+P e quindi selezionando .NET MAUI: Configura Apple, seguito da Aggiorna ambiente Apple. Eventuali errori rilevati devono essere risolti.

8. Nella barra di stato nella parte inferiore di Visual Studio Code premere il simbolo parentesi graffe { } e assicurarsi che il destinazione di debug sia impostato sul Mac:

   

   È anche possibile impostare la destinazione di debug premendo CMD+MAIUSC+P e selezionando .NET MAUI: Seleziona dispositivo macOS dalla paletta comandi.

9. Compilare ed eseguire l'app in macOS premendo F5 o premendo il pulsante Esegui nell'angolo superiore destro di Visual Studio Code:

   

   Se viene chiesto di selezionare un debugger nel riquadro comandi, selezionare C# e quindi la configurazione di avvio per il progetto.

10. Nell'app in esecuzione premere più volte il pulsante Fai clic su di me e verificare se il numero di clic del pulsante viene incrementato:

    

7. Nella barra di stato, posizionata nella parte inferiore di Visual Studio Code, premi il simbolo delle parentesi graffe { } e assicurati che la destinazione di debug sia impostata su Windows:

   

   È anche possibile impostare la destinazione di debug premendo CTRL+MAIUSC+P e selezionando .NET MAUI: Scegli dispositivo Windows dal riquadro comandi.

8. Compilare ed eseguire l'app in Windows premendo F5 o premendo il pulsante Esegui nell'angolo superiore destro di Visual Studio Code:

   

   Se viene chiesto di selezionare un debugger nel riquadro comandi, selezionare C# e quindi la configurazione di avvio per il progetto.

9. Nell'app in esecuzione premere più volte il pulsante Fai clic su di me e verificare se il numero di clic del pulsante viene incrementato:

   

Risoluzione dei problemi

Se la tua app non riesce a compilare e distribuire, esamina Risoluzione dei problemi noti, che potrebbe offrire una soluzione al tuo problema.

Passaggi successivi

In questa esercitazione si è appreso come creare ed eseguire la prima app .NET Multi-platform App UI (.NET MAUI).

Per informazioni sui concetti fondamentali della creazione di un'app con .NET MAUI, vedere Creare un'app MAUI .NET. In alternativa, per un corso di formazione .NET MAUI completo, vedere Creare app per dispositivi mobili e desktop con .NET MAUI.