Skip to content

Commit baf3aec

Browse files
Improve README instructions for macOS
Newer versions of the SDK do not work - both because osxcross is on an old version and newer versions of python are missing. The way `MACOS_SDK_FILE` works is also fairly confusing, so I've spelled that out.
1 parent 4299096 commit baf3aec

File tree

1 file changed

+14
-3
lines changed

1 file changed

+14
-3
lines changed

README.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -81,12 +81,23 @@ $ cargo build-docker-image i686-apple-darwin-cross \
8181
--build-arg 'MACOS_SDK_FILE=$FILE'
8282
```
8383

84-
If not provided, `MACOS_SDK_DIR` defaults to the build context of the Dockerfile. Note that this file must be a subdirectory of the build context.
84+
If not provided, `MACOS_SDK_DIR` defaults to the build context of the Dockerfile. `MACOS_SDK_FILE` *must* be a file within this repository's `docker/` folder. It also *must* keep the name given by osxcross, as version checks otherwise fail. For example:
85+
86+
```bash
87+
$ mv osxcross/MacOSX11.3.sdk.tar.xz cross-toolchains/docker/MacOSX11.3.sdk.tar.xz
88+
$ cargo build-docker-image aarc64-apple-darwin \
89+
--build-arg 'MACOS_SDK_FILE=MacOSX11.3.sdk.tar.xz'
90+
# or
91+
$ mv osxcross/MacOSX11.3.sdk.tar.xz cross-toolchains/docker/some-dir/MacOSX11.3.sdk.tar.xz
92+
$ cargo build-docker-image aarc64-apple-darwin \
93+
--build-arg 'MACOS_SDK_DIR=some-dir' \
94+
--build-arg 'MACOS_SDK_FILE=MacOSX11.3.sdk.tar.xz'
95+
```
8596

8697
Supported targets by SDK version (at least 10.7+):
8798
- `i686-apple-darwin`: SDK <= 10.13
88-
- `x86_64-apple-darwin`: any SDK version
89-
- `aarc64-apple-darwin`: SDK >= 10.16
99+
- `x86_64-apple-darwin`: SDK <= 13.0 or SDK <= 12.4
100+
- `aarc64-apple-darwin`: SDK >= 10.16 and (SDK <= 13.0 or SDK <= 12.4)
90101

91102
### iOS Targets
92103

0 commit comments

Comments
 (0)