Xcode 26でAsset Catalogを含むプロジェクトをビルドすると、actoolから「Failed to generate flattened icon stack for icon named…」という警告が表示されることがあります。Appleはこの警告をXcode 26の既知問題（158698677）として記載し、誤ったbuild warningであり安全に無視できると案内しています。
表示される警告
Failed to generate flattened icon stack for icon named…実際のログでは末尾に対象アイコン名などが続く場合があります。重要なのは、Asset Catalog Compiler（actool）がflattened icon stackの生成に失敗したという警告部分です。
原因
AppleのXcode 26 Release Notesでは、一部の開発者にactoolからこの警告が誤って表示される既知問題として記載されています。したがって、このメッセージだけを根拠にAsset Catalogやアプリアイコンの設定が壊れていると判断する必要はありません。
対象バージョン: AppleがXcode 26のKnown Issuesとして問題番号158698677を掲載しています。公開リリースノートでは、この問題を修正した具体的なXcodeバージョンは示されていません。
推奨する対処方法
- まずビルドログを確認し、この警告が
Failed to generate flattened icon stack for icon named…であることを確認します。 - ほかにAsset Catalogやアイコンに関する実際のエラーが出ていないか確認します。
- この警告だけでビルドや実行に問題がない場合は、Appleの案内どおり無視します。
Appleはこの警告について「安全に無視できる」と明記しています。そのため、警告を消す目的だけでAsset Catalogを作り直す必要はありません。
代替策
Appleの公開情報では、この警告そのものに対する設定変更やコマンドによる回避策は案内されていません。警告が気になる場合でも、未確認のAsset Catalog変更を行うより、Appleが修正版を案内するまで既知問題として扱うのが安全です。
一方、アイコンが実際に表示されない、ビルドが失敗する、別のactoolエラーが併記される場合は、この既知の誤警告とは別問題の可能性があります。その場合は追加のエラーメッセージを基準に切り分けてください。
確認方法
- Build Logで警告を展開し、actool由来か確認する。
- ビルドが成功するか確認する。
- Simulatorまたは実機でアプリアイコンなど対象Assetが正常に表示されるか確認する。
- 別のAsset Catalogエラーがなければ、Appleの既知問題と一致する可能性が高いと判断できます。
注意点
Appleが「無視できる」としているのは、この特定の誤警告です。Asset Catalog Compilerが別のエラーを出している場合や、実際にアイコンが欠落している場合まで無視してよいという意味ではありません。
まとめ
Xcode 26で表示される「Failed to generate flattened icon stack for icon named…」は、Appleが認識しているactoolの誤ったbuild warningです。この警告だけでビルドやアイコン表示に問題がなければ、安全に無視できます。Appleは公開リリースノートで修正版を特定していないため、特定バージョンへの更新を確実な解決策として断定しないようにしてください。
公式情報
- Apple: Xcode 26 Release Notes — Asset Catalog Known Issues、問題番号158698677
- Apple: Configuring your app icon
