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 

@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

功能：创建子类，不支持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([=, …]);
%init(Group[, [+|-]=, …]);

功能：初始化分组或者默认分组
示例：

%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([(), …]);

功能：输出日志

总结

Logos语法是CydiaSubstruct框架提供的一组宏定义。
常用语法
- %hook，%end勾住某个类，在一个代码块中直接写需要勾住的方法
- %group，%end用于分组，配合%ctor构造函数使用，每个组都必须%init
- %log输出方法的相信信息，包含调用者、方法名、参数
- %orig调用原始方法，可传递参数，可接收返回值
- %c类似getClass函数，获取一个类对象
- %new添加某个方法
xm文件表示支持OC、C/C++语法
xm文件不参与执行
编译xm文件，需要导入头文件，以便编译通过

18 - Logos