How to integrate .icon files created with Icon Composer

I wanted to integrate the new .icon icon format created with Icon Composer into an Xcode project, but I had trouble finding the official documentation. Here it is:

Creating your app icon using Icon Composer

Add your Icon Composer file to an Xcode project
In the project editor, select the target and the General tab. Under App Icons and Launch Screen, ensure that the name in the App Icon text field matches the name of the Icon Composer file without the extension. You can have multiple Icon Composer files in your project but only one that matches the name in the App Icon text field.

First, add the .icon file to an appropriate location in the Xcode project navigator to include it in the project. Make sure to check the target membership as well.

Next, in the "App Icon" field under "App Icons and Launch Screen" on the target's General tab, enter the name of the .icon file without the extension.

Image is from Xcode 16.3

Since it may not be reflected even if you build as it is, try rebuilding after clearing the cache^[1]. Then, the icon will reflect the Liquid Glass style of OS 26.

脚注

1. Menu Bar > Product > Clean Build Folder… ⇧⌘K