Delen via

Xcode-vereiste

Voor elke versie van de .NET voor iOS-, tvOS-, Mac Catalyst- of macOS-workloads is een specifieke versie van Xcode vereist.

In onze releasenotes vermelden we de exacte Xcode-versie voor elke release.

Opmerking

In een paar beperkte scenario's die een andere versie van Xcode gebruiken, kan dit werken, maar dit wordt niet ondersteund, zelfs als er geen buildfouten of waarschuwingen zijn.

Nieuwe workloads

Voor een nieuwe versie van een workload is mogelijk een andere versie van Xcode vereist. Dit gebeurt meestal wanneer Apple een nieuwe versie van Xcode publiceert: kort daarna brengen we nieuwe versies van de workloads uit, die de nieuwe versie van Xcode ondersteunen. Het bijwerken van de workloads vereist dus een nieuwe versie van Xcode.

Dit manifesteert vaak met een buildfout als volgt:

Voor deze versie van Microsoft.iOS is de iOS 18.4 SDK vereist (geleverd met Xcode 16.3). De huidige versie van Xcode is 16.2. Installeer Xcode 16.3 of gebruik een andere versie van Microsoft.iOS. Zie https://aka.ms/xcode-requirement voor meer informatie.

of:

Voor deze versie van .NET voor iOS (18.4.9288) is Xcode 16.3 vereist. De huidige versie van Xcode is 16.2. Installeer Xcode 16.3 of gebruik een andere versie van .NET voor iOS. Zie https://aka.ms/xcode-requirement voor meer informatie.

De eenvoudigste oplossing is doorgaans om een upgrade uit te voeren naar de versie van Xcode waarin het foutbericht wordt vermeld.

Het is ook mogelijk om een oudere versie van de bijbehorende workload te installeren om te voorkomen dat U Xcode moet upgraden.

In sommige gevallen moet de nieuwere versie van Xcode ook worden bijgewerkt naar een nieuwere primaire versie van macOS (dit vindt meestal rond april elk jaar plaats). Als de nieuwe macOS-versie niet wordt ondersteund op de huidige hardware van de ontwikkelaar, kunt u alleen een oudere versie van de workload gebruiken (of nieuwe hardware ophalen).

Nieuwe Xcode

Er is een periode tussen het uitbrengen van een nieuwe versie van Xcode door Apple en het vrijgeven van ondersteuning voor deze nieuwe Xcode-versie. Soms wordt in macOS de geïnstalleerde versie van Xcode automatisch bijgewerkt, wat tijdens deze periode problemen kan veroorzaken.

De eenvoudigste oplossing is het installeren van meerdere versies van Xcode en het selecteren van de versie van Xcode die overeenkomt met de Xcode-vereiste voor de geïnstalleerde werkbelasting(en).

Opmerking

Het is raadzaam om automatische updates uit te schakelen in de App Store op macOS om dit scenario te voorkomen.

Meerdere versies van Xcode installeren

Het is mogelijk om meerdere versies van Xcode tegelijkertijd te laten installeren.

Dit kan worden bereikt met de volgende stappen:

  • Ga naar de apple developer downloads-site .
  • Meld u aan met uw Apple ID.
  • Zoek naar de gewenste versies van Xcode.
  • Download de .xip bestanden.
  • Pak de bestanden uit door erop te dubbelklikken.
  • Wijzig de naam van de Xcode.app map Downloads in iets beschrijvender (bijvoorbeeld Xcode_15.app).
  • Verplaats de geëxtraheerde *.app naar de /Applications/ map.

Opmerking

Er zijn vreemde problemen opgetreden als de naam van de Xcode-app wordt gewijzigd nadat deze ten minste één keer is geopend, daarom raden we u aan de naam van de app alleen te wijzigen nadat u deze hebt gedownload en geëxtraheerd.

Zodra de gewenste versies van Xcode zijn geïnstalleerd, kunnen ontwikkelaars kiezen uit Xcode (menu Xcode - Instellingen ->> Locaties -> Opdrachtregelprogramma's) of met behulp van het xcode-select hulpprogramma vanaf de opdrachtregel:

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

Belangrijk

Het bestand ~/Library/Preferences/Xamarin/Settings.plist kan ook worden gebruikt om een specifieke versie van Xcode te kiezen en dit bestand heeft voorrang op de instelling die is opgegeven in Xcode of op de opdrachtregel met behulp van xcode-select. Om verwarring te voorkomen, raden we u aan dit bestand gewoon te verwijderen.

Oudere versie van een workload installeren

Er wordt een specifieke versie van een workload geïnstalleerd met behulp van een workloadset.

De exacte versie van de workloadset is niet voorspelbaar van tevoren, maar we geven de versie van de workloadset voor een specifieke workloadversie aan bij elke release: https://github.com/dotnet/macios/releases

Hier volgt een voorbeeld voor onze release met ondersteuning voor Xcode 16.3:

$ dotnet workload install ios --version 9.0.203

Veelgestelde vragen

Is het veilig om mijn Xcode bij te werken?

Het is mogelijk om te controleren of we ondersteuning voor een bepaalde versie van Xcode hebben uitgebracht door onze lijst met releases te bekijken.

Als we ondersteuning voor een bepaalde versie van Xcode hebben uitgebracht, is het veilig om een upgrade uit te voeren naar die versie van Xcode (dit geldt ook voor TENANT-ontwikkelaars). Er kunnen andere documenten elders zijn waarin staat dat een oudere versie van Xcode de ondersteunde versie is; deze documenten blijven doorgaans in zekere mate achter bij onze releases.

Het tegenovergestelde is ook waar: als we geen ondersteuning hebben uitgebracht voor een bepaalde versie van Xcode, zal het upgraden van Xcode waarschijnlijk problemen veroorzaken. Voor ontwikkelaars die een nieuwere versie van Xcode willen, is de beste oplossing in dit geval om meerdere versies van Xcode te installeren.

  • Last updated on