The goal of OSXCross is to provide a well working OS X cross toolchain for
Linux, FreeBSD, OpenBSD and Android (Termux).
OSXCross works on x86, x86_64, ARM and AArch64.
For cross-compiling for OS X you need
- the Clang/LLVM compiler
- the cctools (lipo, otool, nm, ar, ...) and ld64
- the OSX SDK.
Clang/LLVM is a cross compiler by default and is now available on nearly every Linux distribution, so we just need a proper port of the cctools/ld64 and the OS X SDK.
OSXCross includes a collection of scripts for preparing the SDK and building the cctools/ld64.
It also includes scripts for optionally building
- Clang using gcc (for the case your distribution does not include it),
- an up-to-date vanilla GCC as a cross-compiler for target OS X,
- the "compiler-rt" runtime library, and
- the
llvm-dsymutil
tool required for debugging.
Basically everything you can build on OS X with clang/gcc should build with this cross toolchain as well.
OSXCross comes with a minimalistic MacPorts Packet Manager. See README.MACPORTS for more.
Move your packaged SDK to the tarballs/ directory.
Then ensure you have the following installed on your system:
Clang 3.4+
, cmake
, git
, patch
, Python
, libssl-devel
(openssl)
lzma-devel
, libxml2-devel
and the bash shell
.
You can run 'sudo tools/get_dependencies.sh' to get these (and the optional packages) automatically. (outdated)
Optional:
llvm-devel
: For Link Time Optimization supportllvm-devel
: For ld64-bitcode_bundle
supportuuid-devel
: For ld64-random_uuid
support
On Ubuntu trusty you must upgrade CMake to >= 3.2.3 first. Or do this:
curl -sSL https://cmake.org/files/v3.14/cmake-3.14.5-Linux-x86_64.tar.gz | sudo tar -xzC /opt
export PATH=/opt/cmake-3.14.5-Linux-x86_64/bin:$PATH
OSXCross uses clang
as the default compiler for building its tools, and also
as a cross-compiler to create OSX binaries.
In clang
there is no difference between cross-compilation and native
compilation, so OSXCross can use a normal clang
install for both. You can
use either a clang
installation you already have, or build your own from
source.
To build and install your own clang
from a recent source tree, using gcc
,
run:
./build_clang.sh
This installs clang
into /usr/local
. If you want to install somewhere
else, set the INSTALLPREFIX
variable. For example:
INSTALLPREFIX=/opt/clang ./build_clang.sh
To build the cross toolchain (using clang
), run:
./build.sh
Or, set variable UNATTENDED
to 1
to skip the prompt and proceed straight to
the build:
UNATTENDED=1 ./build.sh
(This will search 'tarballs' for your SDK and then build in its own directory.)
Once this is done: add <path>/target/bin
to your PATH variable so that
you can invoke the cross-compiler.
That's it. See usage examples below.
If you also want to build GCC as a cross-compiler, you can do that by running:
./build_gcc.sh
The script lets you select a GCC version by setting the variable GCC_VERSION
.
By default you get C and C++ compilers, but you can tell the script to build a
Fortran compiler as well:
GCC_VERSION=5.2.0 ENABLE_FORTRAN=1 ./build_gcc.sh
[A gfortran usage example can be found here]
Before you do this, make sure you have the GCC build depedencies installed on your system.
On debian like systems you can install these using:
sudo apt-get install gcc g++ zlib1g-dev libmpc-dev libmpfr-dev libgmp-dev
ATTENTION:
OSXCross links libgcc and libstdc++ statically by default (this affects
-foc-use-gcc-libstdc++
too). You can turn this behavior off with
OSXCROSS_GCC_NO_STATIC_RUNTIME=1
(env).
The build also creates aliases *-g++-libc++
which link with the clang
implementation of the C++ standard library instead of the GCC version. Don't
use these variants unless you know what you're doing.
Please ensure you have read and understood the Xcode license terms before continuing.
- [Download Xcode: https://developer.apple.com/download/more] **
- [Mount Xcode.dmg (Open With -> DiskImageMounter) ***]
- Run:
./tools/gen_sdk_package.sh
(from the OSXCross package) - Copy the packaged SDK (*.tar.* or *.pkg) on a USB Stick
- (On Linux/BSD) Copy or move the SDK into the tarballs/ directory of OSXCross.
**
-- Xcode up to 11 GM is known to work.
-- Use Firefox if you have problems signing in.
***
-- If you get a dialog with a crossed circle, ignore it.
-- You don't need to install Xcode.
Step 1. and 2. can be skipped if you have Xcode installed.
This method may require up to 25 GB of free disk space.
An SSD is recommended for this method.
- Download Xcode like described in 'Packaging the SDK on Mac OS X'
- Install
clang
,make
,libssl-devel
,lzma-devel
andlibxml2-devel
- Run
./tools/gen_sdk_package_pbzx.sh <xcode>.xip
- Copy or move the SDK into the tarballs/ directory
- Download Xcode like described in 'Packaging the SDK on Mac OS X'
- Install
cmake
,libxml2-dev
andfuse
- Run
./tools/gen_sdk_package_darling_dmg.sh <xcode>.dmg
- Copy or move the SDK into the tarballs/ directory
- Download Xcode like described in 'Packaging the SDK on Mac OS X'
- Ensure you have
clang
andmake
installed - Run
./tools/gen_sdk_package_p7zip.sh <xcode>.dmg
- Copy or move the SDK into the tarballs/ directory
- Download Xcode 4.2 for Snow Leopard
- Ensure you are downloading the "Snow Leopard" version
- Install
dmg2img
- Run (as root):
./tools/mount_xcode_image.sh /path/to/xcode.dmg
- Follow the instructions printed by
./tools/mount_xcode_image.sh
- Copy or move the SDK into the tarballs/ directory
-
Clang:
- 32 bit:
o32-clang++ test.cpp -O3 -o test
ORi386-apple-darwinXX-clang++ test.cpp -O3 -o test
- 64 bit:
o64-clang++ test.cpp -O3 -o test
ORx86_64-apple-darwinXX-clang++ test.cpp -O3 -o test
- 32 bit:
-
GCC:
- 32 bit:
o32-g++ test.cpp -O3 -o test
ORi386-apple-darwinXX-g++ test.cpp -O3 -o test
- 64 bit:
o64-g++ test.cpp -O3 -o test
ORx86_64-apple-darwinXX-g++ test.cpp -O3 -o test
- 32 bit:
XX= the target version, you can find it out by running osxcross-conf
and
then see TARGET
.
You can use the shortcuts o32-...
for i386-apple-darwin...
, depending on
which you prefer.
I'll continue from here on with o32-clang
, but remember,
you can simply replace it with o32-gcc
or i386-apple-darwin...
.
make CC=o32-clang CXX=o32-clang++
CC=o32-clang CXX=o32-clang++ ./configure --host=i386-apple-darwinXX
Note: libc++ requires Mac OS X 10.7 or newer! If you really need C++11 for an older OS X version, then you can do the following:
- Build GCC so you have an up-to-date libstdc++
- Build your source code with GCC or
clang++-gstdc++
/clang++ -foc-use-gcc-libstdc++
Usage Examples:
-
Clang:
- C++98:
o32-clang++ -stdlib=libc++ -std=c++98 test.cpp -o test
- C++11:
o32-clang++ -stdlib=libc++ -std=c++11 test1.cpp -o test
- C++14:
o32-clang++ -stdlib=libc++ -std=c++14 test1.cpp -o test
- C++17:
o32-clang++ -stdlib=libc++ -std=c++17 test1.cpp -o test
- C++2a:
o32-clang++ -stdlib=libc++ -std=c++2a test1.cpp -o test
- C++98:
-
Clang (shortcut):
- C++98:
o32-clang++-libc++ -std=c++98 test.cpp -o test
- C++11:
o32-clang++-libc++ -std=c++11 test.cpp -o test
- C++14:
o32-clang++-libc++ -std=c++14 test.cpp -o test
- C++17:
o32-clang++-libc++ -std=c++17 test.cpp -o test
- C++2a:
o32-clang++-libc++ -std=c++2a test.cpp -o test
- C++98:
-
GCC
- C++11:
o32-g++-libc++ -std=c++11 test.cpp
- C++14:
o32-g++-libc++ -std=c++14 test.cpp -o test
- C++17:
o32-g++-libc++ -std=c++17 test.cpp -o test
- C++2a:
o32-g++-libc++ -std=c++2a test.cpp -o test
- C++11:
- build the first object file:
o32-clang++ test1.cpp -O3 -flto -c
- build the second object file:
o32-clang++ test2.cpp -O3 -flto -c
- link them with LTO:
o32-clang++ -O3 -flto test1.o test2.o -o test
- Clang:
o64-clang++ test.cpp -O3 -arch i386 -arch x86_64 -o test
- GCC:
- build the 32 bit binary:
o32-g++ test.cpp -O3 -o test.i386
- build the 64 bit binary:
o64-g++ test.cpp -O3 -o test.x86_64
- use lipo to generate the universal binary:
x86_64-apple darwinXX-lipo -create test.i386 test.x86_64 -output test
- build the 32 bit binary:
The default deployment target is:
SDK <= 10.13: Mac OS X 10.6
SDK >= 10.14: Mac OS X 10.9
However, there are several ways to override the default value:
- by passing
OSX_VERSION_MIN=10.x
to./build.sh
- by passing
-mmacosx-version-min=10.x
to the compiler - by setting the
MACOSX_DEPLOYMENT_TARGET
environment variable
>= 10.9 also defaults to libc++
instead of libstdc++
, this behavior
can be overriden by explicitly passing -stdlib=libstdc++
to clang.
x86_64h defaults to Mac OS X 10.8
and requires clang 3.5+.
x86_64h = x86_64 with optimizations for the Intel Haswell Architecture.
- multiarch/crossbuild: various cross-compilers (Systems: Linux, OS X, Windows, Archs: x86_64, i386, arm, ppc, mips) in Docker. OSXCross powers the Darwin builds.
- Smartmontools
- scripts/wrapper: GPLv2
- cctools/ld64: APSL 2.0
- xar: New BSD