Esercitazione .NET MAUI - Creare la prima app multipiattaforma in C #

Esecuzione su dispositivo mobile

È possibile decidere di eseguire la distribuzione in una o più piattaforme in base all'ambiente di sviluppo. L'app è stata appena eseguita e distribuita in Windows. A questo punto, è possibile configurare un dispositivo o un emulatore Android.

Attiva Hyper-V

Nella barra di ricerca di Windows, digita Funzionalità di Windows e seleziona Attiva o disattiva le funzionalità di Windows.

Attiva o disattiva le funzionalità di Windows

Verificare che la casella Hyper-V sia selezionata e selezionare Ok.

Casella Funzionalità Windows con l’opzione Hyper-V selezionata

Per rendere effettiva la modifica, devi riavviare il computer.

Installazione Android SDK

Apri Visual Studio e la soluzione MyFirstMauiApp. Nel menu a discesa della destinazione di debug seleziona net8.0-android in Framework.

Seleziona Android come distribuzione di destinazione

Per compilare progetti sono necessarie versioni specifiche di Android SDK. Se la licenza Android SDK non è stata accettata, verrà visualizzato il messaggio di errore seguente nella finestra Elenco errori.

Messaggio di errore nella finestra Elenco errori che indica che la licenza Android SDK non è stata accettata.

Fare doppio clic sul messaggio per avviare il processo di accettazione della licenza. Fare clic su Accetta per ognuna delle licenze presenti e verrà avviata l'installazione automatica.

Richiesta di Android SDK all'utente di installare una versione specifica di Android SDK per compilare il progetto.

Configurare l'emulatore Android

Se non si dispone di un dispositivo Android in cui eseguire la distribuzione, è possibile seguire questa procedura per configurare un emulatore Android. Se l'operazione è già stata eseguita o si vuole usare il proprio dispositivo Android, è possibile ignorare questo passaggio.

Se è la prima volta che si compila un'applicazione .NET MAUI, viene visualizzato emulatore Android selezionato nel menu a discesa della destinazione di debug. Fare clic su di esso per avviare il processo di creazione. Se viene visualizzata una finestra di dialogo di accettazione delle licenze, selezionare Accept.

Menu della barra degli strumenti di Visual Studio 2022 che mostra 'Emulatore Android' come destinazione di debug.

Viene visualizzata la finestra Nuovo dispositivo. Selezionare il pulsante Crea per creare un emulatore con le impostazioni predefinite. Verranno scaricate le immagini dell'emulatore e verrà finalizzata la creazione dell'emulatore per l'uso in Visual Studio. Questo passaggio potrebbe richiedere del tempo.

Non preoccuparti se il livello API visualizzato è diverso dalle immagini. Può essere 33 o superiore.

Finestra di dialogo per creare un nuovo emulatore Android con le impostazioni predefinite popolate.

Dopo la creazione dell'emulatore, verrà visualizzato un pulsante Avvia. Fare clic su tale pulsante.

Il gestore dell’emulatore Android mostra che l’emulatore è stato creato ed è pronto per essere eseguito.

È possibile che venga visualizzata una richiesta di abilitazione della piattaforma Windows Hypervisor. Segui la documentazione per abilitare l'accelerazione per migliorare le prestazioni (necessaria per rendere l'emulatore funzionante). Seleziona Esegui comunque.

Richiesta di abilitazione della piattaforma Windows Hypervisor

L'emulatore Android completerà il suo avvio quando l'opzione di arresto sarà disponibile in Gestione dispositivi Android. L'operazione potrebbe richiedere del tempo.

Visual Studio menu della barra degli strumenti 2022 che mostra l'emulatore Android appena creato come destinazione di debug.

Al termine, verrà visualizzato nel menu di debug di Visual Studio.

Visual Studio menu della barra degli strumenti 2022 che mostra l'emulatore Android appena creato come destinazione di debug.

