Xcode の要件

2025-05-30

iOS、tvOS、Mac Catalyst、または macOS ワークロード用の .NET の各バージョンには、特定のバージョンの Xcode が必要です。

リリースノートには、各リリースの正確な Xcode バージョンが記載されています。

注

Xcode の異なるバージョンを使用する少数の制限付きシナリオでは動作しますが、ビルドエラーや警告がない場合でも、これはサポートされていません。

新しいワークロード

ワークロードの新しいバージョンでは、別のバージョンの Xcode が必要になる場合があります。これは通常、Apple が新しいバージョンの Xcode をリリースするたびに発生します。その後すぐに、新しいバージョンのワークロードがリリースされ、Xcode の新しいバージョンがサポートされます。そのため、ワークロードを更新すると、Xcode の新しいバージョンが必要になります。

多くの場合、次のようなビルドエラーが発生します。

このバージョンの Microsoft.iOS には、iOS 18.4 SDK (Xcode 16.3 に付属) が必要です。 Xcode の現在のバージョンは 16.2 です。 Xcode 16.3 をインストールするか、別のバージョンの Microsoft.iOS を使用します。詳細については、https://aka.ms/xcode-requirement を参照してください。

又は：

このバージョンの .NET for iOS (18.4.9288) には Xcode 16.3 が必要です。 Xcode の現在のバージョンは 16.2 です。 Xcode 16.3 をインストールするか、別のバージョンの .NET for iOS を使用します。詳細については、https://aka.ms/xcode-requirement を参照してください。

最も簡単な解決策は、通常、エラーメッセージに記載されている Xcode のバージョンにアップグレードすることです。

Xcode をアップグレードする必要がないように、対応するワークロードの古いバージョンをインストールすることもできます。

場合によっては、Xcode の新しいバージョンも新しいメジャーバージョンの macOS に更新する必要があります (通常は毎年 4 月頃に発生します)。開発者の現在のハードウェアで新しい macOS バージョンがサポートされていない場合、唯一のオプションは、以前のバージョンのワークロードを使用する (または新しいハードウェアを取得する) 方法です。

新しい Xcode

Apple が Xcode の新しいバージョンをリリースしてから、この新しい Xcode バージョンのサポートをリリースする間には、時間枠があります。 macOS によって、インストールされているバージョンの Xcode が自動更新されることがあり、この期間中に問題が発生する可能性があります。

最も簡単な解決策は、複数のバージョンの Xcode をインストールし、インストールされているワークロードの Xcode 要件に対応する Xcode のバージョンを選択することです。

注

このシナリオを回避するには、macOS の App Store で自動更新を無効にすることをお勧めします。

Xcode の複数のバージョンのインストール

Xcode の複数のバージョンを同時にインストールできます。

これを行うには、次の手順を実行します。

Apple Developer Downloads サイトに移動します。
Apple ID でサインインします。
Xcode の目的のバージョンを検索します。
.xip ファイルをダウンロードします。
ファイルをダブルクリックして抽出します。
ダウンロードフォルダー内の Xcode.app の名前を、よりわかりやすい名前に変更します (たとえば、 Xcode_15.app)。
抽出した *.app を /Applications/ ディレクトリに移動します。

注

Xcode アプリが少なくとも 1 回開かれた後に名前が変更された場合、奇妙な問題が発生しました。そのため、アプリの名前を変更するのは、アプリをダウンロードして抽出した直後に行うことをお勧めします。

Xcode の目的のバージョンがインストールされたら、開発者は Xcode (メニュー Xcode -> Settings -> Locations -> Command Line Tools) から、またはコマンドラインから xcode-select ツールを使用して選択できます。

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

Von Bedeutung

~/Library/Preferences/Xamarin/Settings.plistファイルを使用して Xcode の特定のバージョンを選択することもできます。このファイルは、Xcode または xcode-select を使用したコマンドラインで指定された設定よりも優先されます。混乱を避けるために、このファイルを単に削除することをお勧めします。

以前のバージョンのワークロードをインストールする

ワークロードの特定のバージョンは、ワークロードセットを使用してインストールされます。

ワークロードセットの正確なバージョンは事前に予測できませんが、リリースごとに特定のワークロードバージョンのワークロードセットのバージョンが https://github.com/dotnet/macios/releasesと記載されています。

Xcode 16.3 をサポートするリリースの例を次に示します。

$ dotnet workload install ios --version 9.0.203

よくあるご質問

Xcode をアップグレードしても安全ですか?

特定のバージョンの Xcode のサポートをリリースしたかどうかを確認するには、リリースの一覧を参照してください。

特定のバージョンの Xcode のサポートをリリースした場合は、そのバージョンの Xcode にアップグレードしても安全です (これには、MAUI 開発者も含まれます)。以前のバージョンの Xcode がサポートされているバージョンであることを示すドキュメントが他の場所にある可能性があります。これらのドキュメントは、通常、リリースからある程度遅れています。

その逆も当てはまります。特定のバージョンの Xcode のサポートをリリース していない 場合は、Xcode をアップグレードすると問題が発生する可能性があります。 Xcode の新しいバージョンを必要とする開発者にとって、この場合の最善の解決策は、複数のバージョンの Xcode をインストールすることです。