Theos/Setup/iOS

This page is for setting up Theos on an iOS Device. For other platforms see Theos/Setup.

Requirements

Mandatory Requirements

• A jailbroken iOS device with Cydia (or another package manager) installed.

Optional Requirements

• Knowledge on how to use a command line terminal.
• Objective C knowledge.
• OpenSSH installed on your device and a computer that you can SSH into your device with (using MobileTerminal gets tedious pretty quickly).

Installing Theos and it's dependencies

1. Add the following repositories to your Cydia sources.
   • http://coolstar.org/publicrepo
   • http://nix.howett.net/theos
2. Install the following packages in Cydia:
   • Perl
   • Theos
   • iOS Toolchain
3. Check that Theos is installed on your device by running:

   echo $THEOS

   
   The output should be: /var/theos

Setting up the iOS SDK

Navigate to http://iphone.howett.net/sdks and check which iOS SDK you wish to download.

1. Create a directory for the SDK to be placed in:

   mkdir -p $THEOS/sdks

2. Download the SDK temporarily and extract to the SDK directory:

   curl -ksL "http://iphone.howett.net/sdks/dl/iPhoneOSX.Y.sdk.tbz2" | tar -xj -C $THEOS/sdks

   
   X.Y being the version numbers of the SDK, as seen in http://iphone.howett.net/sdks.

Additional Step for 64 bit (ARM64) Devices

With the current version of Theos (0.9.639-1), building on ARM64 will throw an error. The following will solve this issue.

1. Create symlinks to support ARM64:

   ln -s $THEOS/makefiles/platform/Darwin-arm.mk $THEOS/makefiles/platform/Darwin-arm64.mk
   ln -s $THEOS/makefiles/targets/Darwin-arm $THEOS/makefiles/targets/Darwin-arm64