Logos 语法

1. %hook className 指定需要hook的class，必须以end结尾 如：hook了系统界面的home按钮按下方法

   %hook SpringBoard
   - (void)_munuButtonDown:(id)down{
      NSLog(@"You are press the home button");
      %orig;//call the original _menuButton
   }
   %end
   

2. %log 打印日志

   %log((NSString *)@"iOSRE", (NSString *)@"Debug");
   
   

3. %orig 执行原始代码，必须在%hook里面使用，如果在hook方法里面不增加这一行代码，那么原始函数不会被调用。另外还可以用该函数修改原始函数的参数。

   %hook SBLockScreenDateViewController
   //以下方法设置锁屏界面的日期的文字，改成了lemon love well
   - (void)setCustomSubtitleText:(id)arg1 withColor:(id)arg2
   {
      %orig(@"Lemon love Well",arg2);
   }
   %end
   
   

4. %group 用户将%hook分组，便于代码管理和条件初始化分组，必须以%end结尾，一个%group可以包括多个%hook，如果一个%hook不在一个%group里面，那么这个%hook属于%group_ungrouped。

   %group iOS7Hook
       %hook iOS7Class
       - (id)iOS7Method{
           id result = %orig;
           NSLog(@"This class & method only exist in iOS
           7.");
           return result;
       }
       %end
   %end
       %group iOS8Hook
       %hook iOS8Class
       - (id)iOS8Method{
           id result = %orig;
           NSLog(@"This class & method only exist in iOS
           8.");
           return result;
       }
       %end
   %end
   
   

5. %init 值得注意的是，每个%group必须配合下面的%init使用才能生效，该指令用户初始化一个%group，必须在%hook里面调用或者%ctor里面调用。如果带参数，那么初始化指定的group，如果不带参数，那么初始化_ungrouped。如：

   #ifndef kCFCoreFoundationVersionNumber_iOS_8_0
   #define kCFCoreFoundationVersionNumber_iOS_8_0 1140.10
   #endif
   %hook SpringBoard
   - (void)applicationDidFinishLaunching:(id)application
   {
       %orig;
       %init; // Equals to %init(_ungrouped)
       if (kCFCoreFoundationVersionNumber >=
       kCFCoreFoundationVersionNumber_iOS_7_0 &&
       kCFCoreFoundationVersionNumber <
       kCFCoreFoundationVersionNumber_iOS_8_0)          %init(iOS7Hook);//init iOS7Hook group
       if (kCFCoreFoundationVersionNumber >=
       kCFCoreFoundationVersionNumber_iOS_8_0) %init(iOS8Hook);
   }
   

%end
```

6. %ctor，tweak的constructor，完成初始化工作，如果不显式定义，theos会自动生成一个%ctor，并在里面调用%init(_ungrouped)。如

   //以下代码段可以生效，因为theos隐式调用了%ctor并且%init(_ungroped)
   %hook SpringBoard
   - (void)reboot
   {
      NSLog(@"If rebooting does not word then i screwed");
      %orig;//call origin method
   }
   %end
   //以下代码段不能生效，虽然显式定义了%ctor，但是没有在里面调用%init方法
   %hook SpringBoard
      - (void)reboot
   {
      NSLog(@"If rebooting does not word then i screwed");
      %orig;//call origin method
   }
   %ctor{
      //need to call %init here.
   }
   %end
   

7. %new在%hook内部使用，给一个现有的class添加新的函数，功能与class_addMethod一样。

   %hook SpringBoard
   %new 
   - (void)createNewMethod
   {
        NSLog(@"This is a new method");
   }
   

8. %c 该指令的作用等同于NSClassFromString()或者obj_getClass()动态获取一个类的定义，在%hook或者%ctor内使用。