FlexInjected

iOS 越狱的Tweak开发

iOS越狱开发中，各种破解补丁的统称为Tweak,通常意义上我们说的越狱开发,都是指开发一个Tweak. 基本上,tweak都依赖于一个名叫cydia Substrate (以前名字也叫mobile Substrate)的动态库,Mobile Substrate是Cydia的作者Jay Freeman (@saurik)的作品，也叫Cydia Substrate,它的主要功能是hook某个App，修改代码比如替换其中方法的实现，Cydia上的tweak都是基于Mobile Substrate实现的.

iOS的tweak开发可以有两种发布方式

只能在越狱设备上安装的打包成deb格式的安装包
直接使用开发者自己的证书/企业证书直接将补丁打包成ipa,这样不需要越狱也是可以安装的,只是这种非越狱的限制比较大,通常只是用来给某个app打个补丁或者类似的功能啥的

tweak是啥?

tweak的实质就是ios平台的动态库。IOS平台上有两种形势的动态库，dylib与framework。Framework这种开发者用的比较多，而dylib这种就相对比较少一点，比如libsqlite.dylib，libz.dylib等。而tweak用的正是dylib这种形势的动态库。我们可以在设备的**/Library/MobileSubstrate/DynamicLibraries**目录下查看手机上存在着的所有tweak。这个目录下除dylib外还存在着plist与bundle两种格式的文件，plist文件是用来标识该tweak的作用范围，而bundle是tweak所用到的资源文件

开发tweak最常用的theos环境安装

TheOS被设计为一个在基于Unix平台开发IOS程序的集成开发环境,它给我们准备好了一些代码模板、预置一些基本的Makefile脚本，这样我们开发一个tweak就会变得方便的多,这里我们不说简单的多,是因为其配置还是稍显繁琐的,并且,也不能像我们通常开发xcode工程那样方便的调试.

theos的开发者是大神DHowett,不过大从2015年开始,原作者不再更新,交给社区维护了,新的地址是https://github.com/theos/theos.

网上的多数教程都是基于原作者两年前的原始theos来配置环境的,原始的配置环境的方式相对来说比较繁琐. 这里,我们介绍最新的theos环境配置

最新环境的地址是 https://github.com/theos/theos 其实只要将git地址的内容下载下来,然后放到一个目录下就可以了,网上的教程都是放到/opt/theos

1.是将theos环境下载下来,theos是放在github上的,使用git命令来clone比较方便,虽然可以放在任何目录下,但是官方建议大家放在 /opt/下打开终端输入 export THEOS=/opt/theos #这个是建立一个环境变量方便后面的操作(引用这个环境变量是用$THEOS)

这种建立环境变量的方式,只是在当前终端中起作用了,关闭终端后又得重新设置,为了避免每次都建立这个环境变量,我们可以建立一个永久的环境变量
编辑~/.profile文件,在其中添加export THEOS=/opt/theos/,这个环境变量就是永久的了. ps:怎么查看定义了哪些环境变量呢? 终端中输入命令env!

git clone --recursive https://github.com/theos/theos.git $THEOS

这个目录和终端变量$THEOS只是方便我们操作,其实你也可以放在任何你想放置的目录. 新版的theos下载下来后,其内部已经内置了cydia framework和iOS的一系列私有的头文件等,不需要像以前版本那样,自己从手机上或者其它地方拷贝cydia的lib来了,其放置的目录是vendor/lib和vendor/include

,新版的已经是内置CydiaSubstrate.framework,不是网上其它教程中说的需要运行bootstrap.sh脚本或者是从手机上拷贝等方式.
备注:最新版的已经没有这个bootstrap.sh脚本文件了.2016.08.15,并且已经集成了最新的cydia Substrate,在目录Vendor/lib下这里的cydia使用的是framework模式了看到官方的git中有注释
[common] Move vendored includes and libraries to a vendor/ subdir.

旧版的中 ~~首先运行Theos的自动化配置脚本:~~ ~~ sudo /opt/theos/bin/bootstrap.sh substrate ~~ 由于Theos存在一个bug，所以无法自动生成一个有效的libsubstrate.dylib文件，需要手动添加，需>> 要再Cydia中搜索安装CydiaSubstrate，并且拷贝到电脑中，重命名为libsubstrate.dylib后放到/opt/theos/lib/中

