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 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 Dependancies
- Install
iOS Toolchain
with Cydia. - Add the following repositories to your Cydia sources.
- Install the following packages in Cydia:
Perl
Theos
- Check that Theos is correctly installed by running:
$THEOS
The output should be:/var/theos: is a directory
Retrieving an iOS SDK
For this, you can download the SDK directly on your device or download the SDK using a web browser on a computer and transferring it to your device with SSH.
On the Device
- Install
wget
with Cydia. - Select a directory to download the SDK.
/var/mobile/Documents
is a good choice:cd /var/mobile/Documents
- Now download an SDK using
wget
:wget http://iphone.howett.net/sdks/dl/iPhoneOS8.1.sdk.tbz2
Using a Computer
- With a web browser, navigate to http://iphone.howett.net/sdks.
- Download the latest iOS SDK available (currently 8.1).
- Using SSH, transfer the file to your iOS device.
Setting up the iOS SDK
- Create a directory for the SDK to be placed in:
mkdir $THEOS/sdks
- Move the SDK to the directory we just created:
mv /var/mobile/Documents/iPhoneOS8.1.sdk.tbz2 $THEOS/sdks/
- Extract the SDK from the tar archive:
tar xjvf iPhoneOS8.1.sdk.tbz2
- Delete the archive file as we don't need it anymore:
rm iPhoneOS8.1.sdk.tbz2
Additional Step for 64 bit (ARM64) Devices
With the current version of Theos, it does not support building on ARM64. The following will solve this issue.
- 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