Creare la prima 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. Avvia 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 Emulatore 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 dell'account utente, premere il pulsante Sì:

   

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

10. Nella finestra di dialogo del Controllo account utente, premere Sì:

    

11. Nella finestra di dialogo "Mancanza della piattaforma SDK di Android", 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 del Controllo account utente, premere 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, consultare 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 tua app non riesce a compilare, consulta Risoluzione dei problemi noti, che potrebbero avere una soluzione al tuo problema.

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

7. Nella barra degli strumenti di Visual Studio, usare l'elenco a discesa Destinazione di Debug per selezionare iOS simulatori 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 l'app non riesce a compilare, consulta la sezione Risoluzione dei problemi noti, che potrebbe contenere la soluzione al tuo problema.

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

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.

7. In Visual Studio Code verificare che l'ambiente Android sia configurato correttamente premendo CTRL+MAIUSC+P in Windows o Cmd+MAIUSC+P in macOS e quindi selezionando .NET MAUI: Configure Android, seguito da Refresh Android environment (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 (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 verificare 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 in fondo a Visual Studio Code, premi sul simbolo delle parentesi graffe { } e assicurati 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 il dispositivo iOS dalla palette 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 verificare 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, premi il simbolo delle parentesi graffe { } e assicurati che la destinazione di debug sia impostata sul tuo Mac:

   

   È anche possibile impostare la destinazione di debug premendo Cmd+MAIUSC+P e selezionando .NET MAUI: Pick macOS Device dal riquadro 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: Seleziona 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: