Theos的使用

Theos

Theos简介

Theos是一个越狱开发工具包，由iOS越狱界知名人士 Dustin Howett 开发并分享到 GitHub 上。Theos 与其他越狱开发工具相比，最大特点就是简单：下载安装简单、Logos语法简单、编译发布简单，可以让使用者将精力都放在开发工作上去。

安装 Theos

1、安装Xcode与Command Line Tools

一般来说，iOS开发者都会安装Xcode，其中附带 了Command Line Tools。如果还没有安装Xcode，请到 Apple Developer 免费下载。如果安装了多个Xcode， 需要使用xcode-select命令指定一个活动Xcode，即Theos默认使用的Xcode。假设安装了3个Xcode，并将它们分别命名为Xcode1.app、Xcode2.app和 Xcode3.app，若要指定Xcode3为活动Xcode，则运行如下命令:

sudo xcode-select -s /Applications/Xcode3.app/Contents/Developer

2、签名工具ldid安装

brew install ldi

3、修改环境变量

Theos官方建议我们将Theos克隆到_{/theos目录下，而且}/theos路径之后需要多次使用，所以将~/theos配置为环境变量

• 首先，进入cd ~进入根目录，在根目录下有访问.bash_profile文件

vim ~/.bash_profile

• 在.bash_profile文件最后加入下面两行

export THEOS=~/theos
export PATH=$THEOS/bin:$PATH

• 配置完成之后，在终端执行source命令，使.bash_profile文件的配置立即生效

source ~/bash_profile

• 此时我们通过$PATH来打印出PATH信息，就可以看到THEOS目录已经添加到了PATH中

4、下载Theos

通过以下命令将Theos下载到上面配置的$THEOS目录中

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

--recursive表示递归下载，因为Theos会依赖其它库，使用此命令可以递归的将所有依赖的库都下载下来

tweak项目

1、创建tweak项目

1）cd到存放项目的目录，执行nic.pl指令，如下：

cd ~/Desktop/Theos
nic.pl

2）选择“17”，即创建一个tweak工程，命令如下：

Choose a Template (required): 17

3）输入tweak的工程名称，命令如下：

Project Name (required): iOSProject

4）输入deb包的名字（类似于bundle identifier），命令如下：

Package Name [com.yourcompany.iosproject]: com.ios.iosproject

5）输入tweak作者的名字，命令如下：

Author/Maintainer Name [作者的名字]: 作者的名字

6）输入“MobileSubstrate Bundle filter”，也就是 tweak作用对象的bundle identifier，命令如下:

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

7）输入tweak安装完成后需要重启的应用，以进 程名表示，如下:

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

简单的7步完成之后，一个名为iosproject的文件夹就在当前目录生成了，该文件夹里就是刚创建的 tweak 工程。

2、定制工程文件

进入工程中可以看到生成的工程目录，如下：

tweak工程目录

（1）MakeFile

Makefile文件指定工程用到的文件、框架、库等 信息，将整个过程自动化。iOSREProject的Makefile内 容如下:

TARGET := iphone:clang:latest:7.0
INSTALL_TARGET_PROCESSES = SpringBoard


include $(THEOS)/makefiles/common.mk

TWEAK_NAME = iOSProject

iOSProject_FILES = Tweak.x
iOSProject_CFLAGS = -fobjc-arc

include $(THEOS_MAKE_PATH)/tweak.mk

下面来逐行解读：

• 指定SDK版本

TARGET := iphone:clang:latest:7.0

• 目标安装的项目

INSTALL_TARGET_PROCESSES = SpringBoard

• 固定写法，不要更改

include $(THEOS)/makefiles/common.mk

• tweak的名字，即用Theos创建工程时指定的“Project Name”，跟control文件中“Name”字段对应，不要更改。

TWEAK_NAME = iOSProject

• tweak包含的源文件(不包括头文件)

iOSProject_FILES = Tweak.x

多个文件间以空格分隔，如:

iOSREProject_FILES = Tweak.xm Hook.xm New.x ObjC.m ObjC++.mm

• 采用ARC内存管理

iOSProject_CFLAGS = -fobjc-arc

• 根据不同的Theos工程类型，通过include命令指 定不同的.mk文件;在逆向工程初级段，我们开发的一般是Application、Tweak和Tool三种类型的程序， 它们对应的.mk文件分别是application.mk、tweak.mk 和tool.mk，可以按需更改。

include $(THEOS_MAKE_PATH)/tweak.mk

添加其他信息：

• 指定处理器架构

ARCHS = armv7 arm64

• 导入framework

iOSProject_FRAMEWORKS = framework name

例如：

iOSREProject_FRAMEWORKS = UIKit CoreTelephony CoreAudio

• 链接Mach-O对象

iOSProject_LDFLAGS = -lx

例如：

iOSProject_LDFLAGS = -lz –lsqlite3.0 –dylib1.o

（2）control

control文件记录了deb包管理系统所需的基本信 息，会被打包进deb包里。iOSProject里control文件 的内容如下:

Package: com.ios.iosproject
Name: iOSProject
Version: 0.0.1
Architecture: iphoneos-arm
Description: An awesome MobileSubstrate tweak!
Maintainer: shh
Author: shh
Section: Tweaks
Depends: mobilesubstrate (>= 0.9.5000)

• Package字段用于描述这个deb包的名字，采用的命名方式同bundle identifier类似，均为反向DNS格式，可以按需更改;
• Name字段用于描述这个工程的名字，可以按需更改;
• Version字段用于描述这个deb包的版本号，可 以按需更改;
• Architecture字段用于描述deb包安装的目标设 备架构，不要更改;
• Description字段是deb包的简单介绍，可以按需更改;
• Maintainter字段用于描述deb包的维护人，例如BigBoss源中所有deb包的维护人均为BigBoss，而非软件作者，可以按需更改;
• Author字段用于描述tweak的作者(注意与Maintainer的区别)，可以按需更改;
• Section字段用于描述deb包所属的程序类别，不要更改。
• Depends字段用于描述这个deb包的“依赖”。“依赖”指的是这个程序运行的基本条件，可以填写固件版本或其他程序，如果当前iOS不满足“依赖”中定义的条件，则此tweak无法正常运 行。如

Depends: mobilesubstrate, firmware (>= 8.0)

表示当前iOS版本必须在8.0以上，且必须安装mobilesubstrate，才能正常运行这个tweak，可以按需更改。

（3）iOSProject.plist

这个plist文件的作用和App中的Info.plist类似，它记录了一些配置信息，描述了tweak的作用范围。我们可以用plutil，也可以用Xcode来编辑它。

iOSProject.plist 的最外层是一个dictionary，只有一个名为“Filter”的键，

Filter下是一系列array，可以分为三类：

• Bundles，指定多干bundle为tweak的作用对象。按如下图的配置，tweak的作用对象是一个bundle，即 Springboard、AddressBook。

Bundles配置

• Classes，指定若干class为tweak的作用对象。按如下图的配置，tweak的作用对象是三个 class，即NSString、SBAwayController和 SBIconModel。

Classes配置

• Executables，指定若干可执行文件为tweak的作用对象。如下图所示，tweak的作用对象是三个可执行文件，即callservicesd、imagent和mediaserverd。

Excutables配置

这三类array可以混合使用，如下图所示：

混合三类array

注意：
当Filter下有不同类的array时，需要添加一个“Model: Any”键值对。当Filter下的array只有一类时，不需要添加“Model: Any”

（4）Tweak.xm

用Theos创建tweak工程，默认生成的源文件是 Tweak.xm。xm中的x代表这个文件支持Logos语法，如果后缀名是单独一个x，说明源文件支持Logos和C语法;如果后缀名是xm，说明源文件支持Logos和C/C++语法，与m和mm的区别类似。 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使用的Logos语法简介，可以点击Logos官网查看完整的语法介绍。

%hook、%end ：#表示hook一个类的开始和结束

%log ：#打印方法调用详情，可以通过Xcode -> Window -> Devices and Simulators

HBDebugLog : #和NSLog类似

%new ：#添加一个新的方法

%c(className) : #生成一个Class对象，比如%c(NSObject),类似于NSStringFromClass()、objc_getClass()

%orig ：#调用原先的方法逻辑

%ctor ：#加载动态库的时候调用

%dtor ：#在程序退出时调用

3、编译/打包/安装

（1）编译

Theos 采用“make”命令来编译Theos工程。在Theos工程目录下运行make命令，如下：

编译

从输出的信息看，Theos完成了预处理、编译、 签名等一系列动作。此时会发现在当前目录下多了一个新的“.theos”文件夹，如下：

make后产物

