Updating extensions for iOS 7

From iPhone Development Wiki
Revision as of 01:58, 1 January 2014 by Wesley6j (talk | contribs) (How to compile for ARMv6 and ARM64 using the iOS 7 SDK)
Jump to: navigation, search

This is an informal collection of advice; feel free to add to it and rearrange. A lot of this is from #theos on irc.saurik.com - if you're working on updating your tweaks and you use Theos, join in and share what you've learned (see IRC).

How to compile for ARMv6 and ARM64 using the iOS 7 SDK

These instructions only use first-party components from Apple, DHowett, and saurik (and were written by saurik).

The idea is that we are going to use parts of Xcode 4 (which you don't have to install: you might just have it sitting in /Volumes) to "fix" parts of Xcode 5 so that it can target armv6 (need Xcode 4.4.1).

cd $Xcode5/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/5.0/lib/darwin/
mv libclang_rt.ios.a libclang_rt.ios-7.0.a
lipo -thin armv6 -output libclang_rt.ios-5.1.a $Xcode4/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/4.0/lib/darwin/libclang_rt.ios.a
lipo -create -output libclang_rt.ios.a libclang_rt.ios-5.1.a libclang_rt.ios-7.0.a
cd $Xcode5/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS7.0.sdk/usr/lib/
mv dylib1.o dylib1-7.0.o
lipo -thin armv6 -output dylib1-5.1.o $Xcode4/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS5.1.sdk/usr/lib/dylib1.o
lipo -create -output dylib1.o dylib1-5.1.o dylib1-7.0.o

Then, we download Theos directly from DHowett's code repository, and add in the parts it needs from the various packages provided by saurik.

sudo mkdir /opt/theos
sudo chown "$(id -u):$(id -g)" /opt/theos
cd /opt/theos
git clone https://github.com/DHowett/theos.git .
wget http://apt.saurik.com/debs/ldid_1:1.1.2_iphoneos-arm.deb
ar p ldid_1:1.1.2_iphoneos-arm.deb data.tar.gz | tar -zxvf- --strip-components 2 ./usr/bin/ldid
wget http://apt.saurik.com/debs/mobilesubstrate_0.9.5000_iphoneos-arm.deb
ar p mobilesubstrate_0.9.5000_iphoneos-arm.deb data.tar.lzma >substrate.tar.lzma
... extract the lama file; OS X doesn't come with an lzma utility :( ...
tar -xvf substrate.tar --strip-components 3 ./Library/Frameworks/CydiaSubstrate.framework/
ln -s ../CydiaSubstrate.framework/Headers/CydiaSubstrate.h include/substrate.h
ln -s ../CydiaSubstrate.framework/CydiaSubstrate lib/libsubstrate.dylib

Finally, in our Theos Makefile, we specify that we want to target iOS 2.0 using the 7.0 SDK, and that we want both ARMv6 and ARM64 slices.

TARGET := iphone:7.0:2.0
ARCHS := armv6 arm64

Tweaks that do NOT need iOS 4.2.1 and below compatibility

Very easy, simply follow Kirb's advice on his blog: http://sharedinstance.net/2013/12/how-to-support-arm64/

Tweaks that do need iOS 4.2.1 and below compatibility

This is slightly more complicated. You need to compile an armv6 slice using the 5.1 SDK and another arm64 slice using the 7.0 SDK. You then stitch both together with lipo. Kirk's blog post describes how to do that manually, but rpetrich has created a theos fork, which does that automatically for you.

Setup rpetrich’s theos:

$ export THEOS=/opt/theos-rpetrich
$ sudo git clone https://github.com/rpetrich/theos $THEOS
$ wget http://joedj.net/ldid
$ sudo mv ldid $THEOS/bin/ldid
$ sudo chmod +x  $THEOS/bin/ldid
$ wget http://cdn.hbang.ws/dl/libsubstrate_arm64.dylib
$ sudo mv libsubstrate_arm64.dylib $THEOS/lib/libsubstrate.dylib

(note from rpetrich: theos should be as a submodule for my fork, not installed in a system path. system paths are dangerous)

Install headers:

$ cd $THEOS/; sudo ./git-submodule-recur.sh init; sudo git submodule update --recursive


Setup the Makefile

TARGET := iphone:clang
THEOS_PLATFORM_SDK_ROOT_armv6 = /Applications/Xcode_4.4.1.app/Contents/Developer
SDKVERSION_armv6 = 5.1
TARGET_IPHONEOS_DEPLOYMENT_VERSION = 3.0
TARGET_IPHONEOS_DEPLOYMENT_VERSION_arm64 = 7.0
IPHONE_ARCHS = armv6 arm64

TWEAK_NAME = iLogIt
iLogIt_FILES = Tweak.xm

include theos/makefiles/common.mk
include $(THEOS_MAKE_PATH)/tweak.mk


rpetrich's theos is using objc's hooking method instead of MobileSubstrate therefore it doesn't link with MS by default. This is OK if you are only hooking objc messages, but if you need to use MSHookFunction, you have to tell theos to link to lib substrate:

iLogIt_LIBRARIES = substrate

(note from saurik: I highly disrecommend not using Substrate's MSHookMessage implementation; I never understood why rpetrich doesn't use it, but on multiple occasions the way we hook messages has had to change, and centralizing it in Substrate means that I can fix it once for everyone's compiled extensions... this happened last as recently as iOS 5, and all of rpetrich's extensions had to be recompiled and redeployed, which is reasonably fine for him as he's insanely productive and around constantly, but for most people you should please just use the centralized implementation.)

Example Projects: Take a look at the Makefiles of these projects:

https://dl.dropboxusercontent.com/u/15373/Other/iPhone/ilogit-tweak-ios7-example.tar

https://github.com/joedj/ExchangePolicyCleaner/blob/master/Makefile#L3

https://github.com/a3tweaks/Flipswitch

Activator Listener for 64Bit

Activator binaries with support for arm64, armv6, armv7 and armv7s are available at http://rpetri.ch/repo/

Updating code for iOS 7

Detecting whether code is being compiled for iOS 7.0 or higher:

#if __IPHONE_OS_VERSION_MAX_ALLOWED >= 70000
    [[UIApplication sharedApplication] setStatusBarStyle: UIStatusBarStyleLightContent animated: YES];
#endif

Updating Depictions

It's best to make the background transparent to make it match Cydia's background. Just add the following to your depictions header:

<script>
if (navigator.userAgent.search(/Cydia/) != -1) {
	document.body.classList.add("cydia");
}
</script>

And in your CSS:

body.cydia {
	background: none !important;
}

Dealing with 64bit

https://developer.apple.com/library/ios/documentation/General/Conceptual/CocoaTouch64BitGuide/ConvertingYourAppto64-Bit/ConvertingYourAppto64-Bit.html

20:44:45 <@sbingner> saurik said all tweaks will need to be recompiled to have a 64bit slice

20:45:10 <@sbingner> which is what I've been working on... as soon as substrate is updated I should be able to just type "make" :D

20:49:27 <@sbingner> crash-x, installing rpetrich's fork of theos and making sure it can compile for armv6 with latest xcode on it... and that arm64 will compile except for the mobilesubstrate lib being missing

20:45:32 <@Optimo> dlopen from a variety of avenues, or ...INSERT_LIBRARIES -- all for your own testing of course

20:45:54 <@Optimo> (if you have a 64bit device)

If you need to specifically test for 64-bit:

#ifdef __LP64__
NSLog(@"64-bit\n");
#else
NSLog(@"32-bit\n");
#endif

Working with Mobile Substrate

21:22:35 < Alcatraz> https://ghostbin.com/paste/zhsx9 Tutorial to Make mobilesubstrate more stable while we wait for an official update.


Install MobileSubstrate

Add the repo: rpetri.ch/repo

Install the beta Activator

Done

Some Stuff that was broken before you installed the beta activator such as SBSettings and PreferenceLoader should be working now.

If they are not,it is likely another package that still wont work. Or you rebooted your device.

Rebooting the device seems to break mobilesubstrate for whatever reason.

So each time you reboot you have to reinstall mobilesubstrate or run this command:

/usr/bin/cynject 1 /Library/Frameworks/CydiaSubstrate.framework/Libraries/SubstrateLauncher.dylib && killall backboardd && sbreload

Theos advice

21:25:55 <@DHowett> This time, you're all wrong

21:25:59 <@sbingner> oh?

21:26:01 <@DHowett> theos passes -arch flags to the compiler, after all.

21:26:07 < Maximus> ARCH=armv7 and uh

21:26:08 <@sbingner> ^^

21:26:12 < Maximus> ARCHS

21:26:18 <@DHowett> alexzielenski: by default, theos passes armv7 armv7s to the compiler on 6.0+

21:26:39 <@DHowett> alexzielenski: you can override this by setting ARCHS=armv7 arm64 before you include common.mk

21:26:48 < alexzielenski> DHowett: thanks

21:27:10 <@sbingner> DHowett, what I said was wrong because it wasn't complete? :P

21:27:26 < Maximus> i was getting there

21:27:41 <@DHowett> sbingner: well, because it doesn't have anything to do with the compiler, really: this is all a compiler driver problem once you have upgraded xcode

21:27:43 <@sbingner> have time to point me to the right place to add support for foo_FILES_arch to rpetrich's fork? I'm missing the right spot

21:27:52 <@DHowett> instance/rules.mk

21:28:29 < coolstar> screw arm64

21:28:36 < coolstar> the build tools are still not out yet

21:28:36 < coolstar> http://opensource.apple.com/

21:28:37 <@sbingner> ok thanks... I guess I was in the right spot but doing something wrong lol... I'll figure it out

21:28:44 <@DHowett> the proprietary ones are.

21:28:50 <@DHowett> why is everybody focusing on this now?



01:03:36 < therpgitbot> [theos] rpetrich pushed 1 new commit to master: http://git.io/ankV8g

01:03:36 < therpgitbot> theos/master f6ebd79 Ryan Petrich: Workaround bootstrap problems on Xcode 5.x (temporary fix for now)



22:58:21 <%joedj> here's a tip: if you aren't using low-level substrate features like MSHookFunction, you may be able to prepare arm64-ready packages using %config(generator=internal). of course, they won't actually work until substrate can load them

Theos and ldid

12:11:37 < Ge0rges> if anyone here has a tip Still having this problem when installing ldid for theos: https://pastee.org/vasuu

12:28:42 <%joedj> Ge0rges: just put the ldid binary i gave you into theos/bin/ and move on to the next step

13:14:13 <%joedj> Ge0rges: http://joedj.net/ldid

Dealing with 32-bit and 64-bit

12:38:15 <%joedj> sbingner: i did find this question (and the response 2 posts down) interesting, i'm not sure what they're talking about: https://www.mikeash.com/pyblog/friday-qa-2013-09-27-arm64-and-you.html#comment-7436311d02c5a55738d1baefa03b0d34

[09:25] <rpetrich> joedj: it's a bug with the components that communicate with the App Store

Mobile Substrate tip

14:20:58 < ganbold_> so mobilesubstrate is working partially? after reboot/restart doesn't work

14:29:03 < ac3xx> ganbold_, either just reinstall it through cydia or run this over SSH - /var/lib/dpkg/info/mobilesubstrate.extrainst_ upgrade && killall SpringBoard

Theos and ldid errors

19:02:14 < yoshbu> I've been off the jailbreak train for awhile now. Trying to reinstall theos, getting some build failures when trying to install ldid, anybody know if there's a quick fix?


19:02:52 < yoshbu> like, error: unknown type name '__darwin_intptr_t'

19:02:59 < yoshbu> and, error: unknown type name '__uint32_t'; did you mean 'uint32_t'?

19:05:27 < Alcatraz> are you trying to compile ldid on mac?

19:05:55 < yoshbu> following step 4 of http://iphonedevwiki.net/index.php/Theos/Getting_Started

19:06:10 < Alcatraz> yeah compiling it has been broken for some time

19:06:27 < Alcatraz> has to do with xcode 5

19:06:32 < Alcatraz> pretty sure anyway

19:06:50 < yoshbu> ldid is a dependency of theos though right?

19:07:01 < Alcatraz> yeah. you can ask someone on here for a copy

19:07:23 -!- mindw0rk [~mindw0rk@78.57.233.231] has joined #theos

19:08:05 < ac3xx> yoshbu, wget http://ac3xx.com/ldid -O $THEOS/bin/ldid && chmod +x $THEOS/bin/ldid

Supporting iOS 4-7 with one binary & Example project link

23:59:59 <%joedj> sbingner: i used 5.1 SDK (xcode 4.4.1) for the armv6 slice, targetting 4.0: https://github.com/joedj/ExchangePolicyCleaner/blob/master/Makefile#L3

(also rpetrich's canonical example: https://github.com/a3tweaks/Flipswitch/blob/master/Makefile#L16 )

Day changed to 24 Dec 2013

00:01:43 <+crash-x> joedj: you can make a fat binary with the armv6 slice targetting 4.0 and the arm64 part targetting ios 7 and achieve support for iOS 4-7?

00:03:53 <+crash-x> joedj: is that project on github been updated for iOS 7 and rpetrich's theos fork?

00:04:09 <%joedj> crash-x: indeed, i believe so, although i think i've only tested down to ios6

00:04:10 <%joedj> crash-x: yes

00:04:22 <+crash-x> thats amazing, thank you!

00:04:25 -!- charliebashford [~charliebash@86.173.69.10] has quit [Client exited]

00:04:53 <+crash-x> if i wanted to get this working, what would i have to do? install rpetrich's theos fork and then I could just make package it or is there anything else I would have to install or do>

00:07:36 <%joedj> crash-x: there are a few other things like setting THEOS_PLATFORM_SDK_ROOT_armv6 (see the Makefile i just linked), and possibly switching to using %config(generator=internal) in your logos files unless you have an arm64 substrate you can link against (i think theos might be able to bootstrap this for you, but haven't tried)

00:08:04 <%joedj> crash-x: %config(generator=internal) might also be the default with rpetrich's fork, but i prefer to be explicit

Accessing the device's UDID

UDID access is blocked by default on iOS7 and iOS will substitute a generated ID in UIDevice's uniqueIdentifier property. Use MGCopyAnswer(CFSTR("UniqueDeviceID")) and link to libMobileGestalt.dylib to get access to the device ID from system processes or apps installed to \Applications. Device ID is completely inaccessible from app store processes and some daemons.

Ongoing issues

CPDistributedMessagingCenter doesn't work.
Printing a stack trace doesn't show symbols.