前言
学习逆向有一段时间了，想着写个iOS Jailbreak Tweak练练手，平时比较喜欢看视频，看到比较搞笑的视频想保存下载发给好友，无奈无法下载，于是有了这个VideoDownloaderCN插件。
声明 ： 插件用于技术研究
一、分析
最近分析几个App上的视频播放，基本上就是一个View上有个播放组件，而这个View或者它的若干个nextResponder持有这个视频的url，于是有这样的思路：
- 动态分析定位得到视频的URL
- 在View的构造方法内添加一个手势弹出下载
- 手势对应视频下载的方法实现，最后移动到系统相册
分析方法用到:Cycript动态调试、Reveal界面分析、class-dump头文件
分析过程不在这里描述，主要mark一下Tweak的构建工程.
二、Theos
安装配置
网络上有非常多的教程，但是我推荐查看官方的.Theos installation
创建工程
nic.pl
目录介绍
Makefile
Tweak.xm
此处我使用了多个xm文件来区分每个App的注入代码，具体查看github
*.plist
编译Tweak
做好了基础配置以及编写好xm之后，就可以通过make命令编译，我遇到了一个错误，如下：
修改Makefile再次编译
make package生成deb
安装Tweak
make install命令安装到设备,安装前需要配置一些必要参数,将以下两行参数配置到Makefile是一种方法，意思是通过本地USB方式，端口2222安装到手机，我的做法是配置好写在.bash_profile或.zshrc内，这样不用每次在Makefile内编写（重要提示：出现Error请详细检查theos配置，手机IP、端口是否映射，ssh是否正常登陆）
export THEOS_DEVICE_IP=localhost
export THEOS_DEVICE_PORT=2222
当然安装deb方法不止一种，当你打包出deb后
- 可以使用
CyDown这个插件开一个ftp，然后PC传deb过去，接着手机端打开cydia找到那个deb安装。 - 可以使用
scp命令传到手机端，接着手机终端dpkg -i安装,具体做法请自行搜索详细教程。
至此，一个Tweak在iOS越狱设备上
三、插件设置项Preference Bundle
一个tweak可能要设置一些选项，就像App Store上的App一样，在设置应用里面可以设置，在theos里，可以通过创建Preference Bundle来为插件提供设置界面,有点类似于Xcode里的Setting Bundle,Preference Bundle安装到手机后会在/Library/PreferenceBundles/目录生成一个对应的bundle,此bundle会基于PreferenceLoader注入到设置应用(Setting.app)，而PreferenceLoader是由Dustin Howett开发的基于Mobile Substrate的工具，主要为插件在系统设置界面添加一个设置入口。
为插件创建Preference Bundle
一般的做法为：在原插件目录使用theos创建
创建preference bundle后新生成目录下的文件介绍如下:
| 文件 | 作用/含义 |
|---|---|
| entry.plist | 为插件在系统设置应用界面添加一个入口，一般修改icon与label即可 |
| XXXRootListController | XXXRootListController必须继承PSListController或者PSViewController，且必须实现- (id)specifiers方法，因为PSListController依赖_specifiers来获得metadata和group |
| Makefile | preference bundle的Makefile，一般不用过多修改与操作，编译Tweak的Makefile会跟随着一起编译 |
| Resources文件夹下的文件如下 | |
| Info.plist | 主要记录这个preference bundle的配置信息，一般不用修改 |
| Root.plist | 重点编写的文件，主要配置插件界面的UI元素，XML格式，好像还有一种类似JSON格式的 |
关于Preference Bundle的更多配置方法，参考：
PreferenceBundles
Preferences specifier plist
让 iPhone 上显示学期周数（五） — — 增加用户配置界面
制作 Preference Bundle 插件菜单
Part 6: Preferences, Preferences, a little Tweak, and Heaps of More Preferences
Theos - Preference Bundle Tutorial iOS 8 - iPhone, iPad
网上关于Preference Bundle的用法中文介绍很少，我是结合iPhonewiki、视频以及一些开源插件的Preference Bundle配置学习，真的是花了不少时间~~~,具体的配置我不放上来了，可以去我的github看一下，我尽量注释说明了配置的含义。
推荐一个开源插件Repo：Open-Source-Tweaks
四、遇到的坑
theos创建preference bundle后编译不通过,原因是theos找不到对应的库
解决方法:
手动下载theos需要的sdks，网上已经有人Patch好了，将从theos sdks下载的sdks放到theos的/sdks目录下。
再次编译还是错误,原因是目前Xcode10.1已经使用iOS12.1的sdks，搜了一番没有找到theos用的，于是我将插件支持版本调低一点,可以编译通过,Tweak的Makefile添加:
export TARGET = iphone:clang:11.2:8.0
最低版本8.0，最高版本11.2，反正iOS12的越狱大神还没release,why so serious?
参考:Xcode10.x theos doesn't work
五、总结
本次主要学习theos开发iPhone tweak的操作以及为tweak增加设置入口，因为自己的插件需要对多个App注入，就想增加开关来控制插件是否生效，顺便学习一下Preference Bundle.
整个开发过程回顾一下大概是:
-
Cycript调试拿到视频URL的成员变量 - 查看头文件查看属性与方法，
hook初始化方法添加触发手势 - 编写
Tweak调试测试，适配多个视频场景 - 编写
Tweak的Preference Bundle控制插件开关（花了不少时间） - 整理
六、参考
Tweak开发：给调音量增加震动反馈