2.配置用来签名的ldid,如果不安装,那么产生的deb文件就安装不到手机上, 用来专门签名iOS可执行文件的工具,用以在越狱iOS中取代Xcode自带的codesign.
安装这个ldid,推荐的方式是采用brew来安装-- brew install ldid

~~从http://joedj.net/ldid下载ldid,放到/opt/theos/bin/下,然后用命令chmod 777 /opt/theos/bin/ldid 来提升它的权限~~ ~~看到另一篇文章(http://www.kanxue.com/bbs/showthread.php?p=1303343)说的可以在 git clone git://git.saurik.com/ldid.git 下载编译ldid~~ ~~完成以上操作会在ldid目录下生产一个mac 可执行程序 ldid~~

3.配置dpkg-deb 新版的theos,其没有内置 dpkg-deb,需要你用brew来安装dpkg (brew install dpkg)

brew查看安装了哪些工具的命令是 brew list

如果你没安装,那么可能会收到如下警告

SZ-lingdaiping:FLEXLoader-master yohunl$ make package
==> Error: /Applications/Xcode.app/Contents/Developer/usr/bin/make package requires dpkg-deb.
make: *** [internal-package-check] Error 1

deb是越狱开发包的标准格式,dpkg-deb是个用于操作deb文件的工具,有了这个工具,Theos才能正确的把工程打包成deb文件,旧版的从https://github.com/DHowett/dm.pl 下载dm.pl文件(其实新版的theos的bin目录下包含了这个文件了),将其重命名为dpkg-deb后,放到/opt/theos/bin/目录下,chmod 777 /opt/theos/bin/dpkg-deb 来提升它的权限,再拷贝到theos/bin下了!!

4.配置Theos NIC templates (可选)

目前最新版的已经内置了所有模板了

tweak的demo简介

下面我们来创建一个默认的demo来简单说明一下打开一个终端,

$THEOS/bin/nic.pl

可以看到

NIC 2.0 - New Instance Creator
------------------------------
  [1.] iphone/activator_event
  [2.] iphone/application_modern
  [3.] iphone/cydget
  [4.] iphone/flipswitch_switch
  [5.] iphone/framework
  [6.] iphone/ios7_notification_center_widget
  [7.] iphone/library
  [8.] iphone/notification_center_widget
  [9.] iphone/preference_bundle_modern
  [10.] iphone/tool
  [11.] iphone/tweak
  [12.] iphone/xpc_service
Choose a Template (required):

通常我们建立的都是tweak,所以选11(可能你的不是11)

接下来,输入工程的名称

Project Name (required): yohunlTemp

再下来是输入package的名字,这里可以回车,采用默认值,这里的默认是是com.yourcompany.project Name

Package Name [com.yourcompany.flextemp]:

再下来是输入作者名,默认值是你的电脑的用户名

Author/Maintainer Name [yohunl]:

再下来,是输入tweak可以作用的对象的bundle identifier

[iphone/tweak] MobileSubstrate Bundle filter [com.apple.springboard]:

这里要说明一下了,这里的com.apple.springboard是iOS的桌面app,如果我们的tweak是想作用于所有的app呢?那么这里应该填 com.apple.UIKit,这一步填入的内容是对应于建立后的一个名字为工程名.plist的配置文件,这个文件的内容大概如以下这样

{ Filter = { Bundles = ( "com.apple.springboard" ); }; }

当然了,这里可以更进一步的控制,具体可以去网上搜索

接下来,是输入安装完成后,需要重启的应用

[iphone/tweak] List of applications to terminate upon installation (space-separated, '-' for none) [SpringBoard]:

建立后的工程目录如下

共有4个文件,其中 control文件中

Package: com.yourcompany.flextemp
Name: flexTemp
Depends: mobilesubstrate
Version: 0.0.1
Architecture: iphoneos-arm
Description: An awesome MobileSubstrate tweak!
Maintainer: yohunl
Author: yohunl
Section: Tweaks

是工程的一些常用的配置

