// Tweak.xm
1.預處理指令
%hook
指定需要hook的class髓棋，必須以%end結尾
%hook SpringBoard
- (void)_menuButtonDown:(id)down
{
NSLog(@"你好");
%orig;//call the original _menuButtonDown;
}
%end
這段代碼的意思是勾住(hook) SpringBoard 類里的_menuButtonDown: 函數(shù)，先將一句話寫入 syslog , 再執(zhí)行函數(shù)的原有操作抒痒。
%log
該指令在%hook內(nèi)部使用恰起，將函數(shù)的類名修械、參數(shù)等信息寫入syslog。
%hoot SpringBoard
- (void)_menubuttonDown:(id)down
{
%log((NSString *)@"iOSRE",(NSString *)@"Debug");
%orig;//call the original _menuButtonDown;
}
%end
%orig
該指令在%hook內(nèi)部使用检盼，執(zhí)行被勾住(hook)的函數(shù)的原始代碼肯污。例如：
%hook SpringBoard
- (void)_menuButtonDown:(id)down
{
NSLog(@"你好");
%orig; //
}
%end
如果去掉 *%orig * 那么原始函數(shù)不會執(zhí)行。
hook SpringBoard
- (void)_menuButtonDown:(id)down
{
NSLog(@"你好");
}
%end
還可以利用 %orig 更改原始行數(shù)的參數(shù)吨枉。
%hook SBLockScreenDateViewController
- (void)setCustomSubtitleText:(id)arg1 withColor:(id)arg2
{
%orig(@"Re",arg2);
}
%end
這個方法會改變鎖屏界面的日期顯示.
%group
該指令用于將* %hook 分組蹦渣，便于代碼管理及按條件初始化分組，必須以 %end 結尾貌亭；一個 %group 可以包含多個 %hook , 所有不屬于某個自定義 group 的 %hook 會被隱式歸類到 %group_ungroupes *中柬唯。用法如下：
%group iOS7Hook
%hook iOS7Class
- (id)iOS7Method {
id result = %orig;
NSLog(@"This class & method only exist in iOS 7.");
return result;
} %end
%end // iOS7Hook
%group iOS8Hook
%hook iOS8Class
- (id)iOS8Method {
id result = %orig;
NSLog(@"This class & method only exist in iOS 8."); return result;
}
%end
%end // iOS8Hook
%init
該指令用于初始化某個 * %group ,必須在 %hook 或 %ctor *內(nèi)調(diào)用;如果帶參數(shù),則初始化指定的 group,如果不帶參數(shù),則初始化 _ungrouped ,如下:
#ifndef kCFCoreFoundationVersionNumber_iOS_8_0
#define kCFCoreFoundationVersionNumber_iOS_8_0 1140.10 #endif
%hook SpringBoard
- (void)applicationDidFinishLaunching:(id)application {
%orig;
%init; // Equals to %init(_ungrouped)
if (kCFCoreFoundationVersionNumber >= kCFCoreFoundationVersionNumber_iOS_7_0 && kCFCoreFoundationVersionNumber < kCFCoreFoundationVersionNumber_iOS_8_0)
%init(iOS7Hook);
if (kCFCoreFoundationVersionNumber >= kCFCoreFoundationVersionNumber_iOS_8_0)
%init(iOS8Hook);
}
%end
只有調(diào)用了 %init,對應的 %group 才能起作用,切 切 !
%ctor
tweak 的* constructor *完成初始化工作；如果不顯式定義,Theos會自動生成一個 *%ctor ,并在其中調(diào)用 %init(_ungrouped) *圃庭。因此,
%hook SpringBoard
- (void)reboot {
NSLog(@"If rebooting doesn't work then I'm screwed.");
%orig;
}
%end
可以成功生效,因為 Theos 隱式定義了如下內(nèi)容:
%ctor
{
%init(_ungrouped);
}
而
%hook SpringBoard
- (void)reboot{
NSLog(@"If rebooting doesn't work then I'm screwed.");
%orig;
}
%end
%ctor
{
// Need to call %init explicitly!
}
里的 %hook 無法生效权逗，因為這里顯示定義了 %ctor 美尸，卻沒有調(diào)用 %init ，%group(_ungrouped) 不起作用斟薇。%ctor 一般可以用來初始化 %group ,以及進行 MSHookFunction 等操作。
注意, %ctor 不需要以 %end 結尾 恕酸。
%new
在 %hook 內(nèi)部使用,給一個現(xiàn)有 class 加新函數(shù),功能與 class_addMethod 相同堪滨。它的用法如下:
%hook SpringBoard
%new
- (void)namespaceNewMethod {
NSLog(@"We've added a new method to SpringBoard.");
}
%end
%c
該指令的作用等同于 objc_getClass 或 NSClassFromString,即動態(tài)獲 一個類的定義,在 %hook 或 %ctor 內(nèi)使用。
