リンクをコピーしました

【UE5 Mac】Xcode Metal Compiler error の解決方法｜Metal Toolchain のダウンロード手順

はじめに

久しぶりに Unreal Engine 5.6.1 を起動しようとしたところ、**Xcode から「Xcode Metal Compiler error」**が表示されて「？」ってなりました。

Xcode Metal Compiler error: error: error: cannot execute tool 'metal due to
missing Metal Toolchain; use: xcodebuild -downloadComponent MetalToolchain

本記事では、このエラーの解決した方法を解説します。
Mac で Unreal Engine を開発している方を対象としています。

Xcode Metal Compiler errorのエラー画面（Xcode）

ヒントになったのは、Stack Overflow のスレッドです。同じ症状で困っている方は参考にしてみてください。

Xcode Metal Compiler error の解決手順

Step 1: Xcode を開き Metal Toolchain をダウンロードする

  1. Xcode を起動します
  2. メニューから Xcode → Settings → Components を開きます
  3. Download Metal Toolchain 26.X.X をクリックしてダウンロードを開始します

Xcode Settings - Components で Metal Toolchain をダウンロード

ポイント: Metal Toolchain のバージョン番号（26.X.X）は、お使いの Xcode のバージョンにより異なります。

Step 2: ダウンロード完了を確認する

ダウンロードが完了すると、Metal Toolchain の横にチェックマークなどが出るはずです。

Metal Toolchain ダウンロード完了の確認画面

Step 3: UE5 エディタを起動して確認する

  1. Xcode をいったん終了します
  2. Unreal Engine 5 のエディタを起動します
  3. Metal Compiler error が表示されず、正常に起動すると思います

筆者の環境では、macやUE5の再起動は不要でした。
Xcodeを閉じてかUE５のエディターの起動ボタンから起動するだけで解消しました。

関連リンク