(I think that the tutorials for each device should be split into the platform Theos is being setup on. The current layout of Theos/Setup is confusing due to instructions being fragmented across the page.) |
mNo edit summary |
||
Line 11: | Line 11: | ||
=== Optional Requirements === | === Optional Requirements === | ||
* Knowledge on how to use a command line | * Knowledge on how to use a command line terminal. | ||
* Objective C knowledge. | * 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 <code>iOS Toolchain</code> with Cydia. | |||
# Add the following repositories to your Cydia sources. | |||
#* http://coolstar.org/publicrepo | |||
#* http://nix.howett.net/theos | |||
# Install the following packages in Cydia: | |||
#* <code>Perl</code> | |||
#* <code>Theos</code> | |||
# Check that Theos is correctly installed by running: <code>$THEOS</code><br />The output should be: <code>/var/theos: is a directory</code> | |||
== 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 <code>wget</code> with Cydia. | |||
# Select a directory to download the SDK. <code>/var/mobile/Documents</code> is a good choice: <pre>cd /var/mobile/Documents</pre> | |||
# Now download an SDK using <code>wget</code>: <pre>wget http://iphone.howett.net/sdks/dl/iPhoneOS8.1.sdk.tbz2</pre> | |||
=== 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: <pre>mkdir $THEOS/sdks</pre> | |||
# Move the SDK to the directory we just created: <pre>mv /var/mobile/Documents/iPhoneOS8.1.sdk.tbz2 $THEOS/sdks/</pre> | |||
# Extract the SDK from the tar archive: <pre>tar xjvf iPhoneOS8.1.sdk.tbz2</pre> | |||
# Delete the archive file as we don't need it anymore: <pre>rm iPhoneOS8.1.sdk.tbz2</pre> | |||
== 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: <pre>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</pre> |
Revision as of 21:58, 11 January 2015
This page is for setting up Theos on an iOS Device. For other platforms see Theos/Setup.
This page is currently under construction, so information may be incomplete. Use at your own risk.
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