flexTemp.plist文件,就是我们建立工程中输入的[iphone/tweak] MobileSubstrate Bundle filter

{ Filter = { Bundles = ( "com.apple.springboard" ); }; }

makefile文件

include $(THEOS)/makefiles/common.mk

TWEAK_NAME = flexTemp
flexTemp_FILES = Tweak.xm

include $(THEOS_MAKE_PATH)/tweak.mk

after-install::
	install.exec "killall -9 SpringBoard"

这里有$(THEOS),这个变量,这也是我们上面用export建立的,如果你没建立,新版的你要自己修改这里了

include $(THEOS)/makefiles/common.mk

这个都要添加的,因为很多关键的变量等,都在common.mk中,不包含这个,很多东西都用不了.例如编译过程中很多的变量的定义都在其中

THEOS_MAKE_PATH := $(THEOS)/makefiles
THEOS_BIN_PATH := $(THEOS)/bin
THEOS_LIBRARY_PATH := $(THEOS)/lib
THEOS_INCLUDE_PATH := $(THEOS)/include
THEOS_MODULE_PATH := $(THEOS)/mod

flexTemp_FILES = Tweak.xm 是我们要包含的需要被编译的文件,格式就是工程名_FILES = 要编译的文件名

Tweak.xm文件

%hook ClassName

// Hooking a class method
+ (id)sharedInstance {
	return %orig;
}

// Hooking an instance method with an argument.
- (void)messageName:(int)argument {
	%log; // Write a message about this call, including its class, name and arguments, to the system log.

	%orig; // Call through to the original function with its original arguments.
	%orig(nil); // Call through to the original function with a custom argument.

	// If you use %orig(), you MUST supply all arguments (except for self and _cmd, the automatically generated ones.)
}

// Hooking an instance method with no arguments.
- (id)noArguments {
	%log;
	id awesome = %orig;
	[awesome doSomethingElse];

	return awesome;
}

// Always make sure you clean up after yourself; Not doing so could have grave consequences!
%end
*/

这个文件中,就是我们tweak的核心代码,其中的%hook,%orig,%log等都是theos对cydia Substrate提供的函数的宏封装,cydia Substrate提供的方法的介绍可以参考Cydia_Substrate cydia Substrate提供了三方最重要的方法

 IMP MSHookMessage(Class class, SEL selector, IMP replacement, const char* prefix); > // prefix should be NULL.
 void MSHookMessageEx(Class class, SEL selector, IMP replacement, IMP *result);
 void MSHookFunction(void* function, void* replacement, void** p_original);

这三个都是用来进行hook操作的,也就是我们在非越狱开发中常说的swizzle! cydia Substrate还提供了MobileLoader：“钩子”需要在运行时被加载，靠的就是MobileLoader的功劳。MobileLoader会在适当的时机加载/Library/MobileSubstrate/DynamicLibraries/目录下的动态库（.dylib，这是tweak的最终产品）

MobileLoader能够在运行时候加载dylib的核心是利用 ** attribute((constructor))的方法会在main函数执行之前执行!!!!!!**

...
// The attribute forces this function to be called on load.
__attribute__((constructor))
static void initialize() {
  NSLog(@"MyExt: Loaded");
  MSHookFunction(CFShow, replaced_CFShow, &original_CFShow);
}

Tweak.xm的文件名后缀x代表这个文件支持Logos语法，如果只有一个x代表源文件支持Logos和C语法；如果是xm，说明源文件支持Logos和C/C++语法。其中的%hook,%orig,%log等都是Logos语法支持的内容,详细语法说明请参考http://iphonedevwiki.net/index.php/Logos (不要被这个语法吓着了,Logos作为Theos开发组件的一部分，通过一组特殊的预处理指令，可以让编写函数钩子（hook）代码变得非常简单和清晰,Logos是随着Theos发布的，你能够在用Theos创建的项目中直接使用Logos的语法,如果不是Theos创建的工程,则使用不了哦)

到此为止,我们的demo已经建立起来了

如何编译和安装呢? 命令 make package就是编译deb安装包的执行后,目录下会多出来几个文件和文件夹其中packages文件夹下保留的是每一次编译成功产生的deb安装包文件