里面有一个.dylib文件，他就是tweak的核心

（2）打包

打包使用的“make package”命令来自于Theos本身，其实就是先执行“make”命令，然后再执行“dpkg- deb”命令，如下:

make install 命令

上面生成了一个com.ios.iosproject_0.0.1-1+debug_iphoneos-arm.deb的文件，这就是最终发布的安装包。

“make package”命令还有一个很重要的功能。在执行完“make package”之后，除了“obj”文件夹外，你 会发现tweak工程目录下还生成了一个“_”文件夹，如下:

文件结构

其中“DEBIAN”里只有tweak工程里的control文件，Theos在编译过程中向control文件里稍稍增加了 几个字段而已，如下:

Package: com.ios.iosproject
Name: iOSProject
Architecture: iphoneos-arm
Description: An awesome MobileSubstrate tweak!
Maintainer: shh
Author: shh
Section: Tweaks
Depends: mobilesubstrate (>= 0.9.5000)
Version: 0.0.1-1+debug
Installed-Size: 104

“Library”的目录结构如上图所示；

对比生成的deb包的内容如下：

以及在Cydia中的iOSProject文件系统，如下：

可以看到，三者是完全相同的。到这里，你可能也猜到了，这个deb包其实就是由“DEBIAN”提供debian信息，“Library”提供实际文件的简单组合。事实上，还可以在工程目录下创建一个名为“layout”的文件夹，然后把工程打包成deb并安装到iOS中，此时“layout”中的所有文件会被解包到iOS文件系统的相同位置(这里的“layout”相当于iOS中的根目录“/”)， 这极大扩充了deb包的作用范围。

（3）安装

此处介绍两种最具代表性的:图形界 面安装法和命令行安装法。

• 图形界面安装

这个方法确实简单：通过iFunBox等软件把deb拖到iOS里去，然后用iFile安装它，最后重启iOS。虽然全过程都由图形界面操作，但人机交互太多，又要动电脑又要滑手机，一来二去非常繁琐，并不适用于 tweak开发。

• 命令行安装法

这个方法要用到简单的ssh命令，故而要求越狱的iOS安装了OpenSSH。下面具体介绍安装法。

首先，需要在Makefile的最上一行加上本机IP地址，如下:

THEOS_DEVICE_IP = iOSIP 
ARCHS = armv7 arm64
TARGET = iphone:latest:8.0

然后调用“make package install”命令完成编译打包安装一条龙服务，如下:

Theos开发tweak示例

1、用Theos新建tweak工程“iOSREGreetings”

2、编辑Tweak.x

%hook SpringBoard
- (void)applicationDidFinishLaunching:(id)application {
    %orig;
    UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Hello World!" message:nil delegate:self cancelButtonTitle:@"Ok" otherButtonTitles:nil];
    [alert show];
}
%end

3、编辑Makefile及control

编辑后的Makefile内容如下:

THEOS_DEVICE_IP = iOSIP
TARGET := iphone:clang:latest:7.0
INSTALL_TARGET_PROCESSES = SpringBoard
THEOS_DEVICE_IP = iOSIP
ARCHS = armv7 arm64
include $(THEOS)/makefiles/common.mk

TWEAK_NAME = iOSREGreetings

iOSREGreetings_FILES = Tweak.x
iOSREGreetings_CFLAGS = -fobjc-arc
IOSREGreetings_FRMEWORKDS = UIKit
include $(THEOS_MAKE_PATH)/tweak.mk
after-install::
    install.exec "killall -9 SpringBoard"
SUBPROJECTS += iosretargetapp
include $(THEOS_MAKE_PATH)/aggregate.mk

编辑后的control内容如下:

Package: com.iosre.iosregreetings
Name: iOSREGreetings
Version: 0.0.1
Architecture: iphoneos-arm
Description: An awesome MobileSubstrate tweak!
Maintainer: shh
Author: shh
Section: Tweaks
Depends: mobilesubstrate (>= 0.9.5000)

以上代码非常简单，当SpringBoard的applicationDidFinishLaunching:函数得到调用时，代表SpringBoard的启动过程已经结束。钩住(hook)这个函数，调用%orig完成它的原始操作，然后弹出一个自定义的UIAlertView；这样一来，每次重启SpringBoard都会弹出一个对话框。你看懂了吗?

准备就绪，在Terminal中敲入“make package install”，即可安装到手机中。