Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Flutter and app store releases

Asset catalog compiler cannot find the app icon set

ErrorNone of the input catalogs contained a matching app icon set named "AppIcon"

Short answer

The target asks for an app icon by name, and no asset catalog or Icon Composer file in the target has that name. Compare the App Icon name in the target's General tab with the real name of your icon set, and make them identical. Then clean the build folder and build again.

  • Applies to Xcode 16, Xcode 26
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Print the icon name the target is asking for, then compare it with the set names in your catalog.

    xcodebuild -showBuildSettings -target MyApp | grep -E "ASSETCATALOG_COMPILER_APPICON_NAME|INCLUDE_ALL_APPICON"
    find . -name "*.appiconset" -o -name "*.icon" | grep -v build
  2. 2Match what you see, then jump to its fix

    1. 1The setting prints one name and the find command lists another, for example MyIcon.appiconsetThe icon set was renamed, or the build setting names a different setFix
    2. 2There is a .icon file in the project but no .appiconset, and the App Icon field holds a different nameThe project uses an Icon Composer .icon file whose name does not matchFix
    3. 3Assets.xcassets has no app icon set at all, or only the alternate icon setsThe primary icon set is missing from the catalog, so there is nothing to matchFix

What does the error look like?

  • None of the input catalogs contained a matching app icon set named "AppIcon"

Cause 1 of 3

The icon set was renamed, or the build setting names a different set

1Check

ASSETCATALOG_COMPILER_APPICON_NAME (Primary App Icon Set Name) is the name of the app icon set used as the target's default icon. The folder name in Assets.xcassets must equal it.

grep -n "ASSETCATALOG_COMPILER_APPICON_NAME" MyApp.xcodeproj/project.pbxproj

2Fix

Either rename the set in the asset catalog to the name in the setting, or change the setting (General tab, App Icons and Launch Screen, or Build Settings) to the real set name. Do it for every build configuration that overrides it.

// Debug.xcconfig / Release.xcconfig
ASSETCATALOG_COMPILER_APPICON_NAME = MyIcon

3Verify

Clean the build folder and build the target.

xcodebuild clean build -target MyApp -configuration Debug

Confirmed by developer.apple.com

Did this fix it?

Cause 2 of 3

The project uses an Icon Composer .icon file whose name does not match

1Check

With an Icon Composer file, the App Icon field must match the file name without the extension. You can keep several .icon files, but only the one matching that field is used, and the file replaces an AppIcon asset catalog set in recent Xcode.

find . -name "*.icon" -not -path "./build/*"

2Fix

Select the target, open General, and in App Icons and Launch Screen set App Icon to the file name without .icon (AppIcon.icon uses AppIcon). Confirm the file sits in the target's folder.

# Target > General > App Icons and Launch Screen > App Icon = AppIcon

3Verify

Build again and open the built app's Info.plist for icon keys.

xcodebuild build -target MyApp -configuration Debug

Confirmed by developer.apple.com

Did this fix it?

Cause 3 of 3

The primary icon set is missing from the catalog, so there is nothing to match

1Check

A project from the template starts with an app icon set named AppIcon. If it was deleted, nothing carries that name.

ls MyApp/Assets.xcassets

2Fix

Select the asset catalog, click the Add button (+), choose the OS variant App Icon, and name it to match the primary icon setting. Drag a 1024 x 1024 image into it; iOS can generate the other sizes from that one image.

# Assets.xcassets > + > iOS > iOS App Icon (named AppIcon)

3Verify

Build again.

xcodebuild build -target MyApp -configuration Debug

Confirmed by developer.apple.com

Did this fix it?

How do I stop it coming back?

  • Rename an icon set only together with the Primary App Icon Set Name setting.
  • Keep alternate icons out of the primary setting: list them in the alternate icon sets setting instead.
  • Use one icon source per target, either an asset catalog set or a .icon file.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Related fixes

Mobile apps

App record creation fails because you lack permission

You cannot add a new app in App Store Connect as a Developer or limited user

Only the Account Holder, an Admin or an App Manager can create an app record, and Apple blocks it until the Account Holder has signed the latest agreement.

3 causes, each with a fix

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.