Skip to content

ci: Add xcodebuild -runFirstLaunch for actool support in CI - #45

Merged
jatinkrmalik merged 1 commit into
mainfrom
ci/fix-actool-on-ci
Mar 6, 2026
Merged

ci: Add xcodebuild -runFirstLaunch for actool support in CI#45
jatinkrmalik merged 1 commit into
mainfrom
ci/fix-actool-on-ci

Conversation

@jatinkrmalik

Copy link
Copy Markdown
Member

Problem

The app icon doesn't display in Finder when VocaMac is built on CI. The DMG from releases shows a generic white icon.

Root Cause

actool (the Asset Catalog compiler) requires Xcode's first-launch initialization to load its plugins. Without running xcodebuild -runFirstLaunch, actool fails silently and build.sh falls back to .icns-only — missing the Assets.car that modern macOS requires for icon rendering.

Fix

Added sudo xcodebuild -runFirstLaunch step to both:

  • release.yml — before building the release app bundle
  • ci.yml — before verifying the app bundle

Also added an Assets.car presence check in the CI verification step.

Impact

Future releases will have the correct app icon in Finder and DMG without needing manual asset uploads.

actool requires Xcode's first-launch initialization to load its
plugins. Without this, build.sh falls back to .icns-only (no Assets.car),
causing the app icon to not display in Finder.

Added to both release and CI workflows.
@jatinkrmalik
jatinkrmalik merged commit b03a1a6 into main Mar 6, 2026
1 check passed
@jatinkrmalik
jatinkrmalik deleted the ci/fix-actool-on-ci branch August 22, 2026 05:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant