Instalación

El desarrollo de aplicaciones nativas multiplataforma de .NET Multi-platform App UI (.NET MAUI) requiere Visual Studio 2022 17.12 o posterior, o la versión más reciente de Visual Studio Code con la extensión MAUI de .NET.

Visual Studio

Para empezar a desarrollar aplicaciones .NET MAUI nativas multiplataforma en Windows, instale Visual Studio 2022 17.12 o posterior siguiendo los pasos de instalación .

Requisitos previos

• Visual Studio 2022 17.12 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 y Mac Catalyst, también necesitará lo siguiente:

• Un equipo Mac compatible con Xcode. Para obtener más información, vea la documentación sobre los requisitos mínimos de Apple.
• Una versión específica de Xcode, que depende de la versión de .NET MAUI que esté usando. Para obtener información, vea versiones de versión.
• Un ID de Apple y una inscripción de pago en Apple Developer Program. Se requiere un ID de Apple para implementar aplicaciones en dispositivos y enviar aplicaciones a Apple Store.

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:

• Una cuenta de desarrollador de Apple y una suscripción de pago a Apple Developer Program.

Instalación

1. Para crear aplicaciones .NET MAUI, deberá descargar la versión más reciente de Visual Studio 2022:

   • Descargar Visual Studio 2022 Community

   • Descargar Visual Studio 2022 Professional

   • Descargar Visual Studio 2022 Enterprise

2. Instale Visual Studio o modifique la instalación existente a través del instalador de Visual Studio e instale la carga de trabajo desarrollo de la interfaz de usuario de aplicaciones multiplataforma de .NET con sus opciones de instalación opcionales predeterminadas:

   

Visual Studio Code

Para empezar a desarrollar aplicaciones .NET MAUI nativas multiplataforma en Windows, macOS o Linux, instale la versión más reciente de Visual Studio Code siguiendo los pasos de instalación de .

Requisitos previos

Para compilar, firmar e implementar aplicaciones .NET MAUI para iOS y Mac Catalyst, necesitará lo siguiente:

• Un equipo Mac compatible con Xcode. Para obtener más información, vea la documentación sobre los requisitos mínimos de Apple.
• Una versión específica de Xcode, que depende de la versión de .NET MAUI que esté usando. Para obtener información, vea versiones de versión.
• Un ID de Apple y una inscripción de pago en Apple Developer Program. Se requiere un ID de Apple para implementar aplicaciones en dispositivos y enviar aplicaciones a Apple Store.

Instalación de Visual Studio Code

1. Para crear aplicaciones .NET MAUI, deberá descargar la versión más reciente de Visual Studio Code:

   • Descargar Visual Studio Code

2. Instale Visual Studio Code. Para obtener instrucciones detalladas sobre cómo instalar Visual Studio Code, consulte Visual Studio Code en Windows, Visual Studio Code en macOSy Visual Studio Code en Linux.

Instalación de la extensión MAUI de .NET

Para poder crear aplicaciones MAUI de .NET en Visual Studio Code, deberá instalar la extensión MAUI de .NET:

1. Inicie Visual Studio Code.

2. En Visual Studio Code, vaya a la pestaña Extensiones y busque ".NET MAUI". A continuación, seleccione la extensión de .NET MAUI e instálela presionando el botón Instalar:

   

   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. Para obtener más información sobre el Kit de desarrollo de C#, consulte Kit de desarrollo de C# para Visual Studio Code.

Conexión de la cuenta al Kit de desarrollo de C#

El uso del Kit de desarrollo de C# requiere que inicie sesión con una cuenta microsoft que tenga una suscripción activa de Visual Studio:

1. En la pestaña Bienvenida para empezar a trabajar con .NET MAUI, presione el botón Conectar:

   

   Siga las indicaciones para iniciar sesión en su cuenta de Microsoft. Para obtener más información, consulte Iniciar sesión en el Kit de Desarrollo de C#.

Para obtener más información sobre las licencias del Kit de desarrollo de C#, consulte preguntas más frecuentes sobre el kit de desarrollo de C#.

Configuración del entorno de .NET

Necesitará el SDK de .NET instalado en la máquina para desarrollar aplicaciones .NET MAUI. Si no tiene instalado el SDK de .NET en el equipo, el enfoque preferido para instalarlo en Windows es a través del Instalador de Visual Studio. Para obtener más información, vea Instalación.

Como alternativa, para instalar manualmente el SDK de .NET:

1. Descargue el instalador de .NET de .

2. Instale el SDK de .NET mediante la ejecución del instalador de .NET. Para obtener más información, consulte Instalación de .NET en Windows, Linux y macOS.

   Sugerencia (if "Tip" is meant as advice or a suggestion)

   En Linux, puede instalar el SDK de .NET mediante las instrucciones de instalación con scripts de .

Para comprobar que el SDK de .NET está instalado:

1. Abra un terminal.

2. En el terminal, ejecute el siguiente comando:

   dotnet --version
   

   Debería ver la versión del SDK de .NET que ha instalado.

   Nota:

   Es posible que sea necesario reiniciar la máquina antes de comprobar que está instalado el SDK de .NET.

Configuración del entorno de MAUI de .NET

Necesitará tener instalado el SDK de .NET MAUI en su máquina para desarrollar aplicaciones .NET MAUI. Si no tiene instalado el SDK de MAUI de .NET en el equipo, el enfoque preferido para instalarlo en Windows es a través del Instalador de Visual Studio. Para obtener más información, vea Instalación.

Como alternativa, para instalar manualmente el SDK de MAUI de .NET:

1. Abra un terminal.

2. En el terminal de Windows, ejecute el siguiente comando:

   dotnet workload install maui
   

   En el terminal de macOS, ejecute el siguiente comando:

   sudo dotnet workload install maui
   

   En el terminal en Linux, ejecute el siguiente comando:

   dotnet workload install maui-android
   

Para comprobar que el SDK de MAUI de .NET está instalado:

1. Abra un terminal.

2. En el terminal, ejecute el siguiente comando:

   dotnet workload list
   

   En Windows y macOS, debería ver el ID de carga de trabajo maui junto con la versión instalada. Sin embargo, si lo ha instalado a través del Instalador de Visual Studio en Windows se muestran los siguientes identificadores de carga de trabajo:

   android
   maui-windows
   maccatalyst
   ios
   

   En Linux, debería poder ver el identificador de carga de trabajo maui-android listado junto con la versión instalada.

Configuración de plataformas de destino

Para compilar y depurar una aplicación MAUI de .NET, deberá tener una plataforma de destino válida en relación con el sistema operativo de la máquina de desarrollo. En la tabla siguiente se enumeran las plataformas de destino admitidas en cada sistema operativo:

El sistema operativo	Plataformas de destino compatibles
Windows	Windows, Android
macOS	Android, iOS, macOS
Linux	Androide

La creación de una aplicación MAUI de .NET para Android y para plataformas Apple requiere que deba realizar ajustes y configuraciones adicionales.

Androide

Para configurar tu máquina para el desarrollo de .NET MAUI en Android con Visual Studio Code, sigue estos pasos:

• Descargue e instale el SDK de Java para obtener más información, consulte Descargar e instalar el JDK de Java.
• Descargue e instale Android SDK. Para obtener más información, consulte Descargar e instalar android SDK.
• Descargue e instale un emulador de Android. Para obtener más información, consulte Descargar e instalar un emulador de Android.

Descarga e instalación del SDK de Java

Para descargar e instalar el SDK de Java y configurar Visual Studio Code para usarlo:

1. Descargue e instale Microsoft OpenJDK 17. Para obtener información sobre cómo instalar OpenJDK, vea Install the Microsoft Build of OpenJDK.

   Como alternativa, en lugar de descargar e instalar manualmente el SDK de Java, puede usar el destino de compilación de InstallAndroidDependencies para instalar el SDK de Java (y android SDK). Para obtener más información, vea Using the InstallAndroidDependencies target.

   Importante

   Asegúrese de que tenga en cuenta la ubicación en la que está instalado OpenJDK, ya que esto es necesario en el paso siguiente.

2. Asegúrese de que ha configurado la ruta de acceso a OpenJDK mediante uno de los métodos siguientes:

   1. Establezca la variable de entorno JAVA_HOME para definir la ruta de acceso del SDK de Java para la máquina. Este es el enfoque recomendado, que define la ruta de acceso del SDK de Java en el nivel de máquina.

      Nota:

      Si instala OpenJDK en Windows a través de MSI, puede optar por la configuración del instalador de la variable de entorno JAVA_HOME.

   2. En Visual Studio Code, presione CTRL+MAYÚS+P en Windows o CMD+MAYÚS+P en macOS y, a continuación, seleccione .NET MAUI: Configurar Android, seguido de Seleccionar ubicación del SDK de Java para establecer la ruta de acceso del SDK de Java en el nivel de usuario o área de trabajo.

   3. Configure la ruta de acceso del SDK de Java en el archivo .csproj estableciendo la propiedad $(JavaSdkDirectory) MSBuild en la ruta de acceso de OpenJDK. Esto definirá la ruta del SDK de Java en el nivel de proyecto.

Descarga e instalación del SDK de Android

Para descargar e instalar Android SDK y configurar Visual Studio Code para usarlo:

1. Descargue e instale Android SDK mediante uno de los métodos siguientes:

   1. Descargue e instale Android SDK mediante la creación de un nuevo proyecto MAUI de .NET y, a continuación, use el destino de compilación de InstallAndroidDependencies, lo que ayuda a configurar el entorno de Android. Este es el enfoque recomendado. Para obtener más información, vea Using the InstallAndroidDependencies target.
   2. Descargue e instale el Android SDK en Windows mediante la instalación de la carga de trabajo de desarrollo de .NET MAUI en Visual Studioy luego crear y ejecutar una aplicación de .NET MAUI en Android. Este proceso garantizará que android SDK y android emulator estén instalados.
   3. Descargue e instale Android SDK a través de Android Studio. Para obtener más información, consulte Instalación de Android Studio en developer.android.com.
   4. Descargue e instale Android SDK a través del administrador de paquetes preferido en Linux.

2. Asegúrese de que ha configurado la ruta de acceso al SDK de Android mediante uno de los métodos siguientes:

   1. Establezca la variable de entorno ANDROID_HOME para definir la ruta de acceso del SDK de Android para la máquina. Este es el enfoque recomendado, que define la ruta de acceso de Android SDK en el nivel de máquina.
   2. En Visual Studio Code, presione CTRL+MAYÚS+P en Windows o CMD+MAYÚS+P en macOS y, a continuación, seleccione .NET MAUI: Configurar Android, seguido de Seleccionar ubicación de Android SDK para establecer la ruta de acceso de Android SDK en el nivel de usuario o área de trabajo.
   3. Configure la ruta de acceso de Android SDK en el archivo .csproj estableciendo la propiedad $(AndroidSdkDirectory) MSBuild en la ruta de acceso de Android SDK. Esto definirá la ruta de acceso de Android SDK en el nivel de proyecto.

3. En Visual Studio Code, compruebe que el entorno android está configurado correctamente presionando CTRL+MAYÚS+P en Windows o CMD+MAYÚS+P en macOS y, después, seleccionando .NET MAUI: Configurar Android, seguido de Actualizar entorno android. Se deben solucionar los errores detectados:

   • En la paleta de comandos, seleccione .NET MAUI: Configurar Android, seguido de Seleccionar ubicación de Android SDK y Seleccionar ubicación de Android SDK, y verifique que correctamente apuntan a las ubicaciones de instalación de cada uno. En Windows, si instala los SDK a través de Visual Studio, OpenJDK se ubicará en C:\Archivos de programa\Microsoft y Android SDK se ubicará en C:\Archivos de programa (x86)\Android\android-sdk.
   • Asegúrese de que la carpeta de Android SDK tenga subcarpetas, como herramientas de compilación, cmdline-toolsy herramientas de plataforma.
   • Asegúrese de que la carpeta OpenJDK tenga subcarpetas, como bin, lib, etc.
   • Asegúrese de que la variable de entorno ANDROID_HOME esté establecida en la ruta de acceso de Android SDK.
   • Asegúrese de que la variable de entorno JAVA_HOME esté establecida en la ruta de acceso del SDK de Java.
   • Si no se han aceptado las licencias de Android, en una terminal con permisos elevados, navegue hasta el directorio cmdline-tools/{versión}/bin y ejecute el comando sdkmanager --licenses y luego siga las instrucciones de la línea de comandos.

Uso del destino de InstallAndroidDependencies

El enfoque recomendado para instalar las dependencias necesarias para el proyecto MAUI de .NET en Android es ejecutar el destino de MSBuild InstallAndroidDependencies. Esta opción instalará el Android SDK por ti, si no está ya instalado.

En un terminal, cree un nuevo proyecto maui de .NET:

dotnet new maui -n "MyMauiApp"

En un terminal, cambie el directorio a MyMauiAppy compile la aplicación al especificar el destino de compilación de InstallAndroidDependencies:

cd MyMauiApp
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True

Nota:

El destino InstallAndroidDependencies de MSBuild también puede llevar a cabo la instalación del SDK de Java si se proporciona la propiedad JavaSdkDirectory de MSBuild.

En el comando anterior:

• -p:AndroidSdkDirectory="/path/to/sdk" instala o actualiza las dependencias de Android en la ruta de acceso absoluta especificada. Las rutas de acceso sugeridas son %LOCALAPPDATA%/Android/Sdk en Windows y $HOME/Library/Android/sdk en macOS.
• -p:AcceptAndroidSDKLicenses=True acepta las licencias de Android necesarias para el desarrollo.
• (opcional) -p:JavaSdkDirectory="/path/to/sdk" instala el SDK de Java en la ruta de acceso absoluta especificada.

Intente evitar el uso de rutas de acceso que contengan espacios o caracteres que no sean ASCII.

Descarga e instalación de un emulador de Android

Para descargar e instalar un emulador de Android en el que ejecutar las aplicaciones:

1. En un terminal, vaya al {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.

2. En un terminal, use el comando sdkmanager para descargar e instalar un emulador de Android:

   En Windows, ejecute los siguientes comandos:

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

   En macOS, ejecute los siguientes comandos:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-35;google_apis;arm64-v8a"
   

   Nota:

   En el comando anterior se asume un Mac con Apple Silicon. Para un equipo Mac Intel, reemplace arm64-v8a por x86_64.

   Para obtener más información sobre el comando sdkmanager, consulte sdkmanager en developer.android.com.

3. En un terminal, use el comando avdmanager para crear un nuevo emulador de Android:

   En Windows, ejecute los siguientes comandos:

   avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;x86_64"
   

   En macOS, ejecute los siguientes comandos:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;arm64-v8a"
   

   Nota:

   En el comando anterior se asume un Mac con Apple Silicon. Para un equipo Mac Intel, reemplace arm64-v8a por x86_64.

   Para obtener más información sobre el comando avdmanager, consulte avdmanager en developer.android.com.

iOS y macOS

Para configurar tu Mac para el desarrollo con .NET MAUI en iOS y Mac Catalyst con Visual Studio Code:

1. 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 la App Store de Apple.

2. En un terminal, ejecute el siguiente comando para adquirir las herramientas de línea de comandos de Xcode:

   xcode-select --install
   

3. Inicie Xcode y acepte los contratos de licencia. Si los simuladores no se empiezan a instalar, vaya a Xcode > Configuración > Componentes e instale los entornos de ejecución de los simuladores que elija.

4. En Visual Studio Code, compruebe que el entorno de Apple está configurado correctamente presionando CMD+MAYÚS+P y seleccionando .NET MAUI: Configurar Apple, seguido de Actualizar entorno de Apple. Se deben solucionar los errores detectados:

   • Asegúrese de que ha ejecutado xcode-select --install en un terminal.
   • Si recibe un error que indica que no se ha encontrado Xcode, ejecute xcode-select -p en un terminal y compruebe que devuelve una ruta de acceso a la instalación de Xcode.
   • Abra Xcode para asegurarse de que se carga correctamente y, a continuación, vaya a Xcode > Configuración > Ubicación y compruebe que el campo herramientas de línea de comandos de apunta a la instalación correcta de Xcode.

Solución de problemas

Si encuentra problemas al instalar la extensión MAUI de .NET en Visual Studio Code, puede encontrar más información sobre los problemas; para ello, vaya a la ventana salida de (CTRL+MAYÚS+U en Windows o CMD+MAYÚS+U en macOS) y seleccione .NET MAUI en la lista desplegable.

Envío de comentarios

Para proporcionar comentarios sobre la extensión MAUI de .NET desde Visual Studio Code, vaya al cuadro de diálogo Ayuda > Informe de problemas. A continuación, asegúrese de seleccionar "Informe de errores" como el valor de la lista desplegable del , "Extensión de VS Code" como el valor de la lista desplegable para, y ".NET MAUI" como el valor de la lista desplegable de la extensión :

Visual Studio Code (Experimental)

Requisitos previos

Para compilar, firmar e implementar aplicaciones .NET MAUI para iOS y Mac Catalyst, necesitará lo siguiente:

• Un equipo Mac compatible con Xcode. Para obtener más información, vea la documentación sobre los requisitos mínimos de Apple.
• Una versión específica de Xcode, que depende de la versión de .NET MAUI que esté usando. Para obtener información, vea versiones de versión.
• Un ID de Apple y una inscripción de pago en Apple Developer Program. Se requiere un ID de Apple para implementar aplicaciones en dispositivos y enviar aplicaciones a Apple Store.

Para empezar a desarrollar aplicaciones .NET MAUI nativas multiplataforma en Windows, macOS o Linux, instale la versión más reciente de Visual Studio Code siguiendo los pasos de instalación de .

Para compilar y depurar una aplicación MAUI de .NET, deberá tener una plataforma de destino válida en relación con el sistema operativo de la máquina de desarrollo. En la tabla siguiente se enumeran las plataformas de destino admitidas en cada sistema operativo:

El sistema operativo	Plataformas de destino compatibles
Windows	Windows, Android
macOS	Android, iOS, macOS
Linux	Androide

Instalación de Visual Studio Code

1. Para crear aplicaciones .NET MAUI, deberá descargar la versión más reciente de Visual Studio Code:

   • Descargar Visual Studio Code

2. Instale Visual Studio Code. Para obtener instrucciones detalladas sobre cómo instalar Visual Studio Code, consulte Visual Studio Code en Windows, Visual Studio Code en macOSy Visual Studio Code en Linux.

Instalación de la extensión MAUI de .NET

Para poder crear aplicaciones MAUI de .NET en Visual Studio Code, deberá instalar la extensión MAUI de .NET:

1. Inicie Visual Studio Code.

2. En Visual Studio Code, vaya a la pestaña Extensiones y busque ".NET MAUI". A continuación, seleccione la extensión de .NET MAUI e instálela presionando el botón Instalar:

   

   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. Para obtener más información sobre el Kit de desarrollo de C#, consulte Kit de desarrollo de C# para Visual Studio Code.

Siga los pasos del tutorial.

Una vez que instale la extensión MAUI de .NET, el tutorial de .NET MAUI le dará la bienvenida, "Introducción a .NET MAUI".

Importante

Para acceder a la experiencia de configuración mejorada, la configuración de Maui > : Experiencia de configuración mejoradadebe estar activada.

Haga clic y siga las indicaciones de cada paso para configurar completamente el entorno de .NET MAUI y las plataformas de destino:

1. Conexión de la cuenta a la extensión del Kit de desarrollo de C#
2. Configuración del entorno de .NET
3. Configuración del entorno de MAUI de .NET
4. Configuración del entorno de iOS y macOS
5. Configuración del entorno de Android

Nota:

Tendrá que estar en un equipo Mac para ver y seguir el paso Configurar el entorno de iOS y macOS .

El paso Configurar el entorno de Android configurará todo lo que necesita para tener éxito con Android como plataforma de destino y el paso Configurar el entorno de iOS y macOS configurará todo lo que necesita para tener éxito con iOS y Mac como plataformas de destino.

También se puede acceder a este tutorial desde la paleta de comandos. Seleccione Bienvenida: Abrir tutorial... seguido de Introducción a .NET MAUI.

Acceso a la experiencia de configuración mejorada

1. En Visual Studio Code, presione CTRL+MAYÚS+P en Windows o CMD+MAYÚS+P en macOS, seleccione Preferencias: Abrir configuración (UI).

   

2. Vaya a Extensiones > .NET MAUI y active la opción Configuración de Maui > : Experiencia de configuración mejorada .

   

3. Vuelva al tutorial Introducción a .NET MAUI . Asegúrese de que puede ver Configurar el entorno de Android entre otros pasos en el tutorial.

   

Conexión de la cuenta al Kit de desarrollo de C#

El uso del Kit de desarrollo de C# requiere que inicie sesión con una cuenta microsoft que tenga una suscripción activa de Visual Studio:

1. En la pestaña Bienvenida para empezar a trabajar con .NET MAUI, presione el botón Conectar:

   

   Siga las indicaciones para iniciar sesión en su cuenta de Microsoft. Para obtener más información, consulte Iniciar sesión en el Kit de Desarrollo de C#.

Para obtener más información sobre las licencias del Kit de desarrollo de C#, consulte preguntas más frecuentes sobre el kit de desarrollo de C#.

Configuración del entorno de .NET

Necesitará el SDK de .NET instalado en la máquina para desarrollar aplicaciones .NET MAUI. Si no tiene instalado el SDK de .NET en el equipo, el enfoque preferido para instalarlo en Windows es a través del Instalador de Visual Studio. Para obtener más información, vea Instalación.

Como alternativa, para instalar manualmente el SDK de .NET:

1. Descargue el instalador de .NET de .

2. Instale el SDK de .NET mediante la ejecución del instalador de .NET. Para obtener más información, consulte Instalación de .NET en Windows, Linux y macOS.

   Sugerencia (if "Tip" is meant as advice or a suggestion)

   En Linux, puede instalar el SDK de .NET mediante las instrucciones de instalación con scripts de .

Para comprobar que el SDK de .NET está instalado:

1. Abra un terminal.

2. En el terminal, ejecute el siguiente comando:

   dotnet --version
   

   Debería ver la versión del SDK de .NET que ha instalado.

   Nota:

   Es posible que sea necesario reiniciar la máquina antes de comprobar que está instalado el SDK de .NET.

Configuración del entorno de MAUI de .NET

Necesitará tener instalado el SDK de .NET MAUI en su máquina para desarrollar aplicaciones .NET MAUI. Si no tiene instalado el SDK de MAUI de .NET en el equipo, el enfoque preferido para instalarlo en Windows es a través del Instalador de Visual Studio. Para obtener más información, vea Instalación.

Como alternativa, para instalar manualmente el SDK de MAUI de .NET:

1. Abra un terminal.

2. En el terminal de Windows, ejecute el siguiente comando:

   dotnet workload install maui
   

   En el terminal de macOS, ejecute el siguiente comando:

   sudo dotnet workload install maui
   

   En el terminal en Linux, ejecute el siguiente comando:

   dotnet workload install maui-android
   

Para comprobar que el SDK de MAUI de .NET está instalado:

1. Abra un terminal.

2. En el terminal, ejecute el siguiente comando:

   dotnet workload list
   

   En Windows y macOS, debería ver el ID de carga de trabajo maui junto con la versión instalada. Sin embargo, si lo ha instalado a través del Instalador de Visual Studio en Windows se muestran los siguientes identificadores de carga de trabajo:

   android
   maui-windows
   maccatalyst
   ios
   

   En Linux, debería poder ver el identificador de carga de trabajo maui-android listado junto con la versión instalada.

Configuración del entorno de Android

Para configurar el entorno de desarrollo de Android, basta con hacer clic en el botón Configurar entorno de Android en el paso de la guía Configurar el entorno de Android para entrar en el flujo de adquisición completo de Android.

El flujo de adquisición de Android analizará el entorno de Android y ofrecerá instalar todos los componentes que faltan:

• Sdk de Android y SDK de Java: se requieren componentes del SDK de Android y del SDK de Java.

  • El flujo de adquisición de Android le pedirá que instale estos componentes directamente o que seleccione una instalación preexistente que ya tenga.

    

  • Para configurar aún más las instalaciones del SDK y JDK, consulte instrucciones sobre cómo instalar y configurar Android manualmente.

• Emulador de Android: se recomienda instalar un emulador de Android y es necesario en ausencia de un dispositivo físico.

  • El flujo de adquisición de Android le pedirá que instale directamente un emulador predeterminado.

    

  • Para configurar más emuladores, siga las instrucciones para instalar manualmente un emulador de Android.

Importante

Las licencias de Android deberán revisarse y aceptarse manualmente en Terminal. Cuando se le solicite, revise cada licencia. Para aceptarlo, escriba "y" y presione "Entrar".

Cuando el entorno de Android se haya configurado correctamente, se le notificará: "Su entorno de Android para .NET MAUI está configurado!"

Vea el panel Salida para obtener más detalles sobre el estado del entorno de Android.

Configuración del entorno de iOS y macOS

Para configurar tu Mac para el desarrollo con .NET MAUI en iOS y Mac Catalyst con Visual Studio Code:

1. 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 la App Store de Apple.

2. En un terminal, ejecute el siguiente comando para adquirir las herramientas de línea de comandos de Xcode:

   xcode-select --install
   

3. Inicie Xcode y acepte los contratos de licencia. Si los simuladores no se empiezan a instalar, vaya a Xcode > Configuración > Componentes e instale los entornos de ejecución de los simuladores que elija.

4. En Visual Studio Code, compruebe que el entorno de Xcode está configurado simplemente haciendo clic en Configurar entorno de iOS y macOS en el paso de la guía Configurar el entorno de iOS y macOS.

Se deben solucionar los errores detectados:

• Asegúrese de que ha ejecutado xcode-select --install en un terminal.
• Si recibe un error que indica que no se ha encontrado Xcode, ejecute xcode-select -p en un terminal y compruebe que devuelve una ruta de acceso a la instalación de Xcode.
• Abra Xcode para asegurarse de que se carga correctamente y, a continuación, vaya a Xcode > Configuración > Ubicación y compruebe que el campo herramientas de línea de comandos de apunta a la instalación correcta de Xcode.

Cuando el entorno de Xcode se haya configurado correctamente, se le notificará: "Su entorno de iOS y macOS para .NET MAUI está configurado!"

Envío de comentarios

Para proporcionar comentarios sobre la extensión MAUI de .NET desde Visual Studio Code, vaya al cuadro de diálogo Ayuda > Informe de problemas. A continuación, asegúrese de seleccionar "Informe de errores" como el valor de la lista desplegable del , "Extensión de VS Code" como el valor de la lista desplegable para, y ".NET MAUI" como el valor de la lista desplegable de la extensión :

Pasos siguientes

Para obtener información sobre cómo crear y ejecutar su primera aplicación .NET MAUI en Visual Studio 2022 en Windows o Visual Studio Code, haga clic en el botón siguiente.

Cree su primera aplicación