还有个隐藏的目录 .theos 其内容如下其中的_文件夹下面 DEBIAN文件夹下面是deb安装到手机上后的控制文件信息,这个文件就是我们建立工程时候生成的那个control文件其他的目录和文件都是安装后对应到手机上的真实文件,在这里显示出来,是为了方便用开发者查看,安装后在手机系统中哪些目录生成了哪些文件

怎么安装deb包和卸载deb包?

上面我们生成了能够用于安装到手机上的deb安装包了,怎么安装到手机上呢?

大体上可以有两种方法

方法一:
图形方式,使用iTools等工具将这个deb包拷贝到手机中,利用iFile浏览到此文件,进行安装

方法二:
需要使用到openssh服务,确保你手机上已经安装了该服务(cydia中搜索安装)

要安装 OpenSSH 首先需要将设备越狱。越狱完成之后,就可以在 Cydia 中直接查找和安装 OpenSSH。安装完成之后就可以通过下面的步骤来将你的 Mac 连接到 iOS 设备。

首先得保证你的 iOS 设备和 Mac 在同一局域网的同一网段中。

打开终端，输入 ssh root@192.168.xxx.xxx

输入 iOS 设备密码，默认 alpine(强烈建议修改此默认密码,否则任何人都可以通过ssh连接到你手机上,然后获取你的信息)

等待连接，稍后，您就连接到您的iPhone、iPad上，可以执行 Unix 命令了。

还可以使用 Transmit 等软件来管理 iOS 设备的文件系统，非常方便。

在编译用的makefile文件最上面添加 THEOS_DEVICE_IP = 你的手机的IP地址

然后使用 make package install命令,可以一次性完成编译,打包,安装一条龙服务,这个过程中可能需要要你两次输入ssh的root密码((一次是签名打包,一次是安装)).

这样还是稍显繁琐,每一次修改后,编译运行,都得输入两此手机的root密码,如果你连这两次都懒得输入,也是有办法的

brew安装openssh(brew install openssl)和 ssh-copy-id(brew install ssh-copy-id) 执行命令

ssh-keygen -t rsa -b 2048

按提示输入存放keygen存放的目录(最好是自己输入存放的目录的文件,而不是采用默认的,以防万一覆盖了其它的ssh) 再执行命令

ssh-copy-id root@<iP Address of your device>

然后,就可以不用密码安装了! 节约了两次密码的输入(一次是签名打包,一次是安装)

说完了安装,那么我们怎么卸载一个安装的deb包呢? 方式一: cydia可删除它,安装的deb包都在cydia的已安装列表中有显示

方式二
如果手机上安装了dpkg(越狱手机上,一般都是安装了的,名字叫 Debian Package),那么将一个deb文件拷贝到手机里,就可以在手机中的终端(可以cydia安装MTerminal,MTerminal是一款越狱手机上的命令行终端环境)中执行dpkg -i com.daapps.FLEXInjected_0.0.1-1-7_iphoneos-arm.deb 来安装一个deb,(当然你也可以使用cydia来自动安装,或者pp助手等,也可以),安装完要重启springboard,使用命令 killall -HUP SpringBoard 卸载一个软件 dpkg -r com.daapps.FLEXInjected

**例如 dpkg -r com.yourcompany.testmywtweak **
(我们在theos环境打包出来的deb名字可能是com.yourcompany.testmywtweak_0.0.1-1_iphoneos-arm.deb等,但是最后在系统里的tweak的名字是com.yourcompany.testmywtweak )!

顺便提一句若是只是想修改其它的deb包的某个文件,该怎么弄呢? deb包的解读 ,其实它就是一个压缩文件而已…你可以使用rar等解压缩工具解压缩,但是这样会丢失原有的文件的权限信息! 一个 deb 安装包由两部分组成，一个是安装控制/识别信息，另外一个就是实际的程序文件。

需要修改现有的deb包，那么第一步就是解包。

假设deb的文件名是abc.deb，解包命令为：

dpkg-deb -x abc.deb tmp #将abc.deb的程序文件解包到tmp文件夹

dpkg-deb -e abc.deb tmp/DEBIAN #将abc.deb的安装控制/识别信息解包到DEBIAN文件夹

