Repository files navigation

master:

• Usescctools 986 andld64 711. Known to be stable and well-working.

2.0-llvm-based:

• OSXCross based on LLVM tools.
  Easiest to build and recommended for new projects.
  Does not support building fori386.

testing:

• Uses the latest versions ofcctools andld64 — currentlycctools 1024.3 andld64 955.13.
  Takes the longest to build due to additional dependencies introduced in the latest versions.

ppc-test:

• An older branch with support for PPC targets.

OSXCross provides a macOS cross-compilation toolchain.

• Host OSes: Linux, *BSD
• Host architectures: x86, x86_64, ARM, AArch64/arm64
• Target architectures: arm64, arm64e, x86_64, i386

macOS cross-compilation requires:

• Clang/LLVM (cross-compilation supported by default)
• A macOS SDK

This branch of OSXCross usescctools-port.cctools-port provides toolchain tools such asar,lipo,otool, andld64 as linker.

OSXCross provides a set of scripts for preparing the SDK, buildingcctools-port (along with its dependencies), and compiling the compiler wrapper.

It also includes scripts for optionally building:

• Up-to-date LLVM tools and clang (./build_clang.sh,./build_apple_clang.sh)
• Vanilla GCC as a cross-compiler for target macOS (./build_gcc.sh
• The "compiler-rt" runtime library (./build_compiler_rt.sh)

A minimal MacPorts package manager is included.SeeREADME.MACPORTS.md.

Place yourpackaged SDK in thetarballs/ directory.

Install the following dependencies:

clang cmake git patch python libssl-dev lzma-dev libxml2-dev xz bzip2 cpio libbz2 zlib1g-dev bash

Optional:

• llvm-dev: For Link Time Optimization support andld64-bitcode_bundle support
• uuid-dev: For ld64-random_uuid support

You can runsudo tools/get_dependencies.sh to get these (and the optional packages) automatically. (outdated)

./build_clang.sh# Builds mainline Clang./build_apple_clang.sh# Builds Apple's ClangINSTALLPREFIX=/opt/clang ./build_clang.sh# Custom install path

By default, this installs the osxcross toolchain into<current-directory>/target.
To specify a different installation path or run the build unattended,
set theTARGET_DIR and/orUNATTENDED environment variables accordingly.

./build.sh [TARGET_DIR=/usr/local/osxcross] [OSX_VERSION_MIN=XX.X] [UNATTENDED=1] ./build.sh

Add<target>/bin to yourPATH after installation.

./build_gcc.shGCC_VERSION=5.2.0 ENABLE_FORTRAN=1 ./build_gcc.sh

Install GCC dependencies:

sudo apt-get install gcc g++ zlib1g-dev libmpc-dev libmpfr-dev libgmp-dev

Notes:

• To enable-Werror=implicit-function-declaration, setOSXCROSS_ENABLE_WERROR_IMPLICIT_FUNCTION_DECLARATION=1
• To disable static linking:OSXCROSS_GCC_NO_STATIC_RUNTIME=1
• *-g++-libc++ uses Clang's libc++ — only use if needed

Please ensure you have read and understood the Xcode license terms before continuing.

SDKs can be extracted either from the full Xcode or from the Xcode Command Line Tools.

From Full Xcode

1. Download Xcode
2. MountXcode.dmg (Right-click → Open With → DiskImageMounter)
   • If you see a crossed-circle dialog when mounting, ignore it — installation of Xcode is not required
3. Run:./tools/gen_sdk_package.sh (from the OSXCross package)
4. Copy the resulting SDK (*.tar.* or*.pkg) to a USB stick
5. On Linux/BSD, move the SDK to thetarballs/ directory of OSXCross

From Command Line Tools

1. Download Command Line Tools
2. Mount theCommand_Line_Tools_for_Xcode.dmg (Open With → DiskImageMounter)
3. InstallCommand Line Tools.pkg (Open With → Installer)
4. Run:./tools/gen_sdk_package_tools.sh
5. Copy the resulting SDK (*.tar.* or*.pkg) to a USB stick
6. On Linux/BSD, move the SDK to thetarballs/ directory of OSXCross

Method 1 (Xcode > 8.0)
Requires up to 45 GB free disk space. SSD strongly recommended.

1. Download Xcode as described above
2. Install:clang,make,libssl-devel,lzma-devel, andlibxml2-devel
3. Run:./tools/gen_sdk_package_pbzx.sh <xcode>.xip
4. Move the SDK to thetarballs/ directory

Method 2 (up to Xcode 7.3)

1. Download Xcode as described above
2. Install:cmake,libxml2-dev, andfuse
3. Run:./tools/gen_sdk_package_darling_dmg.sh <xcode>.dmg
4. Move the SDK to thetarballs/ directory

Method 3 (up to Xcode 7.2)

1. Download Xcode as described above
2. Ensureclang andmake are installed
3. Run:./tools/gen_sdk_package_p7zip.sh <xcode>.dmg
4. Move the SDK to thetarballs/ directory

Method 4 (Xcode 4.2)

1. Download Xcode 4.2 for Snow Leopard (ensure it's the correct version)
2. Installdmg2img
3. As root, run:./tools/mount_xcode_image.sh /path/to/xcode.dmg
4. Follow the on-screen instructions from the script
5. Move the SDK to thetarballs/ directory

From Xcode Command Line Tools

1. Download Command Line Tools as described above
2. Install:clang,make,libssl-devel,lzma-devel, andlibxml2-devel
3. Run:./tools/gen_sdk_package_tools_dmg.sh <command_line_tools_for_xcode>.dmg
4. Move the SDK to thetarballs/ directory

• i386:i386-apple-darwinXX-clang++ test.cpp -O3 -o test (if your SDK supportsi386)
• x86_64:x86_64-apple-darwinXX-clang++ test.cpp -O3 -o test
• arm64:arm64-apple-darwinXX-clang++ test.cpp -O3 -o test
• arm64e:arm64e-apple-darwinXX-clang++ test.cpp -O3 -o test

Or by using xcrun:

• i386:xcrun clang++ -arch x86_64 test.cpp -O3 -o test
• x86_64:xcrun clang++ -arch x86_64 test.cpp -O3 -o test
• arm64:xcrun clang++ -arch arm64 test.cpp -O3 -o test
• arm64e:xcrun clang++ -arch arm64e test.cpp -O3 -o test

GCC: Replaceclang++ withg++ as needed

Check your target version withosxcross-conf, seeTARGET.

xcrun -f clang prints the path to clang.

make CC=$(xcrun -f clang) CXX=$(xcrun -f clang++)

CC=x86_64-apple-darwinXX-clang CXX=x86_64-apple-darwinXX-clang++ ./configure --host=x86_64-apple-darwinXX

xcrun clang++ -stdlib=libc++ -std=c++11 test.cpp -otest

Shortcut:

x86_64-apple-darwinXX-clang++-libc++ -std=c++11 test.cpp -otest

xcrun clang++ test1.cpp -O3 -flto -cxcrun clang++ test2.cpp -O3 -flto -cxcrun clang++ -O3 -flto test1.o test2.o -otest

xcrun clang++ test.cpp -O3 -arch x86_64 -arch arm64 -otest

GCC:

xcrun g++ -arch x86_64 test.cpp -O3 -o test.x86_64xcrun g++ -arch arm64 test.cpp -O3 -o test.arm64xcrun lipo -create test.x86_64 test.arm64 -outputtest

Default:

• SDK ≤ 10.13 → macOS 10.6
• SDK ≥ 10.14 → macOS 10.9
• SDK ≥ 14.0 → macOS 10.13

Can be overriden via:

1. During the build:OSX_VERSION_MIN=XX.X ./build.sh.
2. By passing-mmacos-version-min=XX.X to the compiler.
3. By settingMACOSX_DEPLOYMENT_TARGET=XX.X env var.

Note: Deployment target ≥ 10.9 defaults tolibc++.
Can be explicitely overriden by setting the C++ library tolibstdc++ via-stdlib=libstdc++.

• multiarch/crossbuild:
  various cross-compilers
  (Systems: Linux, macOS, Windows,Archs: x86_64,i386, arm, ppc, mips)
  in Docker. OSXCross powers the Darwin builds.
• Smartmontools

• scripts/wrapper: GPLv2
• cctools/ld64: APSL 2.0 (legacy)
• xar: New BSD