前言
logos语法我们其实并不陌生，在之前的文章中早已经使用过了，例如15-Hook原理（二）反Hook防护 & MokeyDev
文章末尾，我们hook了ViewController中的btnClick1方法，使用的就是logos语法。
logos语法，其实是CydiaSubstruct框架提供的一组宏定义。便于开发者使用宏进行HOOK操作。语法简单，功能强大且稳定。
一、基本使用
我们通过一个简单的案例演示一下，如何使用logos语法进行Hook。
1.1 搭建Demo App
- 首先，创建一个App，命名为
Demo。 - 打开
ViewController.m，写入一下代码👇
#import "ViewController.h"
@interface ViewController ()
@property (weak, nonatomic) IBOutlet UITextField *uid;
@property (weak, nonatomic) IBOutlet UITextField *pwd;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
}
- (IBAction)loginBtnClick:(id)sender {
[self postUID:self.uid.text PWD:self.pwd.text];
}
-(void)postUID:(NSString *)uid PWD:(NSString *)pwd{
if ([uid isEqualToString:@"Zang"] && [pwd isEqualToString:@"123456"]) {
UIAlertController * alertVC = [UIAlertController alertControllerWithTitle:@"登录成功" message:nil preferredStyle:(UIAlertControllerStyleAlert)];
UIAlertAction * cancel = [UIAlertAction actionWithTitle:@"确定" style:(UIAlertActionStyleCancel) handler:nil];
[alertVC addAction:cancel];
[self showViewController:alertVC sender:nil];
}else{
UIAlertController * alertVC = [UIAlertController alertControllerWithTitle:@"登录失败" message:nil preferredStyle:(UIAlertControllerStyleAlert)];
UIAlertAction * cancel = [UIAlertAction actionWithTitle:@"确定" style:(UIAlertActionStyleCancel) handler:nil];
[alertVC addAction:cancel];
[self showViewController:alertVC sender:nil];
}
}
@end
- 编译项目，生成Demo.app文件。
1.2 dump Demo
我们将Demo视作要Hook的App，那么接下来就是找到要Hook的对象。
- 先使用
class-dump工具，导出App的头文件，从中找到关键代码。
- 将Demo.app的MachO文件，拷贝到class-dump的同级目录，使用
class-dump指令，导出头文件👇
./class-dump -H Demo -o ./header/
- 在
ViewController.h文件中，就可以找到关键代码👇
#import <UIKit/UIViewController.h>
@class UITextField;
@interface ViewController : UIViewController
{
UITextField *_uid;
UITextField *_pwd;
}
- (void).cxx_destruct;
@property(nonatomic) __weak UITextField *pwd; // @synthesize pwd=_pwd;
@property(nonatomic) __weak UITextField *uid; // @synthesize uid=_uid;
- (void)postUID:(id)arg1 PWD:(id)arg2;
- (void)loginBtnClick:(id)arg1;
- (void)viewDidLoad;
@end
1.3 对Demo App项目进行HOOK
接下来就是搭建MokeyDev项目了，用来对Demo App进行Hook。
- 将
Demo.app拷贝到MokeyDev项目的TargetApp文件夹中 - 在MokeyDemoDylib中的Logos目录下，修改.xm文件的打开方式
- 使用
logos语法，对ViewController中的loginBtnClick:方法进行hook
直接在MokeyDemoDylib.xm文件，写入以下代码👇
#import <UIKit/UIKit.h>
@interface ViewController : UIViewController
@end
%hook ViewController
- (void)loginBtnClick:(id)arg1 {
UIAlertController * alertVC = [UIAlertController alertControllerWithTitle:@"🍺🍺🍺🍺🍺" message:nil preferredStyle:(UIAlertControllerStyleAlert)];
UIAlertAction * cancel = [UIAlertAction actionWithTitle:@"确定" style:(UIAlertActionStyleCancel) handler:nil];
[alertVC addAction:cancel];
[self showViewController:alertVC sender:nil];
}
%end
⚠️注意：
@interface ViewController : UIViewController一定要声明，否则会报错👇
使用logos语法，和日常开发的逻辑很相似，并不需要加入hook相关的额外代码。最终.xm文件中的logos语法，会被转为.mm文件中的代码，然后参与编译👇
二、logos语法
logos指令分为三个等级👇
-
Block level：块等级 -
Top level：顶部等级 -
Function level：函数等级
2.1 Block level
块等级，必须以%end结尾，并且不应存在于函数或方法中。
%group
%group Groupname
-
%group用于条件初始化，代码兼容性 -
%group不能在另一个%group块内，未分组的代码都在隐式_ungrouped组中 - 如果没有其他分组，自动初始化
_ungrouped组 -
%group必须配合%ctor使用，如果存在多个分组，每个分组都必须使用%init指令，手动对其进行初始化
使用示例👇
%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);
}
}
%hook
%hook Classname
为指定类定义一个HOOK块，可放在％group块内
使用示例👇
%hook ViewController
- (void)loginBtnClick:(id)arg1 {
NSLog(@"🍺🍺🍺🍺🍺");
%orig; // 原始方法的调用
}
%end
%new
%new
%new(signature)
给HOOK的类添加新方法，signature是新方法的OC类型编码，如果省略，将生成一个
⚠️注意：
%new必须在%hook块内！
使用示例👇
%hook ViewController
%new
- (void)my_NSLog {
NSLog(@"🍺🍺🍺🍺🍺");
}
%end
%end
%subclass
%subclass Classname: Superclass <Protocol list>
- 创建
子类，不支持ivars。使用%new添加新方法，实例化新类的对象，必须使用%c操作符。 - 可以写在
%group块内
使用示例👇
%subclass MyObject : NSObject
- (id)init {
self = %orig;
[self setSomeValue:@"value"];
return self;
}
//the following two new methods act as `@property (nonatomic, retain) id someValue;`
%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
%ctor {
MyObject *myObject = [[%c(MyObject) alloc] init];
NSLog(@"myObject: %@", [myObject someValue]);
}
%property
%property (nonatomic|assign|retain|copy|weak|strong|getter|setter) Type name;
- 在类中
添加新的属性，可添加到%subclass创建的新类中，也可以添加到现有类中 - 必须在
％subclass或％hook块内
%end
%end
用于标记group/hook/subclass的块结束。
2.2 Top level
顶部等级，指令不应存在于group/hook/subclass块中。
%config
%config(Key=Value);
设置Logos配置项。有以下配置选项👇
%hookf
%hookf(rtype, symbolName, args...) { … }
对指定函数进行HOOK，如果函数名称作为字符串传递，则将动态查找该函数。
- 示例1
// 原始函数的定义
FILE *fopen(const char *path, const char *mode);
// 使用以下方式HOOK
%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; // 原始方法的调用
}
- 示例2
CFBooleanRef (*orig_MGGetBoolAnswer)(CFStringRef);
CFBooleanRef fixed_MGGetBoolAnswer(CFStringRef string)
{
if (CFEqual(string, CFSTR("StarkCapability"))) {
return kCFBooleanTrue;
}
return orig_MGGetBoolAnswer(string);
}
%ctor {
MSHookFunction(((void *)MSFindSymbol(NULL, "_MGGetBoolAnswer")), (void *)fixed_MGGetBoolAnswer, (void **)&orig_MGGetBoolAnswer);
...
}
%hookf(CFBooleanRef, "_MGGetBoolAnswer", CFStringRef string)
{
if (CFEqual(string, CFSTR("StarkCapability"))) {
return kCFBooleanTrue;
}
return %orig;
}
%ctor
%ctor { … }
生成匿名构造函数。
%dtor
%dtor { … }
生成匿名析构函数。
2.3 Function level
函数等级，仅存在于函数或方法中。
%init
%init;
%init([<class>=<expr>, …]);
%init(Group[, [+|-]<class>=<expr>, …]);
初始化分组或默认分组。
例如👇
%hook SomeClass
-(id)init {
return %orig;
}
%end
%ctor {
%init(SomeClass=objc_getClass("class with spaces in the name"));
}
%c
%c([+|-]Class)
传入实例对象名或类名。
%orig
%orig
%orig(arg1, …)
原始方法的调用，不能用于%new。
%log
%log;
%log([(<type>)<expr>, …]);
输出日志。
总结
-
Logos
-
Logos语法是CydiaSubstruct框架提供的一组宏定义 - 详情可查看：官方文档
-
-
语法
-
%hook，%end勾住某个类，在一个代码块中直接写需要勾住的方法 -
%group，%end用于分组，配合%ctor构造函数使用，每个组都必须%init -
%log输出方法的相信信息，包含调用者、方法名、参数 -
%orig调用原始方法，可传递参数，可接收返回值 -
%c类似getClass函数，获取一个类对象 -
%new添加某个方法
-
-
xm文件-
xm代表支持OC、C/C++语法 -
xm文件不参与执行 - 编译该文件，需要导入头文件，以便编译通过
-