L'emulatore Android è stato creato ed è pronto per l'uso. La prossima volta che esegui Visual Studio, l'emulatore apparirà direttamente nella finestra di debug e si avvierà non appena lo selezionerai. Se si verificano problemi o difficoltà relative alle prestazioni con l'emulatore, leggi la documentazione completa sulla configurazione.

Configurare il dispositivo Android

Per sviluppare con il dispositivo Android, è necessario abilitare il debug USB. Segui questi passaggi nel dispositivo per connetterlo a Visual Studio. Se non si dispone di un dispositivo Android, è possibile ignorare questa sezione.

Abilita la modalità sviluppatore

  1. Passare alla schermata Impostazioni.
  2. Trova Numero build usando la ricerca nella parte superiore della schermata delle impostazioni o nelle Informazioni sul telefono.
  3. Tocca Numero build 7-10 volte fino a quando non viene visualizzato "Sei uno sviluppatore!".

Schermata delle impostazioni del dispositivo Android sulla schermata informazioni del telefono che mostra il numero di build.

Controllare lo stato di debug USB

  1. Passare alla schermata Impostazioni.
  2. Trovare il debug USB utilizzando la ricerca nella parte superiore della schermata delle impostazioni oppure individuarlo nelle opzioni per sviluppatori.
  3. Abilitare il debug USB se non è già abilitato.

Schermata delle impostazioni del dispositivo Android nella schermata relativa alle impostazioni dello sviluppatore che visualizza l'opzione di debug USB attivata.

Dispositivo di attendibilità

  1. Collega il dispositivo al computer.
  2. Ti verrà chiesto di Permettere il debug USB.
  3. Selezionare Consenti sempre da questo computer.
  4. Fare clic Consenti.

Richiesta del dispositivo Android per consentire il debug USB nel dispositivo dal computer.

Il dispositivo è ora configurato e verrà visualizzato in Visual Studio come destinazione di distribuzione.

Sono stati riscontrati problemi? Controllare la documentazione.

L'emulatore o il dispositivo deve ora essere configurato per la distribuzione.

Esegui in Android

Assicurarsi che il dispositivo o l'emulatore sia selezionato come destinazione di debug.

Emulatore Android Pixel 5 impostato come destinazione di debug.

Dal menu selezionare Debug > Avvio del debug (o premere F5). Se questa opzione è disabilitata, verificare che sia selezionato un emulatore o un dispositivo.

L'applicazione verrà compilata, distribuita nel dispositivo/emulatore Android selezionato ed eseguita.

Emulatore Android che esegue l'app .NET MAUI. Viene visualizzato un messaggio 'Hello, .NET MAUI!'.

È possibile eseguire la distribuzione in una o più piattaforme in base all'ambiente di sviluppo. L'app è stata appena eseguita e distribuita in macOS. A questo punto, eseguire la distribuzione in iOS.

Chiudere l'applicazione .NET MAUI in esecuzione e tornare a VS Code.

Fare clic sulle parentesi graffe nella parte inferiore destra della finestra di VS Code nella barra di stato e selezionare Destinazione di debug.

Mac selezionato come distribuzione di destinazione per impostazione predefinita

Scorrere verso il basso e selezionare iPhone 15.

Elenco di destinazioni di debug con iPhone 15 evidenziato

Verrà visualizzato iOS: iPhone 15 come nuova destinazione di debug.

Destinazione di debug aggiornata per mostrare iPhone 15

Per eseguire l'app, fare clic sull'icona Esegui con debug nella barra attività di VS Code. Fare quindi clic su Esegui con debug.

Riquadro per l'esecuzione e il debug di VS Code

L'applicazione verrà compilata e distribuita nel simulatore iPhone. Si noti che l'operazione potrebbe richiedere un minuto, perché sta praticamente attivando un iPhone.

App .NET MAUI in esecuzione nel simulatore iOS

Continua