Theos/Setup/iOS: Difference between revisions

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.
- http://coolstar.org/publicrepo
- http://nix.howett.net/theos
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

@@ Line 11: / Line 11: @@
 === Optional Requirements ===
-* Knowledge on how to use a command line/terminal.
+* 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 <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&#10;ln -s $THEOS/makefiles/targets/Darwin-arm $THEOS/makefiles/targets/Darwin-arm64</pre>