Xcode-krav

Varje version av .NET för iOS-, tvOS-, Mac Catalyst- eller macOS-arbetsbelastningar kräver en specifik version av Xcode.

Vi anger i våra versionsanteckningar den exakta Xcode-versionen för varje version.

Anmärkning

I några begränsade scenarier kan det fungera att använda en annan version av Xcode, men det stöds inte, även om det inte finns några byggfel eller varningar.

Nya arbetsbelastningar

En ny version av en arbetsbelastning kan kräva en annan version av Xcode. Detta inträffar vanligtvis när Apple släpper en ny version av Xcode: strax därefter släpper vi nya versioner av arbetsbelastningarna med stöd för den nya versionen av Xcode. Uppdatering av arbetsbelastningarna kräver därför en ny version av Xcode.

Detta manifesteras ofta med ett byggfel som det här:

Den här versionen av Microsoft.iOS kräver iOS 18.4 SDK (levereras med Xcode 16.3). Den aktuella versionen av Xcode är 16.2. Installera Xcode 16.3 eller använd en annan version av Microsoft.iOS. Mer information finns i https://aka.ms/xcode-requirement.

eller:

Den här versionen av .NET för iOS (18.4.9288) kräver Xcode 16.3. Den aktuella versionen av Xcode är 16.2. Installera Xcode 16.3 eller använd en annan version av .NET för iOS. Mer information finns i https://aka.ms/xcode-requirement.

Den enklaste lösningen är vanligtvis att uppgradera till den version av Xcode som felmeddelandet nämner.

Det går också att installera en äldre version av motsvarande arbetsbelastning för att undvika att behöva uppgradera Xcode.

I vissa fall kräver den nyare versionen av Xcode också uppdatering till en nyare större version av macOS (detta sker vanligtvis runt april varje år). Om den nya macOS-versionen inte stöds på utvecklarens aktuella maskinvara är det enda alternativet att använda en äldre version av arbetsbelastningen (eller hämta ny maskinvara).

Ny Xcode

Det finns ett tidsfönster mellan att Apple släpper en ny version av Xcode och att vi släpper stöd för den här nya Xcode-versionen. Ibland uppdaterar macOS automatiskt den installerade versionen av Xcode, vilket kan orsaka problem under den här tidsramen.

Den enklaste lösningen är att installera flera versioner av Xcode och välja den version av Xcode som motsvarar Xcode-kravet för de installerade arbetsbelastningarna.

Anmärkning

Vi rekommenderar att du inaktiverar automatiska uppdateringar i App Store på macOS för att undvika det här scenariot.

Installera flera versioner av Xcode

Det går att ha flera versioner av Xcode installerade samtidigt.

Detta kan åstadkommas med följande steg:

• Gå till webbplatsen Apple Developer Downloads.
• Logga in med ditt Apple-ID.
• Sök efter önskade versioner av Xcode.
• Ladda ned fil(er).
• Extrahera filen eller filerna genom att dubbelklicka på dem.
• Byt namn på Xcode.app i mappen Nedladdningar till något mer beskrivande (till exempel Xcode_15.app).
• Flytta den extraherade *.app till /Applications/ katalogen.

Anmärkning

Vi har sett konstiga problem om Xcode-appen har bytt namn efter att den har öppnats minst en gång. Därför rekommenderar vi att du bara byter namn på appen direkt efter att den har laddats ned och extraherats.

När de önskade versionerna av Xcode har installerats kan utvecklare välja mellan dem antingen från Xcode (meny Xcode – Inställningar –>> Platser –> Kommandoradsverktyg) eller med hjälp xcode-select av verktyget från kommandoraden:

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

Viktigt!

Filen ~/Library/Preferences/Xamarin/Settings.plist kan också användas för att välja en specifik version av Xcode, och den här filen har företräde framför inställningen som anges i antingen Xcode eller på kommandoraden med .xcode-select För att undvika förvirring rekommenderar vi att du bara tar bort den här filen.

Installera äldre version av en arbetsbelastning

En specifik version av en arbetsbelastning installeras med hjälp av en arbetsbelastningsuppsättning.

Den exakta versionen av arbetsbelastningsuppsättningen är inte förutsägbar i förväg, men vi anger arbetsbelastningsuppsättningsversionen för en specifik arbetsbelastningsversion med varje version: https://github.com/dotnet/macios/releases.

Här är ett exempel på vår version med stöd för Xcode 16.3:

$ dotnet workload install ios --version 9.0.203

Vanliga frågor

Är det säkert att uppgradera min Xcode?

Det går att kontrollera om vi har släppt stöd för en viss version av Xcode genom att titta på vår lista över versioner.

Om vi har släppt stöd för en viss version av Xcode är det säkert att uppgradera till den versionen av Xcode (detta inkluderar ÄVEN MAUI-utvecklare). Det kan finnas andra dokument någon annanstans som anger att en äldre version av Xcode är den version som stöds. dessa dokument släpar vanligtvis efter våra versioner i viss utsträckning.

Motsatsen är också sant: om vi inte har släppt stöd för en viss version av Xcode är det troligt att uppgradering av Xcode kommer att orsaka problem. För utvecklare som vill ha en nyare version av Xcode är den bästa lösningen i det här fallet att installera flera versioner av Xcode.