Icon Composer Notes
I would not have figured out how to use this tool without help, so I wanted to pass along the correct way to use it.
[…]
On macOS, one sets an alternate icon by drawing it in code using the NSDockTile API. I believe Mac apps have no access to the system-wide Icon & widget style setting or the current tint color.
You can create an icon using
NSImage(named: String)and display it in the app with anNSImageView. If the icon has any variation between the light mode version, dark mode version, or mono version, the image drawn shows the mono version.When I add multiple
.iconfiles to a Mac app, Xcode seems to only include the app’s default icon. It seems to ignore the others. The icon is included as a.icnsfile that appears to be generated from the.iconfile. It is probably possible to generate those.icnsfiles some other way and include those as resources.
See also: Brad Ellis (via Mastodon).
Previously:
Update (2025-06-24): Keith Harrison:
You no longer need to add default, dark, and tinted variants of the app icon to the asset catalog in the app bundle. What you need to do is drag the Icon Composer .icon file into the project navigator sidebar of the Xcode project[…]
[…]
One final step, in your app target settings, make sure the App Icon Set Name matches the name of the Icon Composer icon file name (without the .icon extension)[…]
[…]
One thing that is missing is support for alternate app icons.
Update (2025-06-26): Sam Rowlands:
What am I doing wrong? Tahoe icons.
- Created Icon in Icon Composer.
- Added .icon file to Xcode project (not assets section).
- Renamed it to AppIcon.icon.
But it won’t show either when running or when archiving.
