/xcode-cross

Cross compilation with Xcode tools

Primary LanguageShell

Cross compilation with Xcode tools

This is a reproducible Dockerfile for cross compiling for Apple platforms from Linux, usable as base image for CI style setups.

This builds on cctools-port for providing the basic tools for cross compilation, together with xcbuild for building xcode project files, wrapping it up into a easy to use and reproducible Dockerfile.

Not all build tools used by Xcode project files are available; some are stubbed out (like ibtool), making it usable as a CI tool for testing compilation, while other Xcode project file features makes the build fail altogether.

This setup currently uses a vanilla LLVM/Clang release instead of the Apple provided clang sources.

This requires an original Xcode.app bundle (which can't be redistributed freely). It has been tested with and should work with Xcode versions 7, 8, 9 and 10. Older versions of Xcode can be downloaded from Apple.

Using an Xcode 11 or 12 bundle works somewhat; building with generic build systems works fine, but there's a few known issues if building Xcode project files with xcbuild, for other than the simplest project files. (For Xcode 12, xcbuild doesn't seem to work at all.)

The Xcode bundle can be stripped down to more manageable sizes for use with this cross compilation setup, since very little of the bundle actually is used:

cp -a /Applications/Xcode.app .
./strip-xcode.sh Xcode.app
tar -Jcvf xcode.tar.xz Xcode.app
rm -rf Xcode.app

Host the resulting xcode.tar.xz file somewhere, then build the docker image like this:

docker build --build-arg XCODE_URL=http://path/to/your/xcode.tar.xz .

The docker image has got all the necessary tools added to the path, but at the end of the path, so that e.g. gcc still resolves to the normal host compiler (for cases when projects need to compile things for both the host and the target). The cross tools can be used with normal cross compilation prefixes like x86_64-apple-darwin-gcc (which invokes clang, not gcc), or less architecturally biased like apple-darwin-gcc (for cases when the architecture will be specified with an -arch parameter.