一、概述
Logos语法其实是CydiaSubstruct框架提供的一组宏定义。便于开发者使用宏进行HOOK操作。语法简单，功能强大且稳定，它是跨平台的。[logos] (http://iphonedevwiki.net/index.php/Logos)
二、logos语法
logos语法分为3类。
2.1、Block level
这一类型的指令会开辟一个代码块，以%end结束。
%group
用来将代码分组。开发中hook代码会很多，这样方便管理Logos代码。所有的group都必须初始化，否则编译报错。
#import <UIKit/UIKit.h>
%group group1
%hook RichTextView
- (_Bool)setPrefixContent:(id)arg1 TargetContent:(NSString *)arg2 TargetParserString:(id)arg3 SuffixContent:(id)arg4 {
//hook后要处理的方式1
return %orig;
}
%end
%end
%group group2
%hook RichTextView
- (_Bool)setPrefixContent:(id)arg1 TargetContent:(NSString *)arg2 TargetParserString:(id)arg3 SuffixContent:(id)arg4 {
//hook后要处理的方式2
return %orig;
}
%end
%end
%group group3
%hook RichTextView
- (_Bool)setPrefixContent:(id)arg1 TargetContent:(NSString *)arg2 TargetParserString:(id)arg3 SuffixContent:(id)arg4 {
//hook后要处理的方式3
return %orig;
}
%end
%end
//使用group要配合ctor
%ctor {
//[[UIDevice currentDevice] systemVersion].doubleValue 可以用来判断版本或其它逻辑。
if ([[UIDevice currentDevice] systemVersion].doubleValue >= 11.0) {
//这里group3会覆盖group1，不会执行group1逻辑。
%init(group1)%init(group3);
} else {
%init(group2);
}
}
-
group初始化在%ctor中，需要%init初始化。 - 所有
group必须初始化，否则编译报错。 - 在一个逻辑中同时初始化多个
group，后面的会覆盖前面的。 - 在不添加
group的情况下，默认有个_ungrouped组，会自动初始化。
Begin a hook group with the name Groupname. Groups cannot be inside another
[%group](https://iphonedev.wiki/index.php/Logos#.25group "Logos")block. All ungrouped hooks are in the implicit "_ungrouped" group. The _ungrouped group is initialized for you if there are no other groups. You can use the%initdirective to initialize it manually. Other groups must be initialized with the%init(Groupname)directive
%hook
HOOK某个类里面的某个方法。
%hook RichTextView
- (_Bool)setPrefixContent:(id)arg1 TargetContent:(NSString *)arg2 TargetParserString:(id)arg3 SuffixContent:(id)arg4 {
//hook后要处理的方式1
return %orig;
}
%end
%hook后面需要跟需要hook的类名。
%new
为某个类添加新方法，在%hook 和 %end 中使用。
%hook RichTextView
%new
- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
}
%end
%subclass
%subclass Classname: Superclass <Protocol list>
运行时创建子类，只能包含方法或者关联属性，不能包含属性。可以通过%c创建类实例。
#import <UIKit/UIKit.h>
@interface MyObject
- (void)setSomeValue:(id)value;
@end
%subclass MyObject : NSObject
- (id)init {
self = %orig;
[self setSomeValue:@"value"];
return self;
}
%new
- (id)someValue {
return objc_getAssociatedObject(self, @selector(someValue));
}
%new
- (void)setSomeValue:(id)value {
objc_setAssociatedObject(self, @selector(someValue), value, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
%end
%property
%property (nonatomic|assign|retain|copy|weak|strong|getter|setter) Type name;
为subclass或者hook的类添加属性。必须在 %subclass 或%hook中。
%property(nonatomic,assign) NSInteger age;
%end
与其它命令配对出现。
2.2、Top level
TopLevel指令不放在BlockLevel中。
%config
%config(Key=Value);
为logos设置标记。
Configuration Flags
| key | values | notes |
|---|---|---|
| generator | MobileSubstrate | 生成的代码使用MobileSubstrate hook
|
| generator | internal | 生成的代码只使用OC runtime方法hook
|
| warnings | none | 忽略所有警告 |
| warnings | default | 没有致命的警告 |
| warnings | error | 使所有警告报错 |
| dump | yaml | 以YAML格式转储内部解析树 |
%config(generator=internal);
%config(warnings=error);
%config(dump=yaml);
%hookf
hook函数，类似fishhook。
语法
%hookf(rtype, symbolName, args...) { … }
-
rtype：返回值。 -
symbolName：原函数地址。 -
args...：参数。
示例
FILE *fopen(const char *path, const char *mode);
%hookf(FILE *, fopen, const char *path, const char *mode) {
NSLog(@"Hey, we're hooking fopen to deny relative paths!");
if (path[0] != '/') {
return NULL;
}
return %orig;
}
%ctor
构造函数，用于确定加载那个组。和%init结合用。
%dtor
析构，做一些收尾工作。比如应用挂起的时候。
2.3、Function level
这一块的指令就放在方法中
%init
用来初始化某个组。
%class
%class Class;
%class
%c
类似getClass函数，获得一个类对象。一般用于调用类方法。
//只是为了声明编译通过
@interface MainViewController
+ (void)HP_classMethod;
@end
%hook MainViewController
%new
- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
//方式一
// [self.class HP_classMethod];
//方式二
// [NSClassFromString(@"MainViewController") HP_classMethod];
//方式三
[%c(MainViewController) HP_classMethod];
}
%new
+ (void)HP_classMethod {
NSLog(@"HP_classMethod");
}
%end
-
%c中没有引号。
%orig
保持原有的方法实现，如果原来的方法有返回值和参数，那么可以传递参数和接收返回值。
%hook RichTextView
- (_Bool)setPrefixContent:(id)arg1 TargetContent:(NSString *)arg2 TargetParserString:(id)arg3 SuffixContent:(id)arg4 {
//传递参数&接收返回值。
BOOL result1 = %orig(arg1,arg2,arg3,arg4);
BOOL result2 = %orig;
return %orig;
}
%end
image.png
-
%orig可以接收返回值。 - 可以传递参数，不传就是传递该方法的默认参数。
%log
能够输出日志，输出方法调用的详细信息 。
%hook RichTextView
- (_Bool)setPrefixContent:(id)arg1 TargetContent:(NSString *)arg2 TargetParserString:(id)arg3 SuffixContent:(id)arg4 {
%log;
return %orig;
}
%end
输出:
WeChat[11309:6708938] -[<RichTextView: 0x15c4c9720> setPrefixContent:(null) TargetContent:钱已经借给你了。 TargetParserString:<contentMD5>0399062cd62208dad884224feae2aa30</contentMD5><fontsize>20.287109</fontsize><fwidth>240.000000</fwidth><parser><type>1</type><range>{0, 8}</range><info><![CDATA[<style><range>{0, 8}</range><rect>{{0, 0}, {135, 21}}</rect></style>]]></info></parser> SuffixContent:(null)]
能够输出详细的日志信息，包含类、方法、参数、以及控件信息等详细信息。
总结
-
logos语法其实是CydiaSubstruct框架提供的一组宏定义。 - 语法
-
%hook，%end勾住某个类，在一个代码块中直接写需要勾住的方法。 -
%group，%end用于分组。- 每一组都需要
%ctor()函数构造。 - 通过
%init(组名称)进行初始化。
- 每一组都需要
-
%log输出方法的详细信息（调用者、方法名、方法参数） -
%orig调用原始方法。可以传递参数，接收返回值。 -
%c类似getClass函数，获取一个类对象。 -
%new添加某个方法。
-
-
.xm文件代表该文件支持OC、C/C++语法。 - 编译该文件时需要导入头文件以便编译通过。
.xm文件不参与代码的执行，编译后生成的.mm文件参与代码的执行。
网友评论