From 25ccd71ff83a1b6e961588ee65c9f18a7c8f0a92 Mon Sep 17 00:00:00 2001 From: Randy Eckenrode Date: Tue, 7 Jun 2022 00:18:19 -0400 Subject: [PATCH] doc: update Darwin platform doc regarding the 11.0 SDK --- doc/stdenv/platform-notes.chapter.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/stdenv/platform-notes.chapter.md b/doc/stdenv/platform-notes.chapter.md index 03e61e333f8b..b47f5af349b8 100644 --- a/doc/stdenv/platform-notes.chapter.md +++ b/doc/stdenv/platform-notes.chapter.md @@ -60,3 +60,8 @@ Some common issues when packaging software for Darwin: ``` The package `xcbuild` can be used to build projects that really depend on Xcode. However, this replacement is not 100% compatible with Xcode and can occasionally cause issues. + +- x86_64-darwin uses the 10.12 SDK by default, but some software is not compatible with that version of the SDK. In that case, + the 11.0 SDK used by aarch64-darwin is available for use on x86_64-darwin. To use it, reference `apple_sdk_11_0` instead of + `apple_sdk` in your derivation and use `pkgs.darwin.apple_sdk_11_0.callPackage` instead of `pkgs.callPackage`. On Linux, this will + have the same effect as `pkgs.callPackage`, so you can use `pkgs.darwin.apple_sdk_11_0.callPackage` regardless of platform.