Požadavek na Xcode

Každá verze .NET pro iOS, tvOS, Mac Catalyst nebo macOS vyžaduje konkrétní verzi Xcode.

V naší zprávě k vydání verze uvádíme přesnou verzi Xcode pro každou verzi.

Poznámka:

V několika omezených scénářích může fungovat použití jiné verze Xcode, ale není to podporováno, i když nejsou žádné chyby při sestavování nebo varování.

Nové úlohy

Nová verze úlohy může vyžadovat jinou verzi Xcode. K tomu obvykle dochází vždy, když Apple vydá novou verzi Xcode: brzy potom vydáme nové verze úloh, které podporují novou verzi Xcode. Aktualizace úloh tak skončí tím, že bude vyžadovat novou verzi Xcode.

To se často manifestuje s chybou sestavení, jako je tato:

Tato verze Microsoft.iOS vyžaduje sadu iOS 18.4 SDK (dodávaná s Xcode 16.3). Aktuální verze Xcode je 16.2. Buď nainstalujte Xcode 16.3, nebo použijte jinou verzi Microsoft.iOS. Další informace naleznete na https://aka.ms/xcode-requirement.

nebo:

Tato verze .NET pro iOS (18.4.9288) vyžaduje Xcode 16.3. Aktuální verze Xcode je 16.2. Buď nainstalujte Xcode 16.3, nebo použijte jinou verzi .NET pro iOS. Další informace naleznete na https://aka.ms/xcode-requirement.

Nejjednodušším řešením je obvykle upgradovat na verzi Xcode, o které se chybová zpráva zmiňuje.

Je také možné nainstalovat starší verzi odpovídající úlohy, abyste se vyhnuli upgradu Xcode.

V některých případech novější verze Xcode také vyžaduje aktualizaci na novější hlavní verzi macOS (obvykle k tomu dochází přibližně v dubnu každý rok). Pokud nová verze macOS není na aktuálním hardwaru vývojáře podporovaná, jedinou možností je použít starší verzi úlohy (nebo získat nový hardware).

Nový Xcode

Mezi vydáním nové verze Xcode a vydáním podpory pro tuto novou verzi Xcode existuje časový interval. Někdy macOS automaticky aktualizuje nainstalovanou verzi Xcode, což může způsobit problémy během tohoto časového rámce.

Nejjednodušším řešením je nainstalovat více verzí Xcode a vybrat verzi Xcode, která odpovídá požadavkům Xcode pro nainstalované úlohy.

Poznámka:

Doporučujeme zakázat automatické aktualizace v App Storu v macOS, abyste se tomuto scénáři vyhnuli.

Instalace více verzí Xcode

Je možné mít současně nainstalovaných více verzí Xcode.

Můžete to provést pomocí následujících kroků:

• Přejděte na web Apple Developer Downloads .
• Přihlaste se pomocí Apple ID.
• Vyhledejte požadované verze Xcode.
• .xip Stáhněte si soubory.
• Extrahujte soubory poklikáním.
• Xcode.app Přejmenujte složku Stažené soubory na něco popisnějšího (napříkladXcode_15.app).
• Přesuňte extrahovaný *.app soubor do /Applications/ adresáře.

Poznámka:

Viděli jsme podivné problémy, pokud se aplikace Xcode po jejím otevření alespoň jednou přejmenuje, proto doporučujeme aplikaci přejmenovat jenom hned po stažení a extrahování.

Po instalaci požadovaných verzí Xcode si můžou vývojáři vybrat z Xcode (nabídka Xcode –> Nastavení – Umístění –>> Nástroje příkazového řádku) nebo pomocí xcode-select nástroje z příkazového řádku:

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

Důležité

Soubor ~/Library/Preferences/Xamarin/Settings.plist lze také použít k výběru konkrétní verze Xcode a tento soubor bude mít přednost před nastavením zadaným v Xcode nebo na příkazovém řádku pomocí xcode-select. Abyste se vyhnuli nejasnostem, doporučujeme jednoduše odstranit tento soubor.

Instalace starší verze pracovní zátěže

Konkrétní verze úlohy se instaluje pomocí sady úloh.

Přesná verze sady úloh není předvídatelná předem, ale uvádíme verzi sady úloh pro konkrétní verzi úlohy s každou verzí: https://github.com/dotnet/macios/releases

Tady je příklad pro naši verzi s podporou Xcode 16.3:

$ dotnet workload install ios --version 9.0.203

Nejčastější dotazy

Je bezpečné upgradovat můj Xcode?

V seznamu vydaných verzí je možné zkontrolovat, jestli jsme vydali podporu pro konkrétní verzi Xcode.

Pokud jsme vydali podporu pro konkrétní verzi Xcode, je bezpečné upgradovat na tuto verzi Xcode (to zahrnuje i vývojáře MAUI). Můžou existovat další dokumenty, které hlásí, že některá starší verze Xcode je podporovaná verze; tyto dokumenty obvykle do určité míry zaostávají za našimi verzemi.

Opak je také pravdivý: pokud jsme neuvedli podporu pro danou verzi Xcode, je pravděpodobné, že upgrade Xcode způsobí problémy. Pro vývojáře, kteří chtějí novější verzi Xcode, je nejlepším řešením v tomto případě nainstalovat více verzí Xcode.