Skip to content

[Bug]: iOS app icon created with icon composer is not working #8179

@dln-maurob

Description

@dln-maurob

Capacitor Version

Installed Dependencies:

@capacitor/cli: 7.4.3
@capacitor/core: 7.4.3
@capacitor/ios: 7.4.3
@capacitor/android: 7.4.3

Other API Details

Xcode Version 26.0.1 (17A400)

Platforms Affected

  • iOS
  • Android
  • Web

Current Behavior

iOS app icon created with Apple's Icon Composer tool (for liquid glass in iOS26) does not work with a fresh Capacitor project. If I create a fresh Xcode project, without capacitor, it works just fine.

How it works in a new Xcode project without capacitor:

  • Create new project
  • Open Icon Composer Tool and create an icon
  • Save it inside foloder /myapp/myapp/ as AppIcon.icon
  • Go to General settings of the project and go to 'App Icons and Launch Screen'
  • Set the App Icon to AppIcon without the extension
  • Make sure asset folder is empty
  • Launch an iOS26 simulator and notice how it uses the Icon Composed icon.

In a fresh Angular project:

  • run npx cap add ios
  • Open Xcode and create an icon using Icon Composer tool, save it the same place and make sure the name matches whatever your app points to.
  • Delete the AppIcon in the asset folder
  • Try to run on simulator and you get: None of the input catalogs contained a matching stickers icon set, app icon set, or icon stack named "AppIcon".

I've noticed that the project.pbxproj file looks entirely different when created by capacitor, compared to just creating a fresh xcode project. For example capacitor creates it as Xcode 8 project, whereas normally it would be created as Xcode 16 project, meaning assets and such get referenced completely differently.

Extra
By default, Apple will try to automatically create backwards compatible icons for older iOS based on your Icon Composer file. However you most likely want to control this yourself.

  • For older iOS versions, add an icon through the asset folder with the same name as the Icon Composer icon.
  • Under 'App Icons and Launch Screen' make sure that 'Include all app icon assets' is checked.
  • Then go to build settings and search for Asset Catalog Other Flags. Set the value to --enable-icon-stack-fallback-generation=disabled.
  • If you run iOS18 simulator it will use the assets/AppIcon, whereas in iOS26 it will use the liquid glass icon

In capacitor it will always just refer to the one in the asset folder, and throw the error mentioned above if the one in the asset folder doesn't exist.

Expected Behavior

It should use Icon Composer as app icon when using Capacitor

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions