How to replicate:
Design a icon in icon composer
Save it and put the .icon file in your project, then in your targets put the name of the .icon file in there. Either clean build folder or restart IDE
One Error:
unable to open dependencies file (/Users/user/Library/Developer/Xcode/DerivedData/project-fqrfzzkwgrutdabmcqjeupvyetci/Build/Intermediates.noindex/project.build/Debug/project.build/assetcatalog_dependencies_thinned)
And one warning:
Icon export exited with status 255, signal 0
Is this a known issue or a easy fix? Or is it a issue on my end? Thanks
Icon Composer
RSS for tagIcon Composer lets you create multi-layered icons out of Liquid Glass from a single design file.
Posts under Icon Composer tag
48 Posts
Selecting any option will automatically load the page
Post
Replies
Boosts
Views
Activity
On iOS 26 beta 3, my app and some other apps got greyed out app icon.
It only happens in Default (Light) appearance.
Apple automatically converts third-party app icons to support Liquid Glass, but is there any specific requirement with third-party icons to avoid above greyed out app icon issue?
I'm having a strange issue with my iOS app icon rendering in the App Store - it seems to be low-res and clipping part of the image. I updated the icon in Icon Composer to apply the liquid glass overlay for the new build. It looks fine on the device and the asset itself isn't corrupted. I think it might be a resolution issue since the small icon thumbnails in App Store Connect have the same problem, but they look fine when I click through to the larger preview. Has anyone else run into this and figured out a fix?
When creating an icon using icon composer, I cant upload a build to testflight/App Store connect.
Running on device from Xcode works fine, but as soon as I archive and upload to App Store Connect, I get an error saying the icon contains an alpha channel
I made a new app icon with Icon Composer, and added it to my Xcode project. In the built app, I see AppIcon.icon next to the old AppIcon.icns. But Tahoe is not showing the new icon. Is this because Tahoe has cached the old icon somewhere, and if so, is there some way to make it refresh?
I've been playing around with the recently published iPad PRO M5 13" and it's awesome in most ways I've been able to think of. But this video capture of the app I'm developing, for example, lacks it the app icon "should" be just slightly translucent as I see it.
https://youtube.com/CAukICBrVzw
However I'm not and UI/X person and this is primarily my personal preference only for an option to allow for devs.
Is there a way to display a .icon file in SwiftUI? I want to show the app icon in the app itself but exporting and including the app icon as a PNG feels redundant. This would consume a lot of unnecessary storage especially when including a lot of alternative app icons. There has to be a better way
Otherwise I would file a feedback for that
Thank you
Several app developers are struggling with the inability to provide a separate app icons that looks nice on older macOS versions while at the same time provide Icon Composer icons that look great on macOS Tahoe 26. An ability to provide separate icons is super important to those who have app icons that follow the curvature of the default icon borders (as the corner rounding radius is different for Sequia and Tahoe). Take a look at this for example:
https://github.com/ghostty-org/ghostty/issues/7564#issuecomment-3042061547
Question: Is there a definitive/recommended way to address this issue? How can a developer add a glass icon variant that looks good on Tahoe and provide a bitmap icon for older macOS versions?
Some background info:
Prior to Xcode 26 beta 4, one could add an App Icon to Assets to be used as app icon for legacy macOS versions (Sequia and older) and use a new Icon Composer icon (placed in the project root) for macOS Tahoe 26. Enabling "Include all app icon assets" under target settings ensured that older macOS versions would use the old app icons while Tahoe the new Icon Composer glass one.
Since Xcode beta 4 this technique no longer works. Xcode instead insists on populating Assets.car with Icon Composer generated variants, disregarding the App Icon provided in Assets. Although the App Icon in Assets makes its way to a .incs file in the app bundle's Contents/Resources folder, but that is not used by macOS anymore and is there for some compatibility purposes. The Assets.car file (which matters) only contains the variants generated by Icon Composer and does not contain the png icons provided in the Assets.
I've made my updated icon and I try to import it to Xcode but it keeps crashing even if I clean the project/delete derived data or try to add through the Naivgation Controls.
I've tried with the Xcode 26.2 beta too but it has the same issue.
Hi everyone,
we’re developing an app that lets users export selected bike rides to the HealthKit ecosystem. We created our app icon using the Apple Icon Composer and referenced the composer file in Xcode. Everything works fine, except that the logo doesn’t appear correctly in the Fitness app.
Has anyone experienced this issue or knows how to fix it?
Topic:
App & System Services
SubTopic:
Health & Fitness
Tags:
Health and Fitness
HealthKit
Icon Composer
Hi everyone,
I’ve run into a strange issue while building my app with Xcode 26 beta 6 (targeting iOS 26). When I include an app icon created using Icon Composer, the build time jumps to over 5 minutes. During this time, I noticed that a utility called AssetCatalogSimulatorAgent is consuming a significant amount of CPU.
If I remove the Icon Composer-generated icon from my target, the build completes in about 40 seconds. This behavior is consistent across multiple builds.
Has anyone else experienced this? Is there a known workaround or optimization for icons created with Icon Composer? I’d love to keep using the new icon format, but the build time is becoming a real bottleneck.
Thanks in advance!
We have found that on iOS 26 beta some of our app icons built from an Xcode 16 asset catalog containing a single 1024x1024 .png file have a Liquid Glass effect applied to them while others have not.
The documentation states that
If you choose not to use Icon Composer, you can still use an AppIcon asset catalog in your project containing individual app icon images and let the system apply the Liquid Glass material.
and
If you prefer, you can take advantage of the system’s automatically generated treatment that is applied to all app icons.
Is there any insight into how the system treats app icons that have not yet been updated with Icon Composer?
My original thread ID was:
https://developer.apple.com/forums/thread/805350
This was a technical post with no links to products or services, but directly to native code designed to solve the problem I was posting about.
I believe a single unhappy user may be abusing the flagging/reporting feature.
I am contesting what this single user has alleged, namely that my content is “advertising.”
Under my rights as per the Apple Developer Forums Agreement, I am requesting a review per Apple’s right to monitor and correct moderation actions. Thank you.
Currently, the icon composer app can only export the icon with a rounded app background image.
It would be better to support exporting the icon with a transparent background. It can make the exported app icon image with the liquid glass effect for websites, social networks, or other marketing places.
Thank you!
Hi everyone,
I created my app icon using Apple’s Icon Composer tool, a single AppIcon.icon file, set the iOS and Mac Catalyst using shared mode. There’s no AppIcon imageSet in Assets.xcassets.
The app displays the icon correctly at runtime — both on iOS devices and on macOS (Catalyst build). On macOS versions prior to 26, the App Store icon looked completely normal.
However, in App Store Connect and in the Mac App Store on macOS 26, the icon appears with a gray border.
Thanks in advance for any insights or suggestions!
Hi, I'm experiencing a super weird and unexpected issue using Icon Composer (Version 1.0 (40)) and Xcode 26 beta 7.
I have an icon that includes some minimal text in the icon, as part of the branding of the app. The text is an SVG layer in Icon Composer. Icon Composer has no idea this is text, just a regular SVG layer.
When I import the resulting .icon file into Xcode, it appears correct in the Xcode preview.
However, when building the app and installing it on the iOS 26 simulator, the font of the text in the icon changes (to the system default font?). It is also cropped, cut off, and off-center.
I replicated this with a simple standalone icon and clean project.
Is anyone else seeing this?
In the beta of Icon Composer, I see macOS, iOS, and watchOS icons, but there is nothing about visionOS and tvOS. Those icons are particularly hard and it would be great if this app worked for developing icons for all Apple platforms.
I tried asking this in a WWDC group lab, but they didn't get to it and suggested posting to the forum.
Topic:
Developer Tools & Services
SubTopic:
General
Tags:
Developer Tools
Beta
Universal Apps
Icon Composer
This started with Xcode 26 beta 7, however it has continued to occur with the release candidate. Whenever I try to compile our asset catalog + icon composer icon for our AppKit/SwiftUI-based macOS app, actool fails with the following exception:
*** Terminating app due to uncaught exception 'IBPlatformToolFailureException', reason: 'The tool closed the connection (AssetCatalogAgent-AssetRuntime)
Last command:
_ON_QUEUE_sendMessage:toChannelReturningError:during:
Backtrace of last command:
0 -[IBAbstractPlatformToolProxy _ON_QUEUE_sendMessage:toChannelReturningError:during:] (in IDEInterfaceBuilderKit)
1 __74-[IBAbstractPlatformToolProxy sendMessage:toChannelReturningError:during:]_block_invoke (in IDEInterfaceBuilderKit)
2 _dispatch_client_callout (in libdispatch.dylib)
3 _dispatch_lane_barrier_sync_invoke_and_complete (in libdispatch.dylib)
4 DVTDispatchSync (in DVTFoundation)
5 -[IBAbstractPlatformToolProxy sendMessage:toChannelReturningError:during:] (in IDEInterfaceBuilderKit)
6 -[AssetCatalogRemoteAgentProxy compileItemsWithCatalogRelativeIdentifierPaths:tagSolutionSpace:andStickerPacksWithCatalogRelativeIdentifierPaths:options:] (in IDEInterfaceBuilderCocoaTouchIntegration)
7 -[IBICLARToolCARCompiler compileCARItems:tagSolutionSpace:options:queue:completionHandler:] (in AssetCatalogCocoaTouchKit)
8 -[IBICAbstractPlatformAdapter compileCARItems:tagSolutionSpace:options:queue:completionHandler:] (in AssetCatalogFoundation)
9 __84-[IBICAbstractPlatformAdapter compileSelectedItems:options:queue:completionHandler:]_block_invoke (in AssetCatalogFoundation)
10 __93-[IBICAbstractPlatformAdapter compileStandaloneCatalogItems:options:queue:completionHandler:]_block_invoke (in AssetCatalogFoundation)
11 __DVT_CALLING_CLIENT_BLOCK__ (in DVTFoundation)
12 __DVTDispatchAsync_block_invoke (in DVTFoundation)
13 _dispatch_call_block_and_release (in libdispatch.dylib)
14 _dispatch_client_callout (in libdispatch.dylib)
15 _dispatch_main_queue_drain.cold.5 (in libdispatch.dylib)
16 _dispatch_main_queue_drain (in libdispatch.dylib)
17 _dispatch_main_queue_callback_4CF (in libdispatch.dylib)
18 __CFRUNLOOP_IS_SERVICING_THE_MAIN_DISPATCH_QUEUE__ (in CoreFoundation)
19 __CFRunLoopRun (in CoreFoundation)
20 CFRunLoopRunSpecific (in CoreFoundation)
21 -[NSRunLoop(NSRunLoop) runMode:beforeDate:] (in Foundation)
22 -[NSRunLoop(DVTNSRunLoopAdditions) dvt_spinRunLoopInMode:whileQueue:executesAsynchronously:] (in DVTFoundation)
23 -[NSRunLoop(DVTNSRunLoopAdditions) dvt_spinRunLoopInMode:whileBlockExecutesConcurrently:] (in DVTFoundation)
24 -[NSRunLoop(DVTNSRunLoopAdditions) dvt_spinRunLoopInMode:waitingForSemaphore:] (in DVTFoundation)
25 -[IBCLIImageCatalogToolPersona compileCatalogCollection:withPlatformAdapter:arguments:outputDictionary:] (in ibtoold)
26 -[IBCLIImageCatalogToolPersona invokeArguments:outputDictionary:] (in ibtoold)
27 -[IBCLIImageCatalogToolPersona runSingleInvocation:outputtingToFileHandle:andVerifyingEnvironment:] (in ibtoold)
28 IBCLIServerRunSingleInvocation (in ibtoold)
29 __IBCLIServerRunSingleInvocationWithIODirectedAtPipesAndUnlinkOnSuccess_block_invoke_2 (in ibtoold)
30 __IBCLIServerRunSingleInvocationWithIODirectedAtPipesAndUnlinkOnSuccess_block_invoke (in ibtoold)
31 -[IBCLIErrorForwarder forwardErrorOutputToDescriptor:whileInvokingBlock:] (in ibtoold)
32 IBCLIServerRunSingleInvocationWithIODirectedAtPipesAndUnlinkOnSuccess (in ibtoold)
33 main (in ibtoold)
34 start (in dyld)
I can't seem to get it to compile consistently — it works fine locally.
I would ❤️ a workaround, otherwise I'm not sure that we'll be able to ship an update to our app for macOS 26.
FB20183399
When comparing the Assets.car file of the previous and current versions of my app, compiled with Xcode 16 and 26, respectively, with the Terminal command
assetutil --info MyApp.app/Contents/Resources/Assets.car
I see that the new version contains many more app icons at different sizes, increasing my app's size by 1 MB (not much, but considering that the app is only 6 MB in total...):
{
"AssetType" : "MultiSized Image",
"Name" : "AppIcon",
"NameIdentifier" : 6849,
"Scale" : 1,
"SHA1Digest" : "9D75F76992E9E9E5531A214A4AE282EBD381F7EB903024E00FB25EB42381CC45",
"SizeOnDisk" : 308,
"Sizes" : [
"16x16 index:1 idiom:universal",
"32x32 index:2 idiom:universal",
"64x64 index:3 idiom:universal",
"128x128 index:4 idiom:universal",
"256x256 index:5 idiom:universal",
"512x512 index:6 idiom:universal",
"1024x1024 index:7 idiom:universal"
]
}
The previous one allowed me to add only two sizes:
{
"AssetType" : "MultiSized Image",
"Name" : "AppIcon",
"NameIdentifier" : 6849,
"Scale" : 1,
"SHA1Digest" : "AC782A2FFF9A4B2D563EF64DF41A179583440560F8732A176A8376B31000368E",
"SizeOnDisk" : 248,
"Sizes" : [
"256x256 index:1 idiom:universal",
"512x512 index:2 idiom:universal"
]
}
Is there a way to only ship the strictly necessary app icons sizes while using Xcode 26 Icon Composer, or will all the sizes be required going forward?
Hi everyone,
we are currently facing an issue with one of our apps regarding the new icon requirements in iOS 26.
• We created the app icon using Apple’s Icon Composer.
• On the device, everything works perfectly: the app icon is shown on the home screen, and it can also be customized with the new iOS 26 features (colors, transparency, etc.).
• However, in TestFlight the app icon is not displayed at all (in the TestFlight app on the device).
• In App Store Connect, the icon is also not shown in the overview for the app. Interestingly, within the list of TestFlight builds in App Store Connect the icon is visible.
What we have tried so far:
• Created an archive and manually uploaded it to App Store Connect → no icon in TestFlight.
• Took the working Icon Composer asset from another app target where everything works correctly, deleted the old one in this project, and copied the working asset into the problematic target. → Same behavior: visible on the device, but still missing in TestFlight and App Store Connect overview.
In contrast, in another app (using the same workflow and also Icon Composer), everything works perfectly: the icon shows up on the device, in TestFlight, and in App Store Connect.
Has anyone experienced a similar situation? Is there something specific that needs to be set in App Store Connect (e.g. Marketing Icon / Branding section), or could this be related to the new iOS 26 icon handling?
Any help or hints would be greatly appreciated.
Thanks in advance!
Topic:
App Store Distribution & Marketing
SubTopic:
App Store Connect
Tags:
App Store Connect
TestFlight
Icon Composer