Research Updated Apr 05, 2024

How to compile libSandy

How to compile libSandy

libSandy is a developer library designed to enhance the sandboxing capabilities of apps, system processes, and custom modifications on jailbroken iOS devices in a secure manner. Through the utilization of sandbox APIs (refer to sandbox.h), any process gains the ability to generate extension tokens, each uniquely identifying the specific privileges it grants. These tokens, represented as strings, can then be seamlessly utilized by other processes to apply the corresponding extensions to their own operations.

This library serves as a cornerstone for several outstanding open-source theos tweaks, such as Flora, SafariPlus, Shadow, Kayoko, LetMeBlock, and AlbumManager. These jailbreak tweaks necessitate the inclusion of libSandy during compilation, with certain files needing to be relocated to the theos folder for those interested in building them from the source.

While compiling libSandy is a relatively straightforward process, newcomers to iOS theos tweak compilation might encounter errors when executing the 'make' command. Simply searching for solutions online may not yield the desired results. However, this article is designed to guide you through each step, providing a comprehensive tutorial on compiling libSandy specifically tailored for modern rootless jailbreaks including Dopamine and Palera1n.

Screenshot of libSandy build process in terminal app.

How to build libSandy for theos

To successfully compile libSandy, you need to utilize the iOS 16.2 SDK provided by Xcode 14.2. Attempting to compile libSandy with a later version of Xcode will result in a failure.

To compile a libSandy for theos, follow the steps:

Step 1. Install theos on your PC, Mac, or iOS device following our guide.

Step 2. Install iPhoneOS16.2.sdk by downloading Xcode 14.2 directly from Apple servers. You will need to authenticate with your Apple ID to download.

Step 3. Open the terminal app and extract Xcode_14.2.xip with the following command. After extraction, rename the app to not conflict with your primary installation of Xcode.

xip -x Xcode_14.2.xip

Step 4. Move Xcode_14.2.app to the Applications folder.

Step 5. Change your selected Xcode command line tools version. The following command will temporarily change your command line tools version for just this terminal session.

export DEVELOPER_DIR=/Applications/Xcode_14.2.app/Contents/Developer

or permanent

sudo xcode-select -switch /Applications/Xcode_14.2.app/Contents/Developer

If you need to use the latest Xcode toolchain from the command line, use --reset:

sudo xcode-select --reset

Step 6. Download mac-headers and copy the xpc folder to theos/include.

git clone https://github.com/realthunder/mac-headers/
cd mac-headers
cp -r "/usr/include/xpc" "$THEOS/include"

Step 7. Clone the libSandy repository from GitHub to your computer.

git clone https://github.com/opa334/libSandy

Step 8. Open the libSandy folder.

cd libSandy

Step 9. Compile libSandy following the 'make' command and install it to theos.

chmod +x ./install_to_theos.sh && chmod +x ./install_to_theos.sh

or manually...

make clean
make FINALPACKAGE=1

Step 10. Copy the generated libsandy.dylib into theos lib folder.

cp -Rv "./.theos/obj/libsandy.dylib" "$THEOS/lib"

Step 11. Compile the libSandy for rootless tweaks.

make clean 
make FINALPACKAGE=1 THEOS_PACKAGE_SCHEME=rootless

Step 12. Copy the generated libsandy.dylib rootless into theos folder.

cp -Rv "./.theos/obj/libsandy.dylib" "$THEOS/lib/iphone/rootless"

Step 13. Copy libSandy.h to the include folder located inside theos folder.

cp -v "./libSandy.h" "$THEOS/include"

Common libSandy compilation errors

One of the main hurdles faced when compiling libSandy for theos arises from using an incompatible version of Xcode. For instance, Xcode 15 typically includes the latest release of the iPhone iOS SDK, like iPhoneOS17.2.sdk. However, libSandy requires compilation using iPhoneOS16.2.sdk. If the incorrect iOS SDK version is used, errors may occur.

Screenshot of libSandy compilation errors.

  • libSandy.m:3:9: fatal error: 'xpc/xpc.h' file not found.
  • /libSandy/.theos/obj/armv7/libSandy.m.50b5a432.o] Error 1.
  • Building for iOS 8.0, but the current toolchain can’t produce arm64e binaries for iOS earlier than 14.0.
  • Error: Your chosen SDK, “iPhoneOS16.2.sdk”, does not appear to exist.

Sponsored links

Post a comment

Latest Posts

Software

Semaphorin

Semaphorin

Semaphorin originated from johndoe123's iOS 7 Tethered Downgrade guide and has evolved into a solution for downgrading A7, A8, A8X, and A9 devices, including iPhone 5s, iPhone 6, iPhone 6s, and iPhone SE (2016) to versions ranging from iOS...

iCloud Bypass

HFZ Ramdisk Universal

HFZ Ramdisk Universal

Checkm8 exploit serves various functions, including jailbreaking, enabling dual OS, or bypassing the iCloud Activation screen. It achieves this by permitting code execution exclusively when you connect your iPhone in DFU mode to your PC via a USB...

iCloud Bypass

SkynetTool AIO

SkynetTool AIO

Discover a range of comprehensive All-In-One solutions designed to bypass iCloud and offer a variety of other features. One such recent release is SkynetTool AIO, a powerful tool that provides everything you need to manage your iPhone. This tool...