注：安装控制/识别信息必须在当前程序文件文件夹中的DEBIAN文件夹中，必须大写。

进入DEBIAN目录，可以看到有一个control文件，无后缀名，这个文件就是用来记录deb的安装信息。

另外，postinst，preinst，prerm，postrm，extrainst_这些脚本文件，不是必须存在的，当安装包需要使用到脚本的时候才会用到的。脚本在后面的章节会详细讲到的，这一节我们先不管。

接下来介绍的是打包命令：

假设将需要打包的文件放在tmp文件夹中，DEBIAN文件夹也要在放在这个文件夹中，然后输入命令：

chmod -R 0755 tmp/DEBIAN #首先设置权限，如果没有包含脚本可以不需要设置权限

dpkg-deb -b tmp 1.deb #打包成一个叫做1.deb的包

如此这般,就完成了修改某个已存在的deb包了

OK,目前为止,我们已经介绍完了基础知识

下面让我们用一个稍微复杂一些的例子来演示一下如何让Flex可以嵌入到所有的APP中

flex的动态嵌入

flex的简介

https://github.com/Flipboard/FLEX, FLEX是Flipboard开源的一款方便的应用内调试工具，开发者可在toolbar中查看和修改运行中的应用.
它提供了功能：

可以在层级中检测和调整视图，可查看每个对象上的属性和变量；
动态调整任何属性和变量；
动态调用实例和类方法；
通过扫描 heap访问任何活跃的对象；
在app的sandbox中查看文件系统；
探究应用中所有类和系统框架（公开的和私有的）；
快速访问有用的对象（比如[UIApplication sharedApplication]）、app委托以及关键窗口的根视图控制器等；
动态查看和调整 NSUserDefaults 值
显示所有的NSLog信息
显示所有的网络包等等

它是一个开源的框架集合,在我们自己的工程中,当然可以添加源码就可以用起来了,那么如果我们能够在其他的app中也嵌入它,那我们岂不是可以直接学习到其他app的UI布局等等,想想是不是就很激动呢? 官网截图

看到没,可以用来分析系统的电话界面

额.....但是.....官网并没有告诉我们怎么做到这点,说是留给我们自己一个小练习....呵呵,这个练习可不小呀..

动态嵌入flex

首先,我们应该有一个可以选取所有的app的列表,通过这个列表,我们可以决定哪个应用可以嵌入flex.可喜的是,这个工作已经有人替我们完成了

APPlist 是个辅助获取已安装程序列表的插件，利用PreferenceLoader在设置中增加一个App列表，并可以供用户设置

preferenceloader是手机越狱必备的软件，如果少了preferenceloader，你的iphone.ipad.越狱后很多插件都会无法使用。preferenceloader是很多插件的依赖，例如非常出名的Activator需要它才能正常工作 https://github.com/DHowett/preferenceloader

说的再简单一点,就是我们可以利用preferenceloader和applist,很方便的在系统给的设置那里提供一个可以选择app的列表

需要在设备的/Library/PreferenceLoader/Preferences下放置一个指定格式的plist文件和两个图标文件(图标文件是为了在系统的设置中显示)

怎么这个文件放在theos工程的哪里,最后安装后,才能在设备的/Library/PreferenceLoader/Preferences目录下呢? Theos已经帮我们想到这点了,在Theos建立的工程的根目录下建立一个 layout文件夹,这个文件夹就相当于设备的根目录了!在编译生成的deb包中,会自动放到对应的文件夹

在工程的目录下创建 layout文件夹这里的layout相当于iOS的文件系统的根目录

在其中放入一个控制系统设置项的plist文件FLEXInjected.plist

