一、安装签名工具ldid

先确保安装了brew

$ /usr/bin/ruby -e "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/master/install)"

利用brew安装brewldid

$ brew install ldid

二、修改环境变量

编辑用户的配置文件

$ vim ~/.bash_profile

在.bash_profie文件后面加入以下两行

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

让.bash_profiel配置的环境变量立即生效（或者重新打开终端）

$ source ~/.bash_profile

三、下载theos

建议在$THEOS目录下载代码（也就是刚才配置的~/theos目录）

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

## 四、新建tweak项目

cd到一个存放项目代码的文件夹（例如桌面）

$ cd ~/Desktop
$ nic.pl

选择[11.] iphone/tweak
填写项目信息
- Project Name：项目名称
- Package Name：项目ID（随便填）
- Author/Maintainer Name：作者，直接敲回车按照默认就可以
- [iphone/tweak] MobileSubstrate Bundle filter：需要修改的APP的Bundle Identifier ，可以通过Cycript查看APPBundle Identifier
- [iphone/tweak] List of applications to terminate upon installation：直接敲回车按照默认就可以

 
Project Name (required): ting_tweak
Package Name [com.yourcompany.ting_tweak]: com.mj.ting
Author/Maintainer Name [MJ Lee]:
[iphone/tweak] MobileSubstrate Bundle filter [com.apple.springboard]:
com.gemd.iting
[iphone/tweak] List of applications to terminate upon installation (space-
separated, '-' for none) [SpringBoard]:
Instantiating iphone/tweak in ting_tweak/...
Done.

## 五、编辑Makefile

在前面加入环境变量，写清楚通过那个IP和端口号访问手机
- THEOS_DEVICE_IP
- THEOS_DEVICE_PORT

 
export THEOS_DEVICE_IP=127.0.0.1
export THEOS_DEVICE_PORT=10010
include $(THEOS)/makefiles/common.mk
TWEAK_NAME = ting_tweak
ting_tweak_FILES = Tweak.xm
include $(THEOS_MAKE_PATH)/tweak.mk
after-install::
    install.exec "killall -9 SpringBoard"

如果不希望每个项目的MakeFile都编写IP和端口号环境变量，也可以添加到用户配置文件中，编辑完毕后，执行source ~/.bash_profile，让配置立刻生效

 
$ vim ~/.bash_profile
export THEOS=~/theos
export PATH=$THEOS/bin:$PATH
export THEOS_DEVICE_IP=127.0.0.1
export THEOS_DEVICE_PORT=10010
$ source ~/.bash_profile

六、编写代码

打开Tweak.xm文件

 
%hook XMAdAnimationView
- (id)initWithImageUrl:(id)arg1 title:(id)arg2 iconType:(long long)arg3
jumpType:(long long)arg4
{
  return nil; 
}
%end
%hook XMSoundPatchPosterView
- (id)initWithFrame:(struct CGRect)arg1
{
  return nil; 
}
%end

七、编译-打包-安装

编译

make

打包成deb

make package

安装（默认会自动重启SpringBoard）

make install

八、可能遇到的问题

1 - make package的错误

$ make package
Can't locate IO/Compress/Lzma.pm in @INC (you may need to install the
IO::Compress::Lzma module) (@INC contains: /Library/Perl/5.18/darwin-
thread-multi-2level /Library/Perl/5.18 /Network/Library/Perl/5.18/darwin-
thread-multi-2level /Network/Library/Perl/5.18 /Library/Perl/Updates/5.18.2
/System/Library/Perl/5.18/darwin-thread-multi-2level
/System/Library/Perl/5.18 /System/Library/Perl/Extras/5.18/darwin-thread-
multi-2level /System/Library/Perl/Extras/5.18 .) at
/Users/mj/theos/bin/dm.pl line 12.
BEGIN failed--compilation aborted at /Users/wlq/theos/bin/dm.pl line 12.
make: *** [internal-package] Error 2

是因为打包压缩方式有问题，改成gzip压缩就可以了
修改dm.pl文件，用#注释掉下面两句

$ vim $THEOS/vendor/dm.pl/dm.pl
#use IO::Compress::Lzma;
#use IO::Compress::Xz;

修改deb.mk文件第6行的压缩方式为gzip

$ vim $THEOS/makefiles/package/deb.mk
_THEOS_PLATFORM_DPKG_DEB_COMPRESSION ?= gzip

2 - make错误

$ make
Error: You do not have an SDK in
/Library/Developer/CommandLineTools/Platforms/iPhoneOS.platform/Developer/S
DKs

是因为多个Xcode导致的路径问题（有可能安装了好几个Xcode），需要指定一下Xcode

 $ sudo xcode-select --switch
/Applications/Xcode.app/Contents/Developer/

 
$ make
> Making all for tweak xxx...
make[2]: Nothing to be done for `internal-library-compile'.

是因为之前已经编译过，有缓存导致的，clean一下即可

 $ make clean
$ make

写在最后

theos资料

- 目录结构：https://github.com/theos/theos/wiki/Structure

环境变量：http://iphonedevwiki.net/index.php/Theos
- Logos语法：http://iphonedevwiki.net/index.php/Logos
- %hook、%end ：hook一个类的开始和结束
- %log ：打印方法的调用详情
  - 可以通过Xcode -> Window -> Devices and Simulators查看日志
- HBDebugLog NSLog：和NSLog类似
- %new ：添加一个新的方法
- %c(className) ：生成一个Class对象，比如%c(NSObject) 类似于NSStringFromClass()、objc_getClass()
- %orig ：函数原来的代码逻辑
- %ctor：在加载动态库时调用
- %dtor：在程序退出时调用
- logify.pl 可以将一个头文件快速转换成已经包含打印信息的xm文件

  logify.pl xx.h > xx.xm

如果有额外的资源文件（例如图片），放在项目的layout文件中，对应着手机的根路径/

theos-tweak的实现过程

编写Tweak代码
$ make：编译 Tweak代码为动态库*.dylib
$ make package ：将dylib打包为deb文件
$ make install：将 deb文件传送到手机上，通过Cydia安装deb
插件将会安装在/Library/MobileSubstrate/DynamicLibraries文件夹中
- *.dylib：编译后的Tweak代码
- *.plist：存放着需要hook的APP ID
当打开APP时
- Cydia Substrate（Cydia已自动安装的插件）会让APP去加载对应的dylib
- 修改APP内存中的代码逻辑，去执行dylib中的函数代码
所以， theos的tweak并不会对APP原来的可执行文件进行修改，仅仅是修改了内存中的代码逻辑

问题：

未脱壳的APP是否支持tweak？
- 支持，因为tweak是在内存中实现的，并没有修改.app包中的可执行文件
tweak效果是否永久？

取决于 tweak中用到的APP代码是否被修改过

如果一旦更新APP，tweak 会不会失效？

取决于tweak中用到的APP代码是否被修改过

未越狱的手机是否支持tweak ？

不支持

能不能对Swift\C函数进行tweak？

可以，方式和 OC不一样
6.能不能对游戏项目进行tweak ？
可以，但是游戏大多数是通过C++\C#编写的，而且类名、函数名会进行混淆操作

logify.pl注意点

logify.pl生成的xm文件，有很多时候是编译不过的，需要进行一些处理
- 删掉__weak
- 删掉inout
  - 删掉协议，例如：@protocol XXTestDelegate
- 删掉 - (void).cxx_destruct { %log; %orig; }
- 删掉 HBLogDebug(@" = 0x%x", (unsigned int)r);
- 替换类名为void，比如XXPerson *替换为void *
  - 或者生命一下类信息@class XXPerson

Tweak开发过程

Theos