Compartir a través de

Requisito de Xcode

Cada versión de .NET para cargas de trabajo de iOS, tvOS, Mac Catalyst o macOS requiere una versión específica de Xcode.

En nuestras notas de la versión indicamos la versión exacta de Xcode para cada lanzamiento.

Nota:

En algunos escenarios limitados, el uso de una versión diferente de Xcode puede funcionar, pero esto no se admite, aunque no haya errores de compilación ni advertencias.

Nuevas cargas de trabajo

Una nueva versión de una carga de trabajo puede requerir una versión diferente de Xcode. Esto suele ocurrir siempre que Apple publique una nueva versión de Xcode: poco después publicamos nuevas versiones de las cargas de trabajo, lo que admite la nueva versión de Xcode. Por lo tanto, la actualización de las cargas de trabajo terminará requiriendo una nueva versión de Xcode.

Esto suele manifestarse con un error de compilación similar al siguiente:

Esta versión de Microsoft.iOS requiere el SDK de iOS 18.4 (incluido con Xcode 16.3). La versión actual de Xcode es la 16.2. Instale Xcode 16.3 o use una versión diferente de Microsoft.iOS. Consulte https://aka.ms/xcode-requirement para obtener más información.

o:

Esta versión de .NET para iOS (18.4.9288) requiere Xcode 16.3. La versión actual de Xcode es la 16.2. Instale Xcode 16.3 o use una versión diferente de .NET para iOS. Consulte https://aka.ms/xcode-requirement para obtener más información.

La solución más sencilla suele ser actualizar a la versión de Xcode que menciona el mensaje de error.

También es posible instalar una versión anterior de la carga de trabajo correspondiente para evitar tener que actualizar Xcode.

En algunos casos, la versión más reciente de Xcode también requiere actualizar a una versión principal más reciente de macOS (esto suele ocurrir alrededor de abril cada año). Si no se admite la nueva versión de macOS en el hardware actual del desarrollador, la única opción es usar una versión anterior de la carga de trabajo (o obtener nuevo hardware).

Nuevo Xcode

Hay un período de tiempo entre que Apple publica una nueva versión de Xcode y nosotros lanzamos compatibilidad con esta nueva versión de Xcode. A veces, macOS actualizará automáticamente la versión instalada de Xcode, lo que puede causar problemas durante este período de tiempo.

La solución más sencilla consiste en instalar varias versiones de Xcode y seleccionar la versión de Xcode que se corresponda con el requisito de Xcode para las cargas de trabajo instaladas.

Nota:

Se recomienda deshabilitar las actualizaciones automáticas en app Store en macOS para evitar este escenario.

Instalación de varias versiones de Xcode

Es posible tener varias versiones de Xcode instaladas simultáneamente.

Esto se puede realizar con los pasos siguientes:

  • Vaya al sitio de descargas para desarrolladores de Apple .
  • Inicie sesión con su id. de Apple.
  • Busque las versiones deseadas de Xcode.
  • Descargue los .xip archivos.
  • Extraiga los archivos haciendo doble clic en ellos.
  • Cambie el nombre de Xcode.app en la carpeta Descargas a algo más descriptivo (por ejemplo, Xcode_15.app).
  • Mueva el objeto extraído *.app al /Applications/ directorio.

Nota:

Hemos visto problemas extraños si se cambia el nombre de la aplicación Xcode después de que se abra al menos una vez, por lo tanto, se recomienda cambiar el nombre de la aplicación justo después de descargarla y extraerla.

Una vez instaladas las versiones deseadas de Xcode, los desarrolladores pueden elegir entre ellas desde Xcode (menú Xcode - Settings ->> Locations -> Command Line Tools) o mediante la xcode-select herramienta desde la línea de comandos:

$ sudo xcode-select --switch /Applications/Xcode_15.app

Importante

El archivo ~/Library/Preferences/Xamarin/Settings.plist también se puede usar para elegir una versión específica de Xcode y este archivo tendrá prioridad sobre la configuración especificada en Xcode o en la línea de comandos mediante xcode-select. Para evitar confusiones, se recomienda simplemente eliminar este archivo.

Instalación de una versión anterior de una carga de trabajo

Se instala una versión específica de una carga de trabajo mediante un conjunto de cargas de trabajo.

La versión exacta del conjunto de cargas de trabajo no es predecible con antelación, pero se indica la versión del conjunto de cargas de trabajo para una versión de carga de trabajo específica con cada versión: https://github.com/dotnet/macios/releases.

Este es un ejemplo de nuestra versión con compatibilidad con Xcode 16.3:

$ dotnet workload install ios --version 9.0.203

Preguntas más frecuentes

¿Es seguro actualizar mi Xcode?

Es posible comprobar si hemos publicado compatibilidad con una versión determinada de Xcode examinando nuestra lista de versiones.

Si hemos publicado compatibilidad con una versión determinada de Xcode, es seguro actualizar a esa versión de Xcode (esto también incluye desarrolladores de MAUI). Puede haber otros documentos en otro lugar que indiquen que alguna versión anterior de Xcode es la versión admitida; esos documentos suelen retardar nuestras versiones hasta cierto punto.

Lo contrario también es cierto: si no hemos publicado compatibilidad con una versión determinada de Xcode, es probable que la actualización de Xcode cause problemas. Para los desarrolladores que desean una versión más reciente de Xcode, la mejor solución en este caso es instalar varias versiones de Xcode.

  • Last updated on