entry = {
  bundle = AppList;
  cell = PSLinkCell;
  icon = "/Library/PreferenceLoader/Preferences/FLEXInjected.png";
  isController = 1;
  label = FLEXInjected;
  ALSettingsPath = "/var/mobile/Library/Preferences/com.yourcompany.flexinjected.plist";
  ALSettingsKeyPrefix = "FLEXInjectedEnabled-";
  ALChangeNotification = "com.yourcompany.flexinjected.settingschanged";
  ALSettingsDefaultValue = 0;
  ALSectionDescriptors = (
  	
  	{
  	  title = "User Applications";
  	  predicate = "(isSystemApplication = FALSE)";
  	  "cell-class-name" = "ALSwitchCell";
  	  "icon-size" = 29;
  	  "suppress-hidden-apps" = 1;
  	  
  	},
  	{
  	  title = "System Applications";
  	  predicate = "(isSystemApplication = TRUE)";
  	  "cell-class-name" = "ALSwitchCell";
  	  "icon-size" = 29;
  	  "suppress-hidden-apps" = 1;
  	  "footer-title" = "© yohunl create for demo";
  	}
  );
};

下载Flex的工程,编译产生FLEX.framework这个动态库,将其放入

打开Tweak.xm文件添加如下代码

/* How to Hook with Logos
Hooks are written with syntax similar to that of an Objective-C @implementation.
You don't need to #include <substrate.h>, it will be done automatically, as will
the generation of a class list and an automatic constructor.
*/
#include <dlfcn.h>


@interface MyDKFLEXLoader : NSObject

@end

@implementation MyDKFLEXLoader

+ (instancetype)sharedInstance
{
    static dispatch_once_t onceToken;
    static MyDKFLEXLoader *_sharedInstance;
    dispatch_once(&onceToken, ^{
        _sharedInstance = [[self alloc] init];
    });

    return _sharedInstance;
}

- (void)show
{
	// [[FLEXManager sharedManager] showExplorer];

	Class FLEXManager = NSClassFromString(@"FLEXManager");
	id sharedManager = [FLEXManager performSelector:@selector(sharedManager)];
	[sharedManager performSelector:@selector(showExplorer)];
}

@end



%ctor {
    NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
        NSDictionary *prefs = [NSDictionary dictionaryWithContentsOfFile:@"/var/mobile/Library/Preferences/com.yourcompany.flexinjected.plist"] ;
        NSString *libraryPath = @"/Library/Application Support/FLEXLoader/FLEX.framework/FLEX";
        
        NSString *keyPath = [NSString stringWithFormat:@"FLEXInjectedEnabled-%@", [[NSBundle mainBundle] bundleIdentifier]];
        NSLog(@"SSFLEXLoader before loaded %@,keyPath = %@,prefs = %@", libraryPath,keyPath,prefs);
        if ([[prefs objectForKey:keyPath] boolValue]) {
            if ([[NSFileManager defaultManager] fileExistsAtPath:libraryPath]){
                void *haldel = dlopen([libraryPath UTF8String], RTLD_NOW);
            if (haldel == NULL) {
                char *error = dlerror();
                NSLog(@"dlopen error: %s", error);
            } else {
                NSLog(@"dlopen load framework success.");
                [[NSNotificationCenter defaultCenter] addObserver:[MyDKFLEXLoader sharedInstance] 
											selector:@selector(show) 
											name:UIApplicationDidBecomeActiveNotification 
											object:nil];
                    
                
            }

            NSLog(@"SSFLEXLoader loaded %@", libraryPath);
            } else {
                NSLog(@"SSFLEXLoader file not exists %@", libraryPath);
            }
        }
        else {
            NSLog(@"SSFLEXLoader not enabled %@", libraryPath);
        }
        
        NSLog(@"SSFLEXLoader after loaded %@", libraryPath);


    [pool drain];
}

简单的代码说明 NSDictionary *prefs = [NSDictionary dictionaryWithContentsOfFile:@"/var/mobile/Library/Preferences/com.yourcompany.flexinjected.plist"] .这个文件是我们在上面的plist中定义的用来存放用户选择的app列表的.通过读取它我们就可以知道用户选中了哪个app.

然后使用dlopen动态的打开framework,注入到响应的app进程中去

详细的代码我已经放到github上去了,地址是 https://github.com/yohunl/FlexInjected

编译的命令是 make 打包成deb安装包的命令是 make package 编译,打包,安装一条龙的命令是 make package isntall,当然了,你需要先修改Makefile文件中的THEOS_DEVICE_IP = 10.0.44.136 为你自己越狱设备的ip地址

稍后,你的越狱设备将会重启,然后,就可以在设置那里看到了