Theos越狱插件开发——VideoDownloaderCN

前言

学习逆向有一段时间了,想着写个iOS Jailbreak Tweak练练手,平时比较喜欢看视频,看到比较搞笑的视频想保存下载发给好友,无奈无法下载,于是有了这个VideoDownloaderCN插件。

声明 : 插件用于技术研究

插件

一、分析

最近分析几个App上的视频播放,基本上就是一个View上有个播放组件,而这个View或者它的若干个nextResponder持有这个视频的url,于是有这样的思路:

  • 动态分析定位得到视频的URL
  • 在View的构造方法内添加一个手势弹出下载
  • 手势对应视频下载的方法实现,最后移动到系统相册

分析方法用到:Cycript动态调试Reveal界面分析class-dump头文件

分析过程不在这里描述,主要mark一下Tweak的构建工程.

二、Theos

安装配置

网络上有非常多的教程,但是我推荐查看官方的.Theos installation

创建工程

nic.pl

创建工程

目录介绍

目录介绍

Makefile

Makefile

Tweak.xm

Tweak.xm

此处我使用了多个xm文件来区分每个App的注入代码,具体查看github

*.plist

*.plist

编译Tweak

做好了基础配置以及编写好xm之后,就可以通过make命令编译,我遇到了一个错误,如下:

make

修改Makefile再次编译

Makefile
make again

make package生成deb

mack package

安装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

  1. 可以使用CyDown这个插件开一个ftp,然后PC传deb过去,接着手机端打开cydia找到那个deb安装。
  2. 可以使用scp命令传到手机端,接着手机终端dpkg -i安装,具体做法请自行搜索详细教程。

至此,一个Tweak在iOS越狱设备上

tweak

三、插件设置项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创建

make preference bundle
new in Makefile

创建preference bundle后新生成目录下的文件介绍如下:

文件 作用/含义
entry.plist 为插件在系统设置应用界面添加一个入口,一般修改iconlabel即可
XXXRootListController XXXRootListController必须继承PSListController或者PSViewController,且必须实现- (id)specifiers方法,因为PSListController依赖_specifiers来获得metadata和group
Makefile preference bundleMakefile,一般不用过多修改与操作,编译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找不到对应的库

error when make

解决方法:
手动下载theos需要的sdks,网上已经有人Patch好了,将从theos sdks下载的sdks放到theos/sdks目录下。

再次编译还是错误,原因是目前Xcode10.1已经使用iOS12.1的sdks,搜了一番没有找到theos用的,于是我将插件支持版本调低一点,可以编译通过,TweakMakefile添加:

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.
整个开发过程回顾一下大概是:

  1. Cycript调试拿到视频URL的成员变量
  2. 查看头文件查看属性与方法,hook初始化方法添加触发手势
  3. 编写Tweak调试测试,适配多个视频场景
  4. 编写TweakPreference Bundle控制插件开关(花了不少时间)
  5. 整理

六、参考

Tweak开发:给调音量增加震动反馈