Requisito Xcode

Ogni versione di .NET per carichi di lavoro iOS, tvOS, Mac Catalyst o macOS richiede una versione specifica di Xcode.

Nelle note sulla versione viene descritta la versione Xcode esatta per ogni versione.

Annotazioni

In alcuni scenari limitati che usano una versione diversa di Xcode può funzionare, ma questo non è supportato, anche se non sono presenti errori di compilazione o avvisi.

Nuovi carichi di lavoro

Una nuova versione di un carico di lavoro potrebbe richiedere una versione diversa di Xcode. Questo avviene in genere ogni volta che Apple rilascia una nuova versione di Xcode: poco dopo vengono rilasciate nuove versioni dei carichi di lavoro, supportando la nuova versione di Xcode. L'aggiornamento dei carichi di lavoro finisce quindi per richiedere una nuova versione di Xcode.

Questo si manifesta spesso con un errore di compilazione simile al seguente:

Questa versione di Microsoft.iOS richiede l'SDK iOS 18.4 (fornito con Xcode 16.3). La versione corrente di Xcode è 16.2. Installare Xcode 16.3 o usare una versione diversa di Microsoft.iOS. Per altre informazioni, vedere https://aka.ms/xcode-requirement.

oppure:

Questa versione di .NET per iOS (18.4.9288) richiede Xcode 16.3. La versione corrente di Xcode è 16.2. Installare Xcode 16.3 o usare una versione diversa di .NET per iOS. Per altre informazioni, vedere https://aka.ms/xcode-requirement.

La soluzione più semplice consiste in genere nell'eseguire l'aggiornamento alla versione di Xcode menzionata dal messaggio di errore.

È anche possibile installare una versione precedente del carico di lavoro corrispondente per evitare di dover aggiornare Xcode.

In alcuni casi la versione più recente di Xcode richiede anche l'aggiornamento a una versione principale più recente di macOS (questo in genere si verifica intorno ad aprile ogni anno). Se la nuova versione di macOS non è supportata nell'hardware corrente dello sviluppatore, l'unica opzione consiste nell'usare una versione precedente del carico di lavoro (o ottenere un nuovo hardware).

Nuovo codice Xcode

C'è un intervallo di tempo tra il rilascio di una nuova versione di Xcode e il rilascio del supporto per questa nuova versione di Xcode. A volte macOS aggiornerà automaticamente la versione installata di Xcode, che può causare problemi durante questo intervallo di tempo.

La soluzione più semplice consiste nell'installare più versioni di Xcode e selezionare la versione di Xcode corrispondente al requisito Xcode per i carichi di lavoro installati.

Annotazioni

È consigliabile disabilitare gli aggiornamenti automatici nell'App Store in macOS per evitare questo scenario.

Installazione di più versioni di Xcode

È possibile installare contemporaneamente più versioni di Xcode.

Questa operazione può essere eseguita con i passaggi seguenti:

• Passare al sito Apple Developer Downloads (Download per sviluppatori Apple ).
• Accedere con l'ID Apple.
• Cercare le versioni desiderate di Xcode.
• Scarica il/i .xip file.
• Estrarre i file facendo doppio clic su di essi.
• Rinominare nella Xcode.app cartella Download un valore più descrittivo , ad esempio Xcode_15.app.
• Spostare l'oggetto estratto *.app nella /Applications/ directory .

Annotazioni

Si sono verificati problemi strani se l'app Xcode viene rinominata dopo l'apertura almeno una volta, pertanto è consigliabile rinominare l'app solo dopo il download e l'estrazione.

Dopo aver installato le versioni desiderate di Xcode, gli sviluppatori possono scegliere tra di essi da Xcode (menu Xcode - Impostazioni -> Percorsi ->> Strumenti da riga di comando) o usando lo xcode-select strumento dalla riga di comando:

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

Importante

Il file ~/Library/Preferences/Xamarin/Settings.plist può essere usato anche per scegliere una versione specifica di Xcode e questo file avrà la precedenza sull'impostazione specificata in Xcode o nella riga di comando usando xcode-select. Per evitare confusione, è consigliabile semplicemente eliminare questo file.

Installare la versione precedente di un carico di lavoro

Una versione specifica di un carico di lavoro viene installata usando un set di carico di lavoro.

La versione esatta del set di carico di lavoro non è prevedibile in anticipo, ma viene indicare la versione del set di carico di lavoro per una versione specifica del carico di lavoro con ogni versione: https://github.com/dotnet/macios/releases.

Ecco un esempio per la versione con supporto per Xcode 16.3:

$ dotnet workload install ios --version 9.0.203

Domande frequenti

È sicuro aggiornare Xcode?

È possibile verificare se è stato rilasciato il supporto per una versione specifica di Xcode esaminando l'elenco delle versioni.

Se è stato rilasciato il supporto per una versione specifica di Xcode, è possibile eseguire l'aggiornamento a tale versione di Xcode (inclusi anche gli sviluppatori MAUI). Altri documenti potrebbero essere presenti altrove per indicare che alcune versioni precedenti di Xcode sono la versione supportata; questi documenti in genere si ritardano in qualche modo dietro le nostre versioni.

L'opposto è anche vero: se non è stato rilasciato il supporto per una determinata versione di Xcode, è probabile che l'aggiornamento di Xcode causi problemi. Per gli sviluppatori che vogliono una versione più recente di Xcode, la soluzione migliore in questo caso consiste nell'installare più versioni di Xcode.