Logos语法
http://iphonedevwiki.net/index.php/Logos
新建Monkey工程时,MonkeyDev已经将libsubstrate.dylib库和RevealServer.framework库注入进去了,有了libsubstrate.dylib库就能写Logos语法
Logos语法:
Logos语法 | 功能解释 | 事例 |
---|---|---|
%hook | 需要hook哪个类 | %hook Classname |
%end | 代码块结束标记 | |
%group | 分组 | %group Groupname |
%new | 添加新方法 | %new(signature) |
%ctor | 构造函数 | %ctor { … } |
%dtor | 析构函数 | %dtor { … } |
%log | 输出打印 | %log; %log([( |
%orig | 保持原有方法 | %orig;%orig(arg1, …); |
%c | %c([+/-]Class); |
指定需要hook的class,必须以%end结尾。
// hook SpringBoard类里面的_menuButtonDown函数,先打印一句话,再之子那个函数原始的操作%hook SpringBorad- (void)_menuButtonDown:(id)down{ NSLog(@"111111"); %orig; // 调用原始的_menuButtonDown函数}%end
该指令用于将%hook分组,便于代码管理及按条件初始化分组,必须以%end结尾。
一个%group可以包含多个%hook,所有不属于某个自定义group的%hook会被隐式归类到%group_ungrouped中。
/*在%group iOS7Hook中钩住iOS7Class的iOS7Method,在%group iOS8Class中钩住iOS8Method函数,然后在%group _ungroup中钩住SpringBoard类的powerDown函数.*/%group iOS7Hook%hook iOS7Class- (id)ios7Method{ id result = %orig; NSLog(@"这个方法只有iOS7适用"); return result;}%end%end // iOS7Method%group iOS8Hook%hook iOS8Class- (id)ios8Method{ id result = %orig; NSLog(@"这个方法只有iOS7适用"); return result;}%end%end // iOS8Method%hook SpringBoard- (void)powerDown{ %orig;}%end
在%hook内部使用,给一个现有class添加新函数,功能与class_addMethod相同.
注:
Objective-C的category与class_addMethod的区别:
前者是静态的而后者是动态的。使用%new添加,而不需要向.h文件中添加函数声明,如果使用category,可能与遇到这样那样的错误.
%hook SpringBoard%new- (void)addNewMethod{ NSLog(@"动态添加一个方法到SpringBoard");}%end
tweak的constructor,完成初始化工作;如果不显示定义,Theos会自动生成一个%ctor,并在其中调用%init(_ungrouped)。%ctor一般可以用来初始化%group,以及进行MSHookFunction等操作,如下:
#ifndef KCFCoreFoundationVersionNumber_iOS_8_0#define KCFCoreFoundationVersionNumber_iOS_8_0 1140.10#endif%ctor{ %init; if (KCFCoreFoundationVersionNumber >= KCFCoreFoundationVersionNumber_iOS_7_0 && KCFCoreFoundationVersionNumber > KCFCoreFoundationVersionNumber_iOS_8_0) %init(iOS7Hook); if (KCFCoreFoundationVersionNumber >= KCFCoreFoundationVersionNumber_iOS_8_0) %init(iOS8Hook);MSHookFunction((void *)&AudioServicesPlaySystemSound,(void *)&replaced_AudioServerPlaySystemSound,(void **)&orginal_AudioServicesPlaySystemSound);}
Generate an anonymous deconstructor (of default priority).
%dtor { … }
该指令在%hook内部使用,将函数的类名、参数等信息写入syslog,可以%log([(),…..])的格式追加其他打印信息。
%hook SpringBorad- (void)_menuButtonDown:(id)down{ %log((NSString *)@"iosre",(NSString *)@"Debug"); %orig; // 调用原始的_menuButtonDown方法}%end
该指令在%hook内部使用,执行被hook的函数的原始代码;也可以用%orig更改原始函数的参数。
%hook SpringBorad- (void)setCustomSubtitleText:(id)arg1 withColor: (id)arg2{ %orig(@"change arg2",arg2);// 将arg2的参数修 改为"change arg2"}%end
该指令用于初始化某个%group,必须在%hook或%ctor内调用;如果带参数,则初始化指定的group,如果不带参数,则初始化_ungrouped.
注: 切记,只有调用了%init,对应的%group才能起作用!
该指令的作用等同于objc_getClass或NSClassFromString,即动态获取一个类的定义,在%hook或%ctor内使用 。