* 新建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)； |
### 1.%hook %end
> 指定需要hook的class,必须以％end结尾。
~~~
// hook SpringBoard类里面的_menuButtonDown函数,先打印一句话,再之子那个函数原始的操作
%hook SpringBorad
- (void)_menuButtonDown:(id)down
{
NSLog(@"111111");
%orig; // 调用原始的_menuButtonDown函数
}
%end
~~~
### 2.%group
> 该指令用于将%hook分组，便于代码管理及按条件初始化分组，必须以%end结尾。
> 一个％group可以包含多个%hook,所有不属于某个自定义group的％hook会被隐式归类到％group\_ungrouped中。
~~~
%group iOS8
%hook IOS8_SPECIFIC_CLASS
// your code here
%end // end hook
%end // end group ios8
%group iOS9
%hook IOS9_SPECIFIC_CLASS
// your code here
%end // end hook
%end // end group ios9
%ctor {
if (kCFCoreFoundationVersionNumber > 1200) {
%init(iOS9);
} else {
%init(iOS8);
}
}
~~~
### 3.%new
> 在%hook内部使用，给一个现有class添加新函数，功能与class\_addMethod相同.
> 注：
> Objective-C的category与class\_addMethod的区别：
> 前者是静态的而后者是动态的。使用%new添加,而不需要向.h文件中添加函数声明,如果使用category,可能与遇到这样那样的错误.
~~~
%hook SpringBoard
%new
- (void)addNewMethod
{
NSLog(@"动态添加一个方法到SpringBoard");
}
%end
~~~
### 4.%ctor
> 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);
}
~~~
### 5.%dtor
> Generate an anonymous deconstructor (of default priority).
~~~
%dtor { … }
~~~
### 6.%log
> 该指令在%hook内部使用，将函数的类名、参数等信息写入syslog,可以％log(\[(),…..\])的格式追加其他打印信息。
~~~
%hook SpringBorad
- (void)_menuButtonDown:(id)down
{
%log((NSString *)@"iosre",(NSString *)@"Debug");
%orig; // 调用原始的_menuButtonDown方法
}
%end
~~~
### 6.%orig
> 该指令在%hook内部使用，执行被hook的函数的原始代码；也可以用％orig更改原始函数的参数。
~~~
%hook SpringBorad
- (void)setCustomSubtitleText:(id)arg1 withColor: (id)arg2
{
%orig(@"change arg2",arg2);// 将arg2的参数修 改为"change arg2"
}
%end
~~~
### 7.%init
> 该指令用于初始化某个％group，必须在%hook或％ctor内调用；如果带参数，则初始化指定的group，如果不带参数，则初始化\_ungrouped.
> **注： 切记，只有调用了％init,对应的%group才能起作用！**
### 8.%c
> 该指令的作用等同于objc\_getClass或NSClassFromString,即动态获取一个类的定义，在%hook或％ctor内使用 。
