Icon Composerで作ったアイコンがアプリに反映されない

Icon Composerで作ったアイコンがアプリに反映されない

Icon ComposerのアイコンをXcodeで設定しても反映されない問題に直面したので、その原因と解決方法をお話しします。
2026.05.18

最近Swiftでのアプリ開発にハマっている大山です。
そんな中、アプリアイコンを設定する際にIcon Composerで作ったアイコンをドラッグ&ドロップしても、反映されなかったことについて記事にします。

結論

Build PhasesのCopy Bundle Resources Phaseが作成されていなかったというのが原因。
作成後にドラッグ&ドロップしたら無事アイコンが反映された。
スクリーンショット 2026-05-11 23.07.37

やったこと

  1. Icon Composerで作成した.iconファイルをそのままXcodeにドラッグ&ドロップ
  2. アプリターゲットを設定してファイルを追加
  3. Icon Composerのファイル名AppIcon(拡張子を除く)をApp Icons and Launch Screen > App Iconに設定してビルド

あれ反映されていない...

Appleのドキュメントや他の人の記事を参考にする限り、方法は合っているはずだが、反映されずにハマった。

原因の特定と対応

XcodeGenを使って.xcodeprojを作成していたので、その影響でCopy Bundle Resources Phaseが作られていなかった。
Xcodeから新規でプロジェクトを作る場合はデフォルトで作成され、作成されていればファイル追加の際に自動で追加してくれる。

project.ymlにはbuildPhase: resourcesを追加していればgenerateする際に追加してくれる。

targets:
  App:
    type: application
    platform: iOS
    sources:
      - path: App
      - path: AppIcon.icon
        buildPhase: resources # 👈これを入れる

Xcodeに慣れたい🔨
参考になったReddit

この記事をシェアする

関連記事