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. Per altre informazioni, vedere Installazione.

Crea un'app

Per creare una nuova app MAUI .NET:

1. Avviare Visual Studio Code. In Esplora risorse fare clic su Crea progetto .NET in Esplora risorse. In alternativa, selezionare CTRL/CMD+MAIUSC+P .NET: Nuovo progetto....
2. Selezionare .NET MAUI App o .NET MAUI Blazor App.
3. Selezionare una cartella vuota . Se esplora file si apre di nuovo, la cartella non è vuota.
4. Assegna un nome al progetto.
5. Assicurarsi che il progetto venga caricato correttamente nella Esplora soluzioni e quindi aprire un file C# o XAML.

Nota

È anche possibile aprire un progetto .NET MAUI esistente in Visual Studio Code tramite il menu Apri file>.

L'app dovrebbe ora essere visualizzata nelle Esplora soluzioni di C# Dev Kit in Visual Studio Code. Poiché l'estensione .NET MAUI dipende da C# Dev Kit, è possibile usare tutte le funzionalità insieme all'estensione MAUI .NET.

Scegliere il dispositivo di destinazione

Per scegliere il dispositivo di destinazione, fare clic sul simbolo parentesi graffe { } nell'angolo in basso a destra di Visual Studio Code. È possibile usare questo simbolo per modificare il progetto di avvio, modificare la destinazione di debug impostando qualsiasi valore valido nel computer di sviluppo e aggiungere entrambe le impostazioni sulla barra di stato di Visual Studio Code:

È anche possibile impostare il progetto di avvio e la destinazione di debug nel riquadro comandi, usando CTRL/CMD+MAIUSC+P e cercando ".NET MAUI".

È possibile eseguire la distribuzione nel computer di sviluppo locale (desktop di Windows o macOS con Xcode) senza altri passaggi.

Impostare Android come destinazione

Per usare gli emulatori Android, seguire questa procedura per installare e creare un emulatore:

1. Passare al terminale a <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/.

2. Usare sdkmanager per installare l'emulatore.

   In Windows eseguire i comandi seguenti nel terminale:

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   In macOS eseguire i comandi seguenti nel terminale:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Nota

   Le virgolette intorno agli argomenti della sdkmanager riga di comando sono importanti.

3. È quindi possibile creare un nuovo emulatore nella riga di comando con avdmanager di Android.

   In Windows eseguire i comandi seguenti nel terminale:

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   In macOS eseguire i comandi seguenti nel terminale:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Nota

   Le virgolette intorno agli argomenti della avdmanager riga di comando sono importanti.

È anche possibile eseguire il debug su dispositivi Android fisici.

IOS di destinazione

I simulatori iOS sono incorporati in Xcode. Per scaricare i simulatori, assicurarsi che l'opzione sia selezionata per installarli al primo avvio di Xcode oppure passare a Piattaforme di impostazioni > Xcode > e scegliere un runtime del simulatore da installare.

Per eseguire il debug con un dispositivo iOS, seguire questa procedura prima di provare a eseguire il debug:

1. Specificare l'ID Apple nell'account delle impostazioni > Xcode>.
2. Registrare il dispositivo con il team se si appartiene al Programma Apple Developer.
3. Abilitare la modalità sviluppatore nel dispositivo, come descritto in Abilitazione della modalità sviluppatore in un dispositivo. La prima volta che esegui l'app potresti ricevere un popup nel dispositivo, assicurati di selezionare Consenti.

Eseguire il debug dell'app

Per eseguire il debug dell'app, passare al menu Esegui e debug di Visual Studio Code e selezionare il pulsante Esegui e debug. In alternativa, è possibile usare F5 per avviare una sessione di debug. Se Visual Studio Code richiede di selezionare un debugger, assicurarsi di selezionare C#.

Nota

Nelle versioni di anteprima dell'estensione il debugger è stato elencato come .NET MAUI. Nella versione stabile questa configurazione è stata sostituita con C#.

Il debugger sceglierà automaticamente la destinazione di debug e il progetto di avvio impostati tra parentesi graffe { } menu. Se non è stato selezionato alcun elemento, verrà richiesto di scegliere una destinazione di debug.

Dopo l'avvio del debug dell'app, è possibile usare gli strumenti di debug predefiniti di Visual Studio Code per impostare punti di interruzione, eseguire passaggi nel codice e altro ancora.

Altre informazioni

Se si verificano problemi con l'estensione, è possibile seguire la procedura di risoluzione dei problemi, vedere i problemi noti o inviare commenti e suggerimenti.

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.