Compartilhar via

Requisito de Xcode

Cada versão do .NET para cargas de trabalho do iOS, tvOS, Mac Catalyst ou macOS requer uma versão específica do Xcode.

Nós declaramos em nossas notas de versão a versão exata do Xcode para cada lançamento.

Observação

Em alguns cenários limitados, o uso de uma versão diferente do Xcode pode funcionar, mas isso não tem suporte, mesmo que não haja erros ou avisos de build.

Novas cargas de trabalho

Uma nova versão de uma carga de trabalho pode exigir uma versão diferente do Xcode. Isso normalmente acontece sempre que a Apple lança uma nova versão do Xcode: logo depois lançamos novas versões das cargas de trabalho, dando suporte à nova versão do Xcode. A atualização das cargas de trabalho, portanto, acabará exigindo uma nova versão do Xcode.

Isso geralmente se manifesta com um erro de build como este:

Esta versão do Microsoft.iOS requer o SDK do iOS 18.4 (fornecido com o Xcode 16.3). A versão atual do Xcode é 16.2. Instale o Xcode 16.3 ou use uma versão diferente do Microsoft.iOS. Consulte https://aka.ms/xcode-requirement para obter mais informações.

ou:

Esta versão do .NET para iOS (18.4.9288) requer o Xcode 16.3. A versão atual do Xcode é 16.2. Instale o Xcode 16.3 ou use uma versão diferente do .NET para iOS. Consulte https://aka.ms/xcode-requirement para obter mais informações.

A solução mais simples normalmente é atualizar para a versão do Xcode que a mensagem de erro menciona.

Também é possível instalar uma versão mais antiga da carga de trabalho correspondente para evitar a necessidade de atualizar o Xcode.

Em alguns casos, a versão mais recente do Xcode também requer atualização para uma versão principal mais recente do macOS (isso geralmente ocorre por volta de abril de cada ano). Se a nova versão do macOS não tiver suporte no hardware atual do desenvolvedor, a única opção é usar uma versão mais antiga da carga de trabalho (ou obter um novo hardware).

Novo Xcode

Há uma janela de tempo entre a Apple lançar uma nova versão do Xcode e liberar suporte para essa nova versão do Xcode. Às vezes, o macOS atualiza automaticamente a versão instalada do Xcode, o que pode causar problemas durante esse período.

A solução mais simples é instalar várias versões do Xcode e selecionar a versão do Xcode que corresponde ao requisito Xcode para as cargas de trabalho instaladas.

Observação

Recomendamos desabilitar atualizações automáticas na App Store no macOS para evitar esse cenário.

Instalando várias versões do Xcode

É possível ter várias versões do Xcode instaladas simultaneamente.

Isso pode ser feito com as seguintes etapas:

  • Acesse o site Downloads do Desenvolvedor da Apple.
  • Entre com sua ID da Apple.
  • Pesquise as versões desejadas do Xcode.
  • Baixe o(s) arquivo(s) .xip.
  • Extraia os arquivos clicando duas vezes neles.
  • Renomeie a Xcode.app pasta Downloads para algo mais descritivo (por exemplo Xcode_15.app).
  • Mova o extraído *.app para o /Applications/ diretório.

Observação

Vimos problemas estranhos se o aplicativo Xcode for renomeado depois que ele for aberto pelo menos uma vez, portanto, recomendamos renomear apenas o aplicativo logo após baixá-lo e extraí-lo.

Depois que as versões desejadas do Xcode forem instaladas, os desenvolvedores poderão escolher entre elas no Xcode (menu Xcode –> Configurações –> Locais –> Ferramentas de Linha de Comando) ou usando a xcode-select ferramenta na linha de comando:

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

Importante

O arquivo ~/Library/Preferences/Xamarin/Settings.plist também pode ser usado para escolher uma versão específica do Xcode, e esse arquivo terá precedência sobre a configuração especificada no Xcode ou na linha de comando usando xcode-select. Para evitar confusão, é recomendável simplesmente excluir esse arquivo.

Instalar a versão mais antiga de uma carga de trabalho

Uma versão específica de uma carga de trabalho é instalada usando um conjunto de cargas de trabalho.

A versão exata do conjunto de trabalho não pode ser prevista antecipadamente, mas declaramos a versão do conjunto de trabalho para uma versão específica da carga de trabalho em cada lançamento: https://github.com/dotnet/macios/releases.

Aqui está um exemplo para nossa versão com suporte para xcode 16.3:

$ dotnet workload install ios --version 9.0.203

Perguntas Freqüentes

É seguro atualizar meu Xcode?

É possível verificar se lançamos suporte para uma versão específica do Xcode examinando nossa lista de versões.

Se lançamos suporte para uma versão específica do Xcode, é seguro atualizar para essa versão do Xcode (isso inclui também desenvolvedores MAUI). Pode haver outros documentos em outros lugares informando que alguma versão mais antiga do Xcode é a versão com suporte; esses documentos normalmente ficam atrás de nossas versões até certo ponto.

O oposto também é verdadeiro: se não liberarmos o suporte para uma determinada versão do Xcode, é provável que a atualização do Xcode cause problemas. Para desenvolvedores que desejam uma versão mais recente do Xcode, a melhor solução nesse caso é instalar várias versões do Xcode.

  • Last updated on