42 lines
2.2 KiB
Markdown
42 lines
2.2 KiB
Markdown
# SolidCraft macOS icon
|
|
|
|
`SolidCraft.icon/` is the approved Icon Composer source, containing separate
|
|
grid and solid SVG layers and the owner's appearance settings. The saturated
|
|
blue solid has transparent geometry cutouts instead of painted edge lines.
|
|
The solid and grid are both scaled to 90%, with separate Default and Dark grid artwork.
|
|
Icon Composer supplies the system backdrop and Mono material effects.
|
|
Artwork is original and attributed in `ATTRIBUTION.md`.
|
|
|
|
`Assets.car` is compiled by Apple's `actool` and supplies the layered icon on
|
|
macOS 26 and later. It is checked in so the existing release workflow can still
|
|
package on older Xcode runners. After editing and saving `SolidCraft.icon`,
|
|
regenerate the catalog with Xcode 26 or later from the repository root:
|
|
|
|
```sh
|
|
mkdir -p target/macos-icon
|
|
xcrun actool assets/SolidCraft.icon \
|
|
--compile target/macos-icon --platform macosx \
|
|
--minimum-deployment-target 11.0 --app-icon SolidCraft \
|
|
--output-partial-info-plist target/macos-icon/icon-info.plist \
|
|
--output-format human-readable-text
|
|
cp target/macos-icon/Assets.car assets/Assets.car
|
|
cp target/macos-icon/SolidCraft.icns assets/icon.icns
|
|
```
|
|
|
|
`icon.icns` is the older-macOS fallback generated by the same Apple compiler
|
|
from the approved composition, retaining its layer sizes and positions.
|
|
Regenerate both compiled resources together with the commands above.
|
|
`icon.vectorcraft`, `icon.svg`, `icon.png` and `icon.iconset/` retain the earlier
|
|
VectorCraft artwork; packaging uses the Icon Composer compilation instead.
|
|
|
|
Only `packaging/macos/package.sh` consumes these resources. Its existing signed
|
|
app/DMG workflow copies the catalog and ICNS into `Contents/Resources`, and
|
|
`Info.plist` references `SolidCraft` through `CFBundleIconName` and
|
|
`CFBundleIconFile`. The macOS viewport opts out of eframe's runtime bitmap so
|
|
Finder, the Dock and the application switcher use the bundle icon. Other
|
|
platforms retain the existing code-drawn icon and packaging.
|
|
|
|
Design references: [Apple app-icon HIG](https://developer.apple.com/design/human-interface-guidelines/app-icons)
|
|
and [Icon Composer documentation](https://developer.apple.com/documentation/xcode/creating-your-app-icon-using-icon-composer).
|
|
No Apple artwork is shipped.
|