Per iniziare a sviluppare app .NET MAUI multipiattaforma in Windows, installare Visual Studio 2022 17.8 o versione successiva seguendo la procedura di installazione .
Prerequisiti
- Visual Studio 2022 17.8 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, è anche 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.
In alternativa, per distribuire le build di debug dell'app direttamente da Windows al dispositivo iOS con il riavvio rapido, è necessario:
Installazione
Per creare app .NET MAUI, è necessaria la versione più recente di Visual Studio 2022:
Installare Visual Studio o modificare l'installazione esistente e installare il carico di lavoro Sviluppo dell'interfaccia utente app multipiattaforma .NET con le opzioni di installazione facoltative predefinite:
Nota
Visual Studio per Mac è prevista la pensione entro il 31 agosto 2024 in conformità con Criteri moderni relativi al ciclo di vita di Microsoft. Visual Studio per Mac 17.6 continuerà a essere supportato fino al 31 agosto 2024, con aggiornamenti di manutenzione per problemi di sicurezza e piattaforme aggiornate da Apple. Per altre informazioni, incluse le opzioni alternative per lo sviluppo in un Mac, vedere What's happening to Visual Studio per Mac?.
Per iniziare a sviluppare app .NET MAUI multipiattaforma in macOS, installare Visual Studio 2022 per Mac 17.6 seguendo la procedura di installazione .
Prerequisiti
- Visual Studio 2022 per Mac 17.6. Per informazioni su sistemi operativi, hardware, linguaggi supportati e requisiti aggiuntivi e indicazioni aggiuntive, vedere Requisiti di sistema di Visual Studio 2022 per Mac.
Per compilare, firmare e distribuire app .NET MAUI per iOS o macOS, è 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.
Installazione
Per creare app MAUI .NET, è necessario il Visual Studio per Mac più recente:
Installare Visual Studio 2022 per Mac o modificare l'installazione esistente e assicurarsi che siano installati i carichi di lavoro seguenti:
- .NET
- .NET MAUI
- Android
- iOS
Importante
Per le nuove installazioni di Visual Studio 2022 per Mac, selezionando il carico di lavoro MAUI .NET selezionare automaticamente i carichi di lavoro Android e iOS, attualmente necessari per lo sviluppo MAUI .NET.
Installare .NET 8 tramite il programma di installazione autonomo.
Al termine dell'installazione di .NET 8, eseguire dotnet workload install maui
in un terminale.
Importante
Per usare Visual Studio per Mac con .NET 8, abilitare la casella di controllo Preferenze > di Visual Studio > Altre > funzionalità > di anteprima Usare .NET 8 SDK se installato (richiede il riavvio).
Se si riscontrano problemi di rete durante l'installazione in un ambiente aziendale, rivedere le istruzioni per l'installazione di Visual Studio per Mac protetto da un firewall o un proxy.
Installazione dietro un firewall o un server proxy
Per installare Visual Studio 2022 per Mac dietro un firewall, alcuni endpoint devono essere resi accessibili per consentire i download degli strumenti e degli aggiornamenti necessari per il software. Per altre informazioni sulla configurazione della rete per consentire l'accesso agli endpoint necessari, vedere Installare e usare Visual Studio per Mac dietro un firewall o un server proxy.
Nota
Il supporto di MAUI .NET in Visual Studio Code è ancora in anteprima. Provalo e condividi i tuoi commenti e suggerimenti.
Installare Visual Studio Code e l'estensione MAUI .NET
Installare Visual Studio Code.
Nella scheda Estensioni cercare ".NET MAUI" e installare l'estensione MAUI .NET. L'estensione .NET MAUI installa automaticamente le estensioni C# Dev Kit e C# , necessarie per l'esecuzione dell'estensione MAUI .NET.
Nota
L'estensione .NET MAUI richiede il Kit di sviluppo C# e le estensioni C# non definitive. È necessario accedere a C# Dev Kit per usare la funzionalità dell'estensione .NET MAUI. Per altre informazioni su C# Dev Kit e sulla relativa famiglia di estensioni, vedere questo post di blog.
Installare carichi di lavoro .NET e .NET MAUI
Installare .NET 8.
In Windows è consigliabile usare il programma di installazione di Visual Studio per gestire le installazioni dei carichi di lavoro .NET e .NET MAUI. Le istruzioni sull'uso del programma di installazione di Visual Studio sono disponibili qui.
Installare il carico di lavoro MAUI .NET.
In Windows e macOS eseguire il comando seguente in un terminale:
dotnet workload install maui
In Linux eseguire il comando seguente in un terminale:
dotnet workload install maui-android
Per eseguire il debug di un'app MAUI .NET in Visual Studio Code, è necessario avere una piattaforma di destinazione valida per il sistema operativo del computer di sviluppo:
Il sistema operativo |
Piattaforme di destinazione supportate |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS e macOS
Per eseguire il debug in una destinazione iOS o macOS in 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 da Mac App Store.
- Eseguire
xcode-select --install
in un terminale per acquisire gli strumenti da riga di comando Xcode.
Android
Per eseguire il debug in una destinazione Android in Visual Studio Code:
- Installare Microsoft OpenJDK 17.
- Installare Android SDK tramite uno degli approcci seguenti:
- (Scelta consigliata) Creare un nuovo progetto MAUI .NET (
dotnet new maui
) e usare la destinazione InstallAndroidDependencies.
- Eseguire l'installazione tramite Visual Studio (solo Windows).
- Eseguire l'installazione tramite Android Studio.
- Eseguire l'installazione tramite la gestione pacchetti preferita in Linux.
Risoluzione dei problemi
È possibile riscontrare problemi durante la configurazione dell'estensione MAUI .NET per Visual Studio Code. Se si verificano ancora problemi dopo aver seguito la procedura di risoluzione dei problemi seguente, segnalare un problema.
Creazione del progetto
Se si tenta di creare un nuovo progetto e Esplora file continua a comparire in un ciclo infinito, è possibile che non si selezioni una cartella vuota. Verificare che non siano presenti file o cartelle nascosti, creare una nuova cartella o creare l'app MAUI .NET dalla riga di comando usando dotnet new maui
.
Uso della destinazione InstallAndroidDependencies
.NET 8 ha una destinazione di compilazione che consente di configurare l'ambiente Android per l'utente. Eseguire il comando seguente in un terminale per configurare il computer e configurare l'ambiente Android:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
Nel comando precedente:
AndroidSdkDirectory="<AndroidSdkPath>"
: installa o aggiorna le dipendenze Android nel percorso assoluto specificato.
- Windows: androidSdkPath suggerito è
%LOCALAPPDATA%/Android/Sdk
.
- MacOS: androidSdkPath suggerito è
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: installa Java nel percorso assoluto specificato.
AcceptAndroidSDKLicenses=True
: accetta le licenze Android necessarie per lo sviluppo.
Si è verificato un errore che indica che Android SDK o Java SDK non è stato trovato
- Aprire il riquadro comandi (CTRL/CMD + MAIUSC + P) e cercare il
.NET MAUI: Configure Android
comando . Selezionare sia "Set Android SDK path" che "Set Android JDK path" (Imposta percorso JDK Android) e verificare che puntino alle installazioni di ogni.
- La cartella Android SDK deve contenere sottocartelle,
build-tools
ad esempio , cmdline-tools
e platform-tools
.
- La cartella Java OpenJDK deve contenere sottocartelle,
bin
ad esempio , lib
e altro ancora.
- In Windows, se si installa tramite Visual Studio, Java SDK sarà in
C:\Program Files\Microsoft\
e Android SDK sarà in C:\Program Files (x86)\Android\android-sdk
.
- Impostare la
JAVA_HOME
variabile di ambiente su un percorso Java OpenJDK valido.
- Impostare la
ANDROID_HOME
variabile di ambiente sul percorso di Android SDK.
- Controllare le versioni minime delle dipendenze Android installate:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- Piattaforme; android-34*
- .NET 7: platform-tools = 33.0.2
- .NET 8: platform-tools = 34.0.5
Si è verificato un errore che indica che le licenze Android non sono accettate
In un prompt dei comandi o un terminale con privilegi elevati passare alla cartella di cmdline-tools/latest/bin/
Android SDK ed eseguire sdkmanager --licenses
quindi seguire i prompt dell'interfaccia della riga di comando.
Le dipendenze Android non vengono caricate nel Esplora soluzioni, ma l'app viene compilata correttamente
Si tratta di un problema noto se si installa in %APPDATA%
Windows e verrà risolto in una versione futura.
Installazione di iOS/Xcode
- Se viene visualizzato un errore che indica che Xcode non viene trovato, eseguire
xcode-select --install
in un terminale, quindi verificare che xcode-select -p
punti all'installazione di Xcode.
- Se si verificano ancora problemi, aprire Xcode per assicurarsi che venga caricato correttamente. Quando Xcode è aperto, passare a Xcode > Impostazioni > Locations (Posizioni) e verificare che il campo Strumenti da riga di comando punti al codice Xcode corretto.
- C'è un problema noto che a volte è necessario compilare l'app iOS/macOS due volte per la distribuzione. Questo problema verrà risolto in una versione futura.
Problemi relativi al debug
- L'avvio del debug può non riuscire per diversi motivi. Se nella finestra Output non è presente un errore chiaro, verificare prima di tutto di usare la configurazione di esecuzione di ".NET MAUI" in Visual Studio Code.
- È possibile provare una compilazione della riga di comando dal terminale per verificare se l'errore si verifica con il codice o l'estensione MAUI .NET. Ad esempio, è possibile eseguire
dotnet build -f:net8.0-android
per verificare se la compilazione android ha esito positivo all'esterno di Visual Studio Code. Se la compilazione ha esito positivo, segnalare un problema
Limitazioni note
Questa estensione è ancora in anteprima anticipata, quindi esistono diverse limitazioni note. Inviare commenti e suggerimenti su altre funzionalità che si desidera visualizzare man mano che si continua a creare questa nuova esperienza.
- Le funzionalità di modifica XAML sono molto leggere: ottieni l'evidenziazione della sintassi di base e il completamento automatico. Verrà illustrato come migliorare l'esperienza XAML in una versione futura.
- Attualmente, non è possibile cambiare il framework di destinazione per IntelliSense (mostrerà l'evidenziazione della sintassi solo per il primo framework di destinazione elencato nel file con estensione csproj). Questa funzionalità è in corso.
- I Ricaricamento rapido XAML e .NET non sono attualmente supportati.
- Questa estensione non è ancora stata testata completamente con le versioni beta di iOS e Xcode più recenti.
Inviaci commenti e suggerimenti su altre funzionalità che vuoi vedere mentre continuiamo a creare questa nuova esperienza.
Fornire commenti
Leggere le domande frequenti su C# Dev Kit e verificare i problemi noti esistenti prima di inviare un nuovo problema o un suggerimento. È possibile inviare suggerimenti e problemi dall'interno di Visual Studio Code tramite la finestra di dialogo Segnala problemi della Guida>. Assicurarsi di selezionare "Un'estensione" e quindi l'estensione MAUI .NET nell'elenco a discesa.