Logos语法，其实是CydiaSubstruct框架提供的一组宏定义。便于开发者使用宏进行HOOK操作。语法简单，功能强大且稳定。
基本使用
既然Logos是提供宏进行HOOK操作，因此，需要准备一个简单的App项目，通过对App中的HOOK操作来描述Logos的基本使用。
搭建Demo App
- 使用Xcode，创建Demo App。
- 在
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];
// Do any additional setup after loading the view.
}
- (IBAction)loginBtnClick:(id)sender {
[self postUID:self.uid.text PWD:self.pwd.text];
}
-(void)postUID:(NSString *)uid PWD:(NSString *)pwd{
if ([uid isEqualToString:@"DemoUID"] && [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文件。
HOOK App
需求：需要对Demo.app进行HOOK操作，获取其登陆密码。
dump Demo
当我们需要对一个应用进行HOOK操作时，第一步，需要找要HOOK的对象。
- 使用
class-dump工具，导出App的头文件目录，尝试从头文件中找到关键代码。
class-dump -H Demo -o ./DemoHeaders/
2021-06-03 15:15:33.505 class-dump[36957:2308651] Unknown load command: 0x00000032
- 由于Demo比较简单，因此导出的头文件个数不多，因此能很快定位到关键代码在
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
HOOK操作
搭建Monkey项目，对Demo.app进行HOOK操作。
使用Monkey的原因：
集成了Logos重签名代码注入注入HOOK框架
【第一步】将Demo.app拷贝至MonkeyDev的TargetApp中。
【第二步】在MokeyDemoDylib中的Logos目录下，修改.xm文件的打开方式为Objective-C++ Source。
【第三步】在MonkeyDemoDylib.xm中增加Logos代码。先简单填写如下代码，看看HOOK的结果。
%hook ViewController
- (void)viewDidLoad {
NSLog(@"Monkey Hook 成功");
%orig;
}
%end
【第四步】使用Monkey启动应用，查看控制台输出信息，发现打印出HOOK成功的信息。
2021-06-03 15:49:12.546398+0800 Demo[7842:6947826] [AntiAntiDebug Init]
🎉!!！congratulations!!！🎉
👍----------------insert dylib success----------------👍
[MethodTrace]
📚--------------------OCMethodTrace(Usage)-------------------📚
https://github.com/omxcodec/OCMethodTrace/blob/master/README.md
📚--------------------OCMethodTrace(Usage)-------------------📚
2021-06-03 15:49:12.650989+0800 Demo[7842:6947826] Monkey Hook 成功
使用Logos语法，和日常开发的逻辑很相似，并不需要加入HOOK相关的额外代码，最终MonkeyDemoDylib.xm文件中的Logos语法，会被转为MonkeyDemoDylib.xm.mm文件中的代码，然后参与编译。
Logos语法
Logos语法可查看官方文档，Logos指令分为三个等级：
-
Block level：块等级 -
Top level：顶部等级 -
Function level：函数等级
Block level
块等级，必须以%end结尾，并且不应存在于函数或方法中。
%group
语法：
%group Groupname
功能：用于条件初始化，代码兼容性操作等。
使用说明：
- 当未明确使用
%group时，则存在自动初始化_ungrouped组。 -
%group不能在另一个%group块内 -
%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)viewDidLoad {
NSLog(@"Monkey Hook 成功");
%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的块结束。
Top level
顶部等级，指令不应存在于group/hook/subclass块中。
%config
语法：
%config(Key=Value);
功能：设置Logos配置项。有以下配置项：
16227083682964.jpg
%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 { … }
功能：生成匿名析构函数。
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语法是CydiaSubstruct框架提供的一组宏定义。 -
常用语法
-
%hook，%end勾住某个类，在一个代码块中直接写需要勾住的方法 -
%group，%end用于分组，配合%ctor构造函数使用，每个组都必须%init -
%log输出方法的相信信息，包含调用者、方法名、参数 -
%orig调用原始方法，可传递参数，可接收返回值 -
%c类似getClass函数，获取一个类对象 -
%new添加某个方法
-
-
xm文件表示支持OC、C/C++语法 -
xm文件不参与执行 -
编译
xm文件，需要导入头文件，以便编译通过
网友评论