Para empezar a desarrollar aplicaciones nativas multiplataforma .NET MAUI en Windows, instala Visual Studio 2022 17.8 o posterior realizando el procedimiento de instalación siguiente.
Requisitos previos
- Visual Studio 2022 17.8 o posterior. Consulta Requisitos del sistema de Visual Studio 2022 para obtener información sobre los sistemas operativos, el hardware y los idiomas admitidos, así como requisitos e instrucciones adicionales.
Para compilar, firmar e implementar aplicaciones NET MAUI para iOS, también necesitarás lo siguiente:
Como alternativa, para implementar compilaciones de depuración de la aplicación directamente desde Windows a tu dispositivo iOS con reinicio rápido, necesitarás lo siguiente:
Instalación
Para crear aplicaciones .NET MAUI, necesitarás la versión más reciente de Visual Studio 2022:
Instala o modifica tu instalación actual de Visual Studio, e instala la carga de trabajo de desarrollo de .NET Multi-platform App UI con las opciones de instalación opcionales predeterminadas seleccionadas:
Nota:
La retirada de Visual Studio para Mac está programada para el 31 de agosto de 2024 de acuerdo con la Directiva de ciclo de vida moderno de Microsoft. Visual Studio para Mac 17.6 seguirá recibiendo soporte técnico hasta el 31 de agosto de 2024, con actualizaciones de mantenimiento para problemas de seguridad y plataformas actualizadas de Apple. Para obtener más información, incluyendo opciones alternativas para desarrollar en un Mac, consulta ¿Qué sucede con Visual Studio para Mac?.
Para empezar a desarrollar aplicaciones nativas multiplataforma .NET MAUI en macOS, instala Visual Studio 2022 para Mac 17.6 realizando el procedimiento de instalación siguiente.
Requisitos previos
Para compilar, firmar e implementar aplicaciones .NET MAUI para iOS o macOS, también necesitarás lo siguiente:
Instalación
Para crear aplicaciones .NET MAUI, necesitarás la versión más reciente de Visual Studio para Mac:
Instala Visual Studio 2022 para Mac o modifica la instalación existente y asegúrate de que están instaladas las cargas de trabajo siguientes:
- .NET
- .NET MAUI
- Android
- iOS
Importante
En el caso de las nuevas instalaciones de Visual Studio 2022 para Mac, al seleccionar la carga de trabajo de NET MAUI se seleccionarán automáticamente las cargas de trabajo de Android e iOS, que actualmente son necesarias para el desarrollo de .NET MAUI
Instala .NET 8 a través del instalador independiente.
Una vez que .NET 8 haya terminado de instalarse, ejecuta dotnet workload install maui
en un terminal.
Importante
Para usar Visual Studio para Mac con .NET 8, habilita la casilla Visual Studio >Preferencias > Otros > Características de vista previa > Usar el SDK de .NET 8 si está instalado (requiere reinicio).
Si tiene problemas de red al instalar un entorno corporativo, revise las instrucciones de instalación tras un firewall o proxy.
Instalación detrás de un firewall o servidor proxy
Para instalar Visual Studio 2022 para Mac detrás de un firewall, es necesario que determinados puntos de conexión sean accesibles para permitir la descarga de las herramientas y las actualizaciones necesarias para el software. Para obtener más información sobre cómo configurar la red para permitir el acceso a los puntos de conexión necesarios, consulta Instalación y uso de Visual Studio para Mac detrás de un firewall o servidor proxy.
Nota:
La compatibilidad con .NET MAUI en Visual Studio Code todavía está en versión preliminar. Pruébalo y comparte tus comentarios
Instalación de Visual Studio Code y la extensión .NET MAUI
Instale Visual Studio Code.
En la pestaña Extensions, busca ".NET MAUI" e instala la extensión .NET MAUI. La extensión .NET MAUI instala automáticamente las extensiones C# Dev Kit y C#, que son necesarias para que se ejecute la extensión .NET MAUI.
Nota:
La extensión .NET MAUI requiere las extensiones C# Dev Kit y C# de versión preliminar. Debes iniciar sesión en C# Dev Kit para usar la funcionalidad de la extensión .NET MAUI. Consulta esta entrada de blog para obtener más información sobre C# Dev Kit y su familia de extensiones.
Instalación de cargas de trabajo de .NET y .NET MAUI
Instale .NET 8.
En Windows, se recomienda usar el instalador de Visual Studio para administrar las instalaciones de cargas de trabajo de .NET y .NET MAUI. Aquí puedes encontrar instrucciones sobre cómo usar el instalador de Visual Studio.
Instala la carga de trabajo de .NET MAUI.
En Windows y macOS, ejecuta el siguiente comando en un terminal:
dotnet workload install maui
En Linux, ejecuta el siguiente comando en un terminal:
dotnet workload install maui-android
A fin de depurar una aplicación de .NET MAUI en Visual Studio Code, debes tener una plataforma de destino válida para el sistema operativo de la máquina de desarrollo:
El sistema operativo |
Plataformas de destino compatibles |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS y macOS
Para depurar en un destino de iOS o macOS en Visual Studio Code, haz lo siguiente:
- Instale la versión de Xcode que requiere la versión de .NET MAUI que está usando. Para obtener información, vea versiones de versión. La versión estable de Xcode más reciente se puede descargar desde Mac App Store.
- Ejecuta
xcode-select --install
en un terminal para adquirir las herramientas de línea de comandos de Xcode.
Android
Para depurar en un destino de Android en Visual Studio Code, haz lo siguiente:
- Instala Microsoft OpenJDK 17.
- Instala Android SDK mediante uno de los métodos siguientes:
- (Recomendado) Crear un nuevo proyecto de .NET MAUI (
dotnet new maui
) y usar el destino de InstallAndroidDependencies.
- Instalación mediante Visual Studio (Windows únicamente).
- Instala a través de Android Studio.
- Instalar mediante el administrador de paquetes preferido en Linux.
Solución de problemas
Es posible que tengas problemas a la hora de configurar la extensión de .NET MAUI para Visual Studio Code. Si aún tienes problemas después de seguir los pasos siguientes para solucionarlos, notifica un problema.
Creación de un proyecto
Si intentas crear un nuevo proyecto y el explorador de archivos sigue apareciendo en un bucle infinito, es posible que no selecciones una carpeta vacía. Comprueba que no haya archivos o carpetas ocultos, crea una nueva carpeta o crea tu aplicación .NET MAUI desde la línea de comandos mediante dotnet new maui
.
Uso del destino de InstallAndroidDependencies
.NET 8 tiene un destino de compilación que te ayuda a configurar tu entorno de Android. Ejecuta el siguiente comando en un terminal para configurar la máquina y el entorno de Android:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
En el comando anterior:
AndroidSdkDirectory="<AndroidSdkPath>"
: instala o actualiza las dependencias de Android en la ruta de acceso absoluta especificada.
- Windows: la ruta de AndroidSdkPath sugerida es
%LOCALAPPDATA%/Android/Sdk
.
- MacOS: la ruta de AndroidSdkPath sugerida es
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: instala Java en la ruta de acceso absoluta especificada.
AcceptAndroidSDKLicenses=True
: acepta las licencias de Android necesarias para el desarrollo.
Hay un error que indica que no se encontró el SDK de Android o el SDK de Java
- Abre la paleta de comandos (Ctrl/Cmd + Mayús + P) y busca el comando
.NET MAUI: Configure Android
. Selecciona "Establecer ruta de acceso de Android SDK" y "Establecer ruta de acceso de Android JDK" y comprueba que apuntan a las instalaciones de cada uno.
- La carpeta Android SDK debe tener subcarpetas como
build-tools
, cmdline-tools
y platform-tools
.
- La carpeta Java OpenJDK debe tener subcarpetas como
bin
, lib
, entre otras.
- En Windows, si instalas a través de Visual Studio, el SDK de Java estará en
C:\Program Files\Microsoft\
y el SDK de Android estará en C:\Program Files (x86)\Android\android-sdk
.
- Establece la variable de entorno
JAVA_HOME
en una ruta de acceso de OpenJDK de Java válida.
- Establece la variable de entorno
ANDROID_HOME
para tu ruta de acceso del SDK de Android.
- Comprueba las versiones mínimas de las dependencias de Android instaladas:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- platforms;android-34*
- .NET 7: platform-tools = 33.0.2
- .NET 8: platform-tools = 34.0.5
Hay un error que indica que no se aceptan las licencias de Android
En un símbolo del sistema o terminal con privilegios elevados, ve a la carpeta cmdline-tools/latest/bin/
del SDK de Android, ejecuta sdkmanager --licenses
y después sigue las indicaciones de la CLI.
Mis dependencias de Android no se están cargando en el Explorador de soluciones, pero mi aplicación se compila correctamente
Este comportamiento es un problema conocido de la instalación de %APPDATA%
en Windows y se corregirá en una futura versión.
Configuración de iOS/Xcode
- Si recibes un error de que no se encuentra Xcode, ejecuta
xcode-select --install
en un terminal y comprueba que xcode-select -p
apunta a la instalación de Xcode.
- Si sigues teniendo problemas, abre el propio Xcode para asegurarte de que se carga correctamente. Una vez abierto Xcode, ve a Xcode > Settings > Locations y comprueba que el campo Command Line Tools apunta al Xcode correcto.
- Existe un problema conocido que obliga, en ocasiones, a compilar la aplicación de iOS/macOS dos veces para su implementación. Esto se corregirá en una próxima versión.
Problemas de depuración
- La depuración puede fallar por varias razones. Si no hay un error claro en la ventana Salida, comprueba primero que estés usando la configuración de ejecución ".NET MAUI" en Visual Studio Code.
- Puedes probar una compilación de línea de comandos desde el terminal para ver si el error está con el código o la extensión de .NET MAU Por ejemplo, puedes ejecutar
dotnet build -f:net8.0-android
para ver si la compilación de Android se realiza correctamente fuera de Visual Studio Code. Si esta compilación se realiza correctamente, Notifica un problema
Limitaciones conocidas
Esta extensión todavía está en versión preliminar temprana, por lo que hay una serie de limitaciones conocidas. Envíanos tus comentarios sobre otras características que te gustaría ver a medida que seguimos creando esta nueva experiencia.
- Las funcionalidades de edición de XAML son muy ligeras: obtienes resaltado de sintaxis básico y autocompletar. Estamos estudiando cómo mejorar la experiencia de XAML en una futura versión.
- Actualmente, no puedes cambiar la plataforma de destino para IntelliSense (mostrará el resaltado de sintaxis solo para la primera plataforma de destino que aparece en el archivo .csproj). Esta funcionalidad está en curso.
- La recarga activa de XAML y .NET no se admiten actualmente.
- Esta extensión aún no se ha probado completamente con las versiones beta de iOS y Xcode más recientes.
Envíanos tus comentarios sobre otras características que te gustaría ver a medida que seguimos creando esta nueva experiencia.
Proporcionar comentarios
Lee las Preguntas más frecuentes sobre el Kit de desarrollo de C# y consulta los Problemas conocidos existentes antes de presentar un nuevo problema o sugerencia. Puedes presentar sugerencias y problemas desde Visual Studio Code a través del cuadro de diálogo Ayuda > Notificar problema. Asegúrate de seleccionar "Una extensión" y luego la extensión de .NET MAUI en la lista desplegable.