Skip to content

fix(darwin): update minimum macOS version from 10.15 to 12.0#5181

Draft
leaanthony wants to merge 1 commit intomasterfrom
fix/5161-mac-min-build-version
Draft

fix(darwin): update minimum macOS version from 10.15 to 12.0#5181
leaanthony wants to merge 1 commit intomasterfrom
fix/5161-mac-min-build-version

Conversation

@leaanthony
Copy link
Copy Markdown
Member

Description

Updates the minimum macOS deployment target from 10.15 (Catalina) to 12.0 (Monterey) in build templates and example projects.

Since Go 1.25, the linker embeds LC_BUILD_VERSION with minos 12.0 into Mach-O binaries. This means apps built with Go 1.25+ physically cannot run on macOS < 12. The mismatch between LSMinimumSystemVersion (10.15) and the actual binary minimum (12.0) caused apps to silently crash on older macOS with no error dialog.

Setting LSMinimumSystemVersion to 12.0 ensures macOS shows a clear dialog: "MyApp" requires macOS 12 or later.

Files updated:

  • updatable_build_assets/darwin/Info.plist.tmpl + Info.dev.plist.tmpl (LSMinimumSystemVersion)
  • build_assets/darwin/Taskfile.yml (CGO_CFLAGS, CGO_LDFLAGS, MACOSX_DEPLOYMENT_TARGET)
  • All example project build files for consistency

Not changed: Runtime @available(macOS 10.15, *) guards and the version name map in os_darwin.go — these are feature detection checks, not minimum version declarations.

Fixes #5161

Type of change

  • Bug fix (non-breaking change which fixes an issue)

How Has This Been Tested?

  • Verified only template/build files were modified, not runtime feature checks
  • Confirmed no remaining 10.15 references in plist/yml files

Checklist:

  • My code follows the general coding style of this project
  • My changes generate no new warnings

Since Go 1.25, the linker embeds LC_BUILD_VERSION with minos 12.0 into
Mach-O binaries, meaning apps physically cannot run on macOS < 12.
The mismatch between LSMinimumSystemVersion (10.15) and the actual
binary minimum (12.0) caused apps to silently crash on older macOS
with no error dialog.

Updating to 12.0 ensures macOS shows a clear dialog:
"MyApp requires macOS 12 or later."

Updated:
- Info.plist.tmpl / Info.dev.plist.tmpl (LSMinimumSystemVersion)
- build_assets/darwin/Taskfile.yml (CGO flags, MACOSX_DEPLOYMENT_TARGET)
- All example build files for consistency

Runtime @available checks and version name maps are unchanged.

Fixes #5161
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 19, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a844677b-056c-4bca-8a22-64d5b6a47b5a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/5161-mac-min-build-version

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@leaanthony leaanthony changed the base branch from v3-alpha to master April 29, 2026 13:07
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.

[v3] mac minimum build version should be 12.0

1 participant