Lo sviluppo di app .NET multipiattaforma (.NET MAUI) multipiattaforma native richiede Visual Studio 2022 17.12 o versione successiva o la versione più recente di Visual Studio Code con l'estensione MAUI .NET.
Per iniziare a sviluppare app .NET MAUI multipiattaforma in Windows, installare Visual Studio 2022 17.12 o versione successiva seguendo la procedura di installazione .
Prerequisiti
Visual Studio 2022 17.12 o versione successiva. Per informazioni su sistemi operativi, hardware, linguaggi supportati e indicazioni aggiuntive, vedere Requisiti di sistema di Visual Studio 2022.
Per compilare, firmare e distribuire app .NET MAUI per iOS e Mac Catalyst, è necessario anche:
Mac compatibile con Xcode. Per altre informazioni, vedere la documentazione dei requisiti minimi di Apple.
Versione specifica di Xcode, che dipende dalla versione di .NET MAUI in uso. Per informazioni, vedere Versioni di rilascio.
Id Apple e registrazione apple Developer Program a pagamento. È necessario un ID Apple per distribuire app nei dispositivi e per inviare app ad Apple Store.
In alternativa, per distribuire le build di debug dell'app direttamente da Windows al dispositivo iOS con il riavvio rapido, è necessario:
Un account Apple Developer e la registrazione apple Developer Program a pagamento.
Installazione
Per creare app .NET MAUI, è necessario scaricare la versione più recente di Visual Studio 2022:
Installare Visual Studio o modificare l'installazione esistente tramite il programma di installazione di Visual Studio, e installare il workload di sviluppo dell'interfaccia utente multipiattaforma .NET con le opzioni di installazione facoltative predefinite.
Per iniziare a sviluppare app native .NET MAUI multipiattaforma su Windows, macOS o Linux, installare la versione più recente di Visual Studio Code seguendo la procedura di installazione .
Prerequisiti
Per compilare, firmare e distribuire app .NET MAUI per iOS e Mac Catalyst, è necessario:
Mac compatibile con Xcode. Per altre informazioni, vedere la documentazione dei requisiti minimi di Apple.
Versione specifica di Xcode, che dipende dalla versione di .NET MAUI in uso. Per informazioni, vedere Versioni di rilascio.
Id Apple e registrazione apple Developer Program a pagamento. È necessario un ID Apple per distribuire app nei dispositivi e per inviare app ad Apple Store.
Installare Visual Studio Code
Per creare app MAUI .NET, è necessario scaricare la versione più recente di Visual Studio Code:
Prima di poter creare app MAUI .NET in Visual Studio Code, è necessario installare l'estensione MAUI .NET:
Avvia Visual Studio Code.
In Visual Studio Code passare alla scheda estensioni e cercare ".NET MAUI". Quindi selezionare l'estensione .NET MAUI e installarla premendo il pulsante Installa:
L'uso di C# Dev Kit richiede l'accesso con un account Microsoft con una sottoscrizione di Visual Studio attiva:
Nella scheda di benvenuto per iniziare a usare .NET MAUI, premere il pulsante collega.
Seguire le istruzioni per accedere all'account Microsoft. Per altre informazioni, vedere Accesso a C# Dev Kit.
Per altre informazioni sulle licenze di C# Dev Kit, vedere domande frequenti C# Dev Kit.
Configurare l'ambiente .NET
È necessario che .NET SDK sia installato nel computer per sviluppare app MAUI .NET. Se nel computer non è installato .NET SDK, l'approccio preferito per installarlo in Windows è tramite il programma di installazione di Visual Studio. Per altre informazioni, vedere Installation.
In alternativa, per installare manualmente .NET SDK:
In Linux è possibile installare .NET SDK usando le istruzioni di installazione con script .
Per verificare che .NET SDK sia installato:
Aprire un terminale.
Nel terminale eseguire il comando seguente:
CLI .NET
dotnet --version
Verrà visualizzata la versione di .NET SDK installata.
Nota
Potrebbe essere necessario riavviare il computer prima di verificare che .NET SDK sia installato.
Configurare l'ambiente MAUI .NET
È necessario che .NET MAUI SDK sia installato nel computer per sviluppare app MAUI .NET. Se nel computer non è installato .NET MAUI SDK, l'approccio preferito per installarlo in Windows è tramite il programma di installazione di Visual Studio. Per altre informazioni, vedere Installation.
In alternativa, per installare manualmente .NET MAUI SDK:
Aprire un terminale.
Nel terminale in Windows eseguire il comando seguente:
CLI .NET
dotnet workload install maui
Nel terminale in macOS eseguire il comando seguente:
CLI .NET
sudo dotnet workload install maui
Nel terminale in Linux eseguire il comando seguente:
CLI .NET
dotnet workload install maui-android
Per verificare che .NET MAUI SDK sia installato:
Aprire un terminale.
Nel terminale eseguire il comando seguente:
CLI .NET
dotnet workload list
Su Windows e macOS, dovresti vedere l'ID del workload maui elencato insieme alla versione installata. Tuttavia, se è stato installato tramite il programma di installazione di Visual Studio in Windows, sono elencati gli ID del carico di lavoro seguenti:
android
maui-windows
maccatalyst
ios
Su Linux, dovresti vedere l'ID del carico di lavoro maui-android elencato insieme alla versione installata.
Configurare le piattaforme di destinazione
Per compilare ed eseguire il debug di un'app MAUI .NET, è necessario avere una piattaforma di destinazione valida rispetto al sistema operativo del computer di sviluppo. La tabella seguente elenca le piattaforme di destinazione supportate in ogni sistema operativo:
Il sistema operativo
Piattaforme di destinazione supportate
Finestre
Windows, Android
macOS
Android, iOS, macOS
Linux
Android
La creazione di un'app MAUI .NET per Android e per le piattaforme Apple richiede l'esecuzione di configurazioni e configurazione aggiuntive.
Android
Il processo per configurare il computer per lo sviluppo .NET MAUI su Android con Visual Studio Code è:
In alternativa, anziché scaricare e installare manualmente Java SDK, è possibile usare la destinazione di compilazione InstallAndroidDependencies per installare Java SDK (e Android SDK). Per altre informazioni, vedere Using the InstallAndroidDependencies target.
Importante
Assicurati di prendere nota del percorso in cui è installato OpenJDK, in quanto sarà necessario nel passaggio successivo.
Assicurarsi di aver configurato il percorso di OpenJDK tramite uno degli approcci seguenti:
Impostare la variabile di ambiente JAVA_HOME per definire il percorso java SDK per il computer. Questo è l'approccio consigliato, che definisce il percorso java SDK a livello di computer.
Nota
Se si installa OpenJDK su Windows tramite MSI, è possibile optare per la configurazione del programma di installazione della variabile di ambiente JAVA_HOME.
In Visual Studio Code premere CTRL+MAIUSC+P in Windows oppure CMD+MAIUSC+P in macOS e quindi selezionare .NET MAUI: Configure Android, seguito da Select Java SDK location per impostare il percorso Java SDK a livello di utente/area di lavoro.
Configurare il percorso del Java SDK nel file .csproj impostando la proprietà MSBuild $(JavaSdkDirectory) sul percorso dell'OpenJDK. Verrà definito il percorso java SDK a livello di progetto.
Scaricare e installare Android SDK
Per scaricare e installare Android SDK e configurare Visual Studio Code per usarlo:
Scaricare e installare Android SDK tramite uno degli approcci seguenti:
Scaricare e installare l'SDK di Android creando un nuovo progetto .NET MAUI, quindi utilizzare il target di build InstallAndroidDependencies per configurare l'ambiente Android. Questo è l'approccio consigliato. Per altre informazioni, vedere Using the InstallAndroidDependencies target.
Scaricare e installare Android SDK tramite Android Studio. Per ulteriori informazioni, vedere Installa Android Studio su developer.android.com.
Scaricare e installare Android SDK tramite la gestione pacchetti preferita in Linux.
Assicurati di aver configurato il percorso dell'Android SDK tramite uno degli approcci seguenti:
Impostare la variabile di ambiente ANDROID_HOME per definire il percorso di Android SDK per il computer. Questo è l'approccio consigliato, che definisce il percorso di Android SDK a livello di computer.
In Visual Studio Code premere CTRL+MAIUSC+P in Windows oppure CMD+MAIUSC+P in macOS e quindi selezionare .NET MAUI: Configura Android, seguito da Selezionare la posizione di Android SDK per impostare il percorso di Android SDK a livello di utente/area di lavoro.
Configurare il percorso dell'SDK Android nel file .csproj impostando la proprietà $(AndroidSdkDirectory) MSBuild al percorso dell'SDK Android. Verrà definito il percorso di Android SDK a livello di progetto.
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:
Nel riquadro comandi selezionare .NET MAUI: Configure Android, seguito sia da Select Android SDK location (Selezionare la posizione di Android SDK) che da Select Android SDK location (Selezionare la posizione di Android SDK) e verificare che puntino correttamente alle installazioni di ognuna. In Windows, se si installano gli SDK tramite Visual Studio, OpenJDK si trova in C:\Programmi\Microsoft e Android SDK si troverà in C:\Programmi (x86)\Android\android-sdk.
Assicurarsi che la cartella android SDK abbia sottocartelle, ad esempio strumenti di compilazione, cmdline-toolse strumenti della piattaforma.
Assicurarsi che la cartella OpenJDK abbia sottocartelle, ad esempio bin, libe altro ancora.
Assicurarsi che la variabile di ambiente ANDROID_HOME sia impostata sul percorso di Android SDK.
Assicurati che la variabile di ambiente JAVA_HOME sia impostata sul percorso del tuo Java SDK.
Se le licenze Android non sono state accettate, in un terminale con privilegi elevati passare alla cartella cmdline-tools/{version}/bin di Android SDK ed eseguire e quindi seguire le istruzioni dell'interfaccia della riga di comando.
Uso della destinazione InstallAndroidDependencies
L'approccio consigliato per installare le dipendenze necessarie per il progetto .NET MAUI su Android consiste nell'eseguire il target di MSBuild InstallAndroidDependencies. Questa destinazione installerà Android SDK automaticamente, se non è già installato.
In un terminale creare un nuovo progetto MAUI .NET:
CLI .NET
dotnetnew maui -n"MyMauiApp"
In un terminale, cambiare la directory in MyMauiAppe compilare l'app specificando il target di build InstallAndroidDependencies.
CLI .NET
cd MyMauiApp
dotnetbuild -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True
Nota
La destinazione InstallAndroidDependencies MSBuild può anche installare il Kit di Sviluppo Java se viene specificata la proprietà JavaSdkDirectory MSBuild.
Nel comando precedente:
-p:AndroidSdkDirectory="/path/to/sdk" installa e aggiorna le dipendenze Android nel percorso assoluto specificato. I percorsi suggeriti sono %LOCALAPPDATA%/Android/Sdk in Windows e $HOME/Library/Android/sdk in macOS.
-p:AcceptAndroidSDKLicenses=True accetta le licenze Android necessarie per lo sviluppo.
(facoltativo) -p:JavaSdkDirectory="/path/to/sdk" installa Java SDK nel percorso assoluto specificato.
Provare a evitare di usare percorsi contenenti spazi o caratteri non ASCII.
Scaricare e installare un emulatore Android
Per scaricare e installare un emulatore Android in cui eseguire le app:
In un terminale passare alla {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.
In un terminale usare il comando sdkmanager per scaricare e installare un emulatore Android:
Il comando precedente presuppone un Apple Silicon Mac. Per un Mac Intel, sostituire arm64-v8a con x86_64.
Per altre informazioni sul comando avdmanager, vedere avdmanager in developer.android.com.
iOS e macOS
Per configurare il Mac per lo sviluppo MAUI .NET in iOS e Mac Catalyst con Visual Studio Code:
Installare la versione di Xcode richiesta dalla versione di .NET MAUI in uso. Per informazioni, vedere Versioni di rilascio. La versione stabile più recente di Xcode può essere scaricata dall'App Store di Apple.
In un terminale eseguire il comando seguente per acquisire gli strumenti da riga di comando Xcode:
Console
xcode-select --install
Avviare Xcode e accettare eventuali contratti di licenza. Se i simulatori non avviano l'installazione, passare a Xcode > Impostazioni > Componenti e installare i runtime del simulatore scelti.
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:
Assicurati di aver eseguito xcode-select --install in un terminale.
Se viene visualizzato un errore che indica che Xcode non è stato trovato, eseguire xcode-select -p in un terminale e verificare che restituisca un percorso all'installazione di Xcode.
Apri Xcode per assicurarti che venga caricato correttamente, quindi vai a > Percorso > e verifica che il campo Strumenti da Riga di Comando punti all'installazione corretta di Xcode.
Risoluzione dei problemi
Se si verificano problemi durante l'installazione dell'estensione .NET MAUI in Visual Studio Code, è possibile trovare altre informazioni sui problemi navigando alla finestra Output (CTRL+MAIUSC+U su Windows o CMD+MAIUSC+U su macOS) e selezionando .NET MAUI nell'elenco a discesa.
Inviare commenti
Per fornire commenti e suggerimenti sull'estensione .NET MAUI direttamente in Visual Studio Code, passare alla finestra di dialogo Guida > Segnala un problema. assicurarsi quindi di selezionare "Report bug" come valore del elenco a discesa, "Estensione di VS Code" come valore dell'elenco a discesa per, e ".NET MAUI" come valore dell'elenco a discesa Extension.
Passaggi successivi
Per informazioni su come creare ed eseguire la prima app MAUI .NET in Visual Studio 2022 in Windows o Visual Studio Code, fare clic sul pulsante seguente.
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
Feedback su .NET MAUI
.NET MAUI è un progetto di open source. Selezionare un collegamento per fornire feedback:
