Partager via

Exigence pour Xcode

Chaque version du .NET pour les charges de travail iOS, tvOS, Mac Catalyst ou macOS nécessite une version spécifique de Xcode.

Dans nos notes de version, nous indiquons la version exacte de Xcode pour chaque publication.

Remarque

Dans quelques scénarios limités utilisant une autre version de Xcode peut fonctionner, mais cela n’est pas pris en charge, même s’il n’y a pas d’erreurs de build ou d’avertissements.

Nouvelles charges de travail

Une nouvelle version d’une charge de travail peut nécessiter une autre version de Xcode. Cela se produit généralement chaque fois qu’Apple publie une nouvelle version de Xcode : peu après, nous publions de nouvelles versions des charges de travail, prenant en charge la nouvelle version de Xcode. La mise à jour des charges de travail nécessite donc une nouvelle version de Xcode.

Cela se manifeste souvent par une erreur de compilation comme celle-ci :

Cette version de Microsoft.iOS nécessite le SDK iOS 18.4 (fourni avec Xcode 16.3). La version actuelle de Xcode est 16.2. Installez Xcode 16.3 ou utilisez une autre version de Microsoft.iOS. Pour plus d’informations, consultez https://aka.ms/xcode-requirement.

ou:

Cette version de .NET pour iOS (18.4.9288) nécessite Xcode 16.3. La version actuelle de Xcode est 16.2. Installez Xcode 16.3 ou utilisez une autre version de .NET pour iOS. Pour plus d’informations, consultez https://aka.ms/xcode-requirement.

La solution la plus simple consiste généralement à effectuer une mise à niveau vers la version de Xcode, le message d’erreur mentionne.

Il est également possible d’installer une version antérieure de la charge de travail correspondante pour éviter d’avoir à mettre à niveau Xcode.

Dans certains cas, la version plus récente de Xcode nécessite également la mise à jour vers une version majeure plus récente de macOS (cela se produit généralement environ avril chaque année). Si la nouvelle version macOS n’est pas prise en charge sur le matériel actuel du développeur, la seule option consiste à utiliser une version antérieure de la charge de travail (ou obtenir un nouveau matériel).

Nouveau Xcode

Il existe une fenêtre de temps entre la publication d’Apple d’une nouvelle version de Xcode et la prise en charge de cette nouvelle version de Xcode. Parfois, macOS met à jour automatiquement la version installée de Xcode, ce qui peut entraîner des problèmes pendant cette période.

La solution la plus simple consiste à installer plusieurs versions de Xcode et à sélectionner la version de Xcode qui correspond à la condition Xcode pour la ou les charges de travail installées.

Remarque

Nous vous recommandons de désactiver les mises à jour automatiques dans l’App Store sur macOS afin d’éviter ce scénario.

Installation de plusieurs versions de Xcode

Il est possible d’installer simultanément plusieurs versions de Xcode.

Pour ce faire, procédez comme suit :

  • Accédez au site Téléchargements des développeurs Apple .
  • Connectez-vous avec votre ID Apple.
  • Recherchez les versions souhaitées de Xcode.
  • Téléchargez le ou les .xip fichiers.
  • Extrayez le ou les fichiers en double-cliquant dessus.
  • Renommez le Xcode.app dossier Téléchargements en quelque chose de plus descriptif (par exemple Xcode_15.app).
  • Déplacez l’extrait *.app vers le /Applications/ répertoire.

Remarque

Nous avons vu des problèmes étranges si l’application Xcode est renommée une fois qu’elle a été ouverte au moins une fois, nous vous recommandons donc de renommer l’application uniquement après le téléchargement et l’extraction.

Une fois les versions souhaitées de Xcode installées, les développeurs peuvent choisir entre eux à partir de Xcode (menu Xcode - Paramètres -> Emplacements ->> Outils en ligne de commande) ou à l’aide de l’outil xcode-select à partir de la ligne de commande :

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

Important

Le fichier ~/Library/Preferences/Xamarin/Settings.plist peut également être utilisé pour choisir une version spécifique de Xcode, et ce fichier est prioritaire sur le paramètre spécifié dans Xcode ou sur la ligne de commande à l’aide xcode-selectde . Pour éviter toute confusion, nous vous recommandons simplement de supprimer ce fichier.

Installer une version antérieure d’une charge de travail

Une version spécifique d’une charge de travail est installée à l’aide d’un ensemble de charges de travail.

La version exacte du jeu de charges de travail n’est pas prévisible à l’avance, mais nous indiquons la version du jeu de charges de travail pour une version spécifique avec chaque publication : https://github.com/dotnet/macios/releases.

Voici un exemple pour notre version avec prise en charge de Xcode 16.3 :

$ dotnet workload install ios --version 9.0.203

Questions fréquentes (FAQ)

Est-il sûr de mettre à niveau mon Xcode ?

Il est possible de vérifier si nous avons publié la prise en charge d’une version particulière de Xcode en examinant notre liste de versions.

Si nous avons publié la prise en charge d’une version particulière de Xcode, il est possible de procéder à une mise à niveau vers cette version de Xcode (cela inclut également les développeurs MAUI). Il peut y avoir d’autres documents ailleurs indiquant que certaines versions antérieures de Xcode sont la version prise en charge ; ces documents sont généralement en retard par rapport à nos versions à un certain degré.

L’inverse est également vrai : si nous n’avons pas publié la prise en charge d’une version donnée de Xcode, il est probable que la mise à niveau de Xcode provoque des problèmes. Pour les développeurs qui souhaitent une version plus récente de Xcode, la meilleure solution dans ce cas consiste à installer plusieurs versions de Xcode.

  • Last updated on