Custom SDK for iPhoneOS3.0 using only OSS sources

Compiler Requirements: Building and using this SDK requires clang. When using the SDK a non Apple clang version is recommended.

Build SDK

Note

: Requires a pre-built SDK for bootstrapping. Download the latest version from releases and extract it to the project root.

Note

: On macOS building the SDK requires both a LLVM clang and Apple's clang. LLVM clang is used for building the target components while Apple's clang is used to build the hosts components (ld and lipo).

cmake -S . -B build
cmake --build build

Create SDK

cmake --install build

Using the SDK

The SDK has two main purposes: providing a sysroot for cross-compilation and supplying the necessary cctools for building applications.

Method 1: Direct Clang Flags

Configure your buildby passing the appropriate flags to clang:

# Set the sysroot
clang -isysroot /path/to/sdk

# Provide cctools
clang -B/path/to/sdk/usr/bin

# Combined usage
clang -isysroot /path/to/sdk -B/path/to/sdk/usr/bin [other flags] source.c

Method 2: CMake Toolchain

For CMake projects, use the provided toolchain file to automatically configure the build environment:

cmake -DCMAKE_TOOLCHAIN_FILE="/path/to/sdk/cmake/Toolchain/common-3.0.cmake" -S . -B build
cmake --build build

Licensing

This SDK contains components under multiple licenses:

Build System and Custom Components

• This includes CMake Scripts and Header Extraction Scripts
• License: MPL 2.0 (see licenses/MPL-2.0)

Apple Open Source Components

• This includes cctools-port, csu and headers from several apple open source libraries
• License: APSL (see licenses/APSL)

GNU libgcc Library

• License: GPLv2 (see licenses/GPLv2)

Build Dependencies

The following libraries are used for building but are not included in the SDK:

pygit2

• License: GPLv2 with linking exception (see pypi)

PyYAML

• License: MIT (see pypi)

Windows-Specific Components

The following additional components are only included in Windows builds:

mman-win32

• License: MIT (see licenses/COPYING.mman)

dlfcn-win32

• License: MIT (see licenses/COPYING.dlfcn)

libstdc++

• License: GPL-3.0-or-later with the GCC-exception-3.1 (see licenses/COPYING.libc++)

libgcc

• License: GPL-3.0-or-later with the GCC-exception-3.1 (see licenses/COPYING.libgcc)

winpthreads

• License: MIT and BSD Style License (see licenses/COPYING.winpthreads)

Important disclaimer

This project is not affiliated with or endorsed by Apple Inc in any way. iPhone, iOS, iPod, iPod touch and iPad are trademarks of Apple Inc in the United States and other countries.