CaptainHook 源码分析（七）：其他宏接口

最新推荐文章于 2022-12-05 15:04:00 发布
最新推荐文章于 2022-12-05 15:04:00 发布
阅读量548 收藏
点赞数 2
分类专栏： iOS 安全攻防 文章标签： Objective-C Hook
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Airths/article/details/121266038
版权

目录

CHOptimizedMethod

宏接口 CHOptimizedMethod 用于针对对象方法生成对宏接口 CHMethod_super_、CHMethod_self_、CHMethod_new_ 的调用，其定义为：

// @param.count  对象方法的参数个数
// @param.args	 可变的参数列表
// 注意：宏接口 CHOptimizedMethod 不能生成对宏接口 CHMethod_ 的调用
#define CHOptimizedMethod(count, args...) \
	CHOptimizedMethod ## count(args)

宏接口 CHOptimizedMethod 会根据传入的对象方法的参数个数
分别生成对宏接口 CHOptimizedMethod0 ~ CHOptimizedMethod9 的调用：

// @param.optimization	如果填 super 则调用 CHMethod_super_ ，如果填 self 则调用 CHMethod_self_ ，如果填 new 则调用 CHMethod_new_
// @param.return_type	对象方法返回值的类型
// @param.class_type	对象方法所属类的名称（无论是对象方法还是类方法，都是当前类 ClassName 的方法，所以都为 ClassName）
// @param.name1			对象方法第一部分的方法名称
// @param.type1			对象方法第一个参数的类型
// @param.arg1			对象方法第一个参数的名称
// @param.name2			对象方法第二部分的方法名称
// @param.type2			对象方法第二个参数的类型
// @param.arg2			对象方法第二个参数的名称
// ...
// @param.name9			对象方法第九部分的方法名称
// @param.type9			对象方法第九个参数的类型
// @param.arg9			对象方法第九个参数的名称

// 调用具有 0 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod0(optimization, return_type, class_type, name) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name, name, CHDeclareSig0_(return_type), (self, _cmd))
// 调用具有 1 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod1(optimization, return_type, class_type, name1, type1, arg1) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $, name1:, CHDeclareSig1_(return_type, type1), (self, _cmd, arg1), type1 arg1)
// 调用具有 2 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod2(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $ ## name2 ## $, name1:name2:, CHDeclareSig2_(return_type, type1, type2), (self, _cmd, arg1, arg2), type1 arg1, type2 arg2)
// 调用具有 3 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod3(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $ ## name2 ## $ ## name3 ## $, name1:name2:name3:, CHDeclareSig3_(return_type, type1, type2, type3), (self, _cmd, arg1, arg2, arg3), type1 arg1, type2 arg2, type3 arg3)
// 调用具有 4 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod4(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $, name1:name2:name3:name4:, CHDeclareSig4_(return_type, type1, type2, type3, type4), (self, _cmd, arg1, arg2, arg3, arg4), type1 arg1, type2 arg2, type3 arg3, type4 arg4)
// 调用具有 5 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod5(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $, name1:name2:name3:name4:name5:, CHDeclareSig5_(return_type, type1, type2, type3, type4, type5), (self, _cmd, arg1, arg2, arg3, arg4, arg5), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5)
// 调用具有 6 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod6(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5, name6, type6, arg6) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $ ## name6 ## $, name1:name2:name3:name4:name5:name6:, CHDeclareSig6_(return_type, type1, type2, type3, type4, type5, type6), (self, _cmd, arg1, arg2, arg3, arg4, arg5, arg6), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5, type6 arg6)
// 调用具有 7 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod7(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5, name6, type6, arg6, name7, type7, arg7) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $ ## name6 ## $ ## name7 ## $, name1:name2:name3:name4:name5:name6:name7:, CHDeclareSig7_(return_type, type1, type2, type3, type4, type5, type6, type7), (self, _cmd, arg1, arg2, arg3, arg4, arg5, arg6, arg7), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5, type6 arg6, type7 arg7)
// 调用具有 8 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod8(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5, name6, type6, arg6, name7, type7, arg7, name8, type8, arg8) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $ ## name6 ## $ ## name7 ## $ ## name8 ## $, name1:name2:name3:name4:name5:name6:name7:name8:, CHDeclareSig8_(return_type, type1, type2, type3, type4, type5, type6, type7, type8), (self, _cmd, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5, type6 arg6, type7 arg7, type8 arg8)
// 调用具有 9 个参数的对象方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedMethod9(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5, name6, type6, arg6, name7, type7, arg7, name8, type8, arg8, name9, type9, arg9) \
	CHMethod_ ## optimization ## _(return_type, class_type *, class_type, CHClass(class_type), CHSuperClass(class_type), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $ ## name6 ## $ ## name7 ## $ ## name8 ## $ ## name9 ## $, name1:name2:name3:name4:name5:name6:name7:name8:name9:, CHDeclareSig9_(return_type, type1, type2, type3, type4, type5, type6, type7, type8, type9), (self, _cmd, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5, type6 arg6, type7 arg7, type8 arg8, type9 arg9)

宏接口 CHOptimizedMethod0 ~ CHOptimizedMethod9 会组织传入的宏参数，生成对宏接口 CHMethod_super_、CHMethod_self_、CHMethod_new_ 的调用，关于宏接口 CHMethod_super_、CHMethod_self_、CHMethod_new_ 的详细介绍，请参阅：

CaptainHook 源码分析（三）：交换 Objective-C 方法实现的核心代码（使用 RunTime API）
CaptainHook 源码分析（四）：交换 Objective-C 方法实现的核心代码（使用 Cydia Substrate）

以调用具有 2 个参数的对象方法 -(instancetype)[HcgPerson initWithName:(NSString *)aName age:(int)anAge] 的 CHMethod_super_ 为例：

#import "HcgPerson.h"
#import "CaptainHook.h"

CHDeclareClass(HcgPerson)

// -(instancetype)[HcgPerson initWithName:(NSString *)aName age:(int)anAge]

CHOptimizedMethod(2, super, HcgPerson*, HcgPerson, initWithName, NSString*, aName, age, int, anAge)
{
    NSLog(@"hzp done!!!");
    return nil;
}

CHConstructor
{
    CHLoadLateClass(HcgPerson);
    CHHook(2, HcgPerson, initWithName, age);
}

等价于

#import "HcgPerson.h"
#import "CaptainHook.h"

CHDeclareClass(HcgPerson)

// -(instancetype)[HcgPerson initWithName:(NSString *)aName age:(int)anAge]

CHOptimizedMethod2(super, HcgPerson*, HcgPerson, initWithName, NSString*, aName, age, int, anAge)
{
    NSLog(@"hzp done!!!");
    return ((void *)0);
}

CHConstructor
{
    CHLoadLateClass(HcgPerson);
    CHHook2(HcgPerson, initWithName, age);
}

等价于

#import "HcgPerson.h"
#import "CaptainHook.h"

CHDeclareClass(HcgPerson)

// -(instancetype)[HcgPerson initWithName:(NSString *)aName age:(int)anAge]

CHMethod_super_(HcgPerson*,
                HcgPerson *,
                HcgPerson,
                CHClass(HcgPerson),
                CHSuperClass(HcgPerson),
                initWithName$age$,
                initWithName:age:,
                CHDeclareSig2_(HcgPerson*, NSString*, int),
                (self, _cmd, aName, anAge),
                NSString* aName,
                int anAge)
{
    NSLog(@"hzp done!!!");
    return ((void *)0);
}

CHConstructor
{
    CHLoadLateClass(HcgPerson);
    CHHook_(HcgPerson, initWithName$age$);
}

CHOptimizedClassMethod

宏接口 CHOptimizedClassMethod 用于针对类方法生成对宏接口 CHMethod_super_、CHMethod_self_、CHMethod_new_ 的调用，其定义为：

// @param.count  类方法的参数个数
// @param.args	 可变的参数列表
// 注意：宏接口 CHOptimizedClassMethod 不能生成对宏接口 CHMethod_ 的调用
#define CHOptimizedClassMethod(count, args...) \
	CHOptimizedClassMethod ## count(args)

宏接口 CHOptimizedClassMethod 会根据传入的类方法的参数个数
分别生成对宏接口 CHOptimizedClassMethod0 ~ CHOptimizedClassMethod9 的调用：

// @param.optimization	如果填 super 则调用 CHMethod_super_ ，如果填 self 则调用 CHMethod_self_ ，如果填 new 则调用 CHMethod_new_
// @param.return_type	类方法返回值的类型
// @param.class_type	类方法所属类的名称（无论是对象方法还是类方法，都是当前类 ClassName 的方法，所以都为 ClassName）
// @param.name1			类方法第一部分的方法名称
// @param.type1			类方法第一个参数的类型
// @param.arg1			类方法第一个参数的名称
// @param.name2			类方法第二部分的方法名称
// @param.type2			类方法第二个参数的类型
// @param.arg2			类方法第二个参数的名称
// ...
// @param.name9			类方法第九部分的方法名称
// @param.type9			类方法第九个参数的类型
// @param.arg9			类方法第九个参数的名称

// 调用具有 0 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod0(optimization, return_type, class_type, name) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name, name, CHDeclareSig0_(return_type), (self, _cmd))
// 调用具有 1 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod1(optimization, return_type, class_type, name1, type1, arg1) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $, name1:, CHDeclareSig1_(return_type, type1), (self, _cmd, arg1), type1 arg1)
// 调用具有 2 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod2(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $ ## name2 ## $, name1:name2:, CHDeclareSig2_(return_type, type1, type2), (self, _cmd, arg1, arg2), type1 arg1, type2 arg2)
// 调用具有 3 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod3(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $ ## name2 ## $ ## name3 ## $, name1:name2:name3:, CHDeclareSig3_(return_type, type1, type2, type3), (self, _cmd, arg1, arg2, arg3), type1 arg1, type2 arg2, type3 arg3)
// 调用具有 4 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod4(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $, name1:name2:name3:name4:, CHDeclareSig4_(return_type, type1, type2, type3, type4), (self, _cmd, arg1, arg2, arg3, arg4), type1 arg1, type2 arg2, type3 arg3, type4 arg4)
// 调用具有 5 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod5(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $, name1:name2:name3:name4:name5:, CHDeclareSig5_(return_type, type1, type2, type3, type4, type5), (self, _cmd, arg1, arg2, arg3, arg4, arg5), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5)
// 调用具有 6 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod6(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5, name6, type6, arg6) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $ ## name6 ## $, name1:name2:name3:name4:name5:name6:, CHDeclareSig6_(return_type, type1, type2, type3, type4, type5, type6), (self, _cmd, arg1, arg2, arg3, arg4, arg5, arg6), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5, type6 arg6)
// 调用具有 7 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod7(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5, name6, type6, arg6, name7, type7, arg7) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $ ## name6 ## $ ## name7 ## $, name1:name2:name3:name4:name5:name6:name7:, CHDeclareSig7_(return_type, type1, type2, type3, type4, type5, type6, type7), (self, _cmd, arg1, arg2, arg3, arg4, arg5, arg6, arg7), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5, type6 arg6, type7 arg7)
// 调用具有 8 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod8(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5, name6, type6, arg6, name7, type7, arg7, name8, type8, arg8) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $ ## name6 ## $ ## name7 ## $ ## name8 ## $, name1:name2:name3:name4:name5:name6:name7:name8:, CHDeclareSig8_(return_type, type1, type2, type3, type4, type5, type6, type7, type8), (self, _cmd, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5, type6 arg6, type7 arg7, type8 arg8)
// 调用具有 9 个参数的类方法的（CHMethod_super_ 或者 CHMethod_self_ 或者 CHMethod_new_）
#define CHOptimizedClassMethod9(optimization, return_type, class_type, name1, type1, arg1, name2, type2, arg2, name3, type3, arg3, name4, type4, arg4, name5, type5, arg5, name6, type6, arg6, name7, type7, arg7, name8, type8, arg8, name9, type9, arg9) \
	CHMethod_ ## optimization ## _(return_type, id, class_type, CHMetaClass(class_type), object_getClass(CHMetaClass(class_type)), name1 ## $ ## name2 ## $ ## name3 ## $ ## name4 ## $ ## name5 ## $ ## name6 ## $ ## name7 ## $ ## name8 ## $ ## name9 ## $, name1:name2:name3:name4:name5:name6:name7:name8:name9:, CHDeclareSig9_(return_type, type1, type2, type3, type4, type5, type6, type7, type8, type9), (self, _cmd, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9), type1 arg1, type2 arg2, type3 arg3, type4 arg4, type5 arg5, type6 arg6, type7 arg7, type8 arg8, type9 arg9)

宏接口 CHOptimizedClassMethod0 ~ CHOptimizedClassMethod9 会组织传入的宏参数，生成对宏接口 CHMethod_super_、CHMethod_self_、CHMethod_new_ 的调用，关于宏接口 CHMethod_super_、CHMethod_self_、CHMethod_new_ 的详细介绍，请参阅：

CaptainHook 源码分析（三）：交换 Objective-C 方法实现的核心代码（使用 RunTime API）
CaptainHook 源码分析（四）：交换 Objective-C 方法实现的核心代码（使用 Cydia Substrate）

以调用具有 2 个参数的类方法 +(instancetype)[HcgPerson personWithName:(NSString *)aName age:(int)anAge] 的 CHMethod_super_ 为例：

#import "HcgPerson.h"
#import "CaptainHook.h"

CHDeclareClass(HcgPerson)

// +(instancetype)[HcgPerson personWithName:(NSString *)aName age:(int)anAge]

CHOptimizedClassMethod(2, super, HcgPerson*, HcgPerson, personWithName, NSString*, aName, age, int, anAge)
{
    NSLog(@"hcg done!!!");
    return nil;
}

CHConstructor
{
    CHLoadLateClass(HcgPerson);
    CHClassHook(2, HcgPerson, personWithName, age);
}

等价于

#import "HcgPerson.h"
#import "CaptainHook.h"

CHDeclareClass(HcgPerson)

// +(instancetype)[HcgPerson personWithName:(NSString *)aName age:(int)anAge]

CHOptimizedClassMethod2(super, HcgPerson*, HcgPerson, personWithName, NSString*, aName, age, int, anAge)
{
    NSLog(@"hcg done!!!");
    return ((void *)0);
}

CHConstructor
{
    CHLoadLateClass(HcgPerson);
    CHClassHook2(HcgPerson, personWithName, age);
}

等价于

#import "HcgPerson.h"
#import "CaptainHook.h"

CHDeclareClass(HcgPerson)

// +(instancetype)[HcgPerson personWithName:(NSString *)aName age:(int)anAge]

CHMethod_super_(HcgPerson*,
                id,
                HcgPerson,
                CHMetaClass(HcgPerson),
                object_getClass(CHMetaClass(HcgPerson)),
                personWithName$age$,
                personWithName:age:,
                CHDeclareSig2_(HcgPerson*, NSString*, int),
                (self, _cmd, aName, anAge),
                NSString* aName,
                int anAge)
{
    NSLog(@"hcg done!!!");
    return ((void *)0);
}

CHConstructor
{
    CHLoadLateClass(HcgPerson);
    CHHook_(HcgPerson, personWithName$age$);
}

用于调试和日志的相关宏接口

  • 宏定义 CHAppName 用于标识当前 App 的名称，如果开发者没有显式定义，则其默认值为 "CaptainHook"

    #ifndef CHAppName
#define CHAppName "CaptainHook"
#endif

  • 如果使用 Clang 编译器并且开启了 ARC 模式，则定义宏 CHHasARC

    #ifdef __clang__
#if __has_feature(objc_arc)
#define CHHasARC
#endif
#endif

  • 宏接口 CHStringify(x) 用于将标记 x 转换为字符串，其定义为：

    #define CHStringify_(x) #x
#define CHStringify(x) CHStringify_(x)

    使用示例：

    #import "CaptainHook.h"

CHConstructor
{
    const char * name0 = CHStringify(hcg);
    NSLog(@"name0 = %s", name0); // 输出结果为 name0 = hcg
    
    NSString* name1 = @CHStringify(hzp);
    NSLog(@"name1 = %@", name1); // 输出结果为 name1 = hzp
}

  • 宏接口 CHConcat(a, b) 用于将语言符号 a 和语言符号 b 组成一个语言符号 ab，其定义为：

    #define CHConcat_(a, b) a ## b
#define CHConcat(a, b) CHConcat_(a, b)

    使用示例：

    #import "CaptainHook.h"

int hcg_sum(int num1, int num2)
{
    return num1 + num2;
}

CHConstructor
{
    int result0 = CHConcat(hcg_, sum)(10, 20);
    NSLog(@"result0 = %d", result0); // 输出结果为 result0 = 30
    
    int result1 = CHConcat(hcg, _sum)(10, 20);
    NSLog(@"result1 = %d", result1); // 输出结果为 result1 = 30
}

  • 宏接口 CHNothing() 的本质是一个只执行一次的空的 do-while 循环，正如其名称所述，调用宏接口 CHNothing() 将不执行任何操作

    #define CHNothing() do { } while(0)

  • 宏接口 CHLocationInSource 用于生成（包含其所在行号和所属函数的）字符串，其定义为：

    #define CHLocationInSource [NSString stringWithFormat:@CHStringify(__LINE__) " in %s", __FUNCTION__]

    使用示例：

    #import "CaptainHook.h"

CHConstructor
{
    NSString* desc = CHLocationInSource;
    NSLog(desc);                // 输出结果为 8 in CHConstructor6
    NSLog(CHLocationInSource);  // 输出结果为 10 in CHConstructor6
}

  • 宏接口 CHLog(args...) 用于输出日志信息（日志信息中包含：App 名称、所传入的参数列表），其定义为：

    #define CHLog(args...)			NSLog(@CHAppName ": %@", [NSString stringWithFormat:args])

    使用示例：

    #import <Foundation/Foundation.h>
#import "CaptainHook.h"

CHConstructor
{
    NSString* name = @"hcg";
    int age = 20;
    CHLog(@"name = %@, age = %d", name, age); 
    // 输出结果为 
    // CaptainHook: name = hcg, age = 20
}

  • 宏接口 CHLogSource(args...) 用于输出日志信息（日志信息中包含：App 名称、所在行号、所属函数、所传入的参数列表），其定义为：

    #define CHLogSource(args...)	NSLog(@CHAppName " @ " CHStringify(__LINE__) " in %s: %@", __FUNCTION__, [NSString stringWithFormat:args])

    使用示例：

    #import <Foundation/Foundation.h>
#import "CaptainHook.h"

int hcg_sum(int num1, int num2)
{
    return num1 + num2;
}

CHConstructor
{
    NSString* name = @"hcg";
    int age = 20;
    CHLogSource(@"name = %@, age = %d", name, age); // 输出结果为 CaptainHook @ 13 in CHConstructor9: name = hcg, age = 20
}

  • 在 Debug 模式下：
    宏接口 CHDebugLog(args...) 会生成对宏接口 CHLog(args...) 的调用
    宏接口 CHDebugLogSource(args...) 会生成对宏接口 CHLogSource(args...) 的调用
    在 Release 模式下：
    调用宏接口 CHDebugLog(args...) 和 CHDebugLogSource(args...) 会生成对宏接口 CHNothing() 的调用，即不执行任何操作

    #ifdef CHDebug
#define CHDebugLog(args...)			CHLog(args)
#define CHDebugLogSource(args...)	CHLogSource(args)
#else
#define CHDebugLog(args...)			CHNothing()
#define CHDebugLogSource(args...)	CHNothing()
#endif

其他宏接口

  • MRC 模式下的自动释放池（CHAutoreleasePoolForScope）

    宏接口 CHAutoreleasePoolForScope() 用于在其作用域内初始化一个自动释放池，其定义为：

    #define CHScopeReleased \
	__attribute__((cleanup(CHScopeReleased)))

#define CHAutoreleasePoolForScope() \
	NSAutoreleasePool *CHAutoreleasePoolForScope __attribute__((unused)) CHScopeReleased = [[NSAutoreleasePool alloc] init]
#endif

    __attribute__((unused)) 用于告诉编译器：当被修饰的函数或者变量没有被使用时，不要报警告

    __attribute__((cleanup(CHScopeReleased))) 用于告诉编译器：如果声明的变量离开了其作用域，则自动调用销毁函数 CHScopeReleased（并将该变量作为参数传递给销毁函数）。销毁函数 CHScopeReleased 的定义为：

    __attribute__((unused)) CHInline
static void CHScopeReleased(id* sro)
{
	[*sro release] ;
}

    使用示例：

    // 需要为目标源文件添加编译标识：Target - Build Phases - Compile Sources - 目标源文件 - fno-objc-arc
#import <Foundation/Foundation.h>
#import "CaptainHook.h"

CHConstructor
{
    CHAutoreleasePoolForScope();
    
    NSObject* obj0 = [[[NSObject alloc] init] autorelease];
    NSObject* obj1 = [[[NSObject alloc] init] autorelease];
    
    // CHAutoreleasePoolForScope(); 的作用域结束后，会自动释放 obj0 和 obj1 
}

  • 编译阶段的断言（CHBuildAssert）

    宏接口 CHBuildAssert(condition) 用于在编译阶段断言条件 condition 是否满足。如果条件 condition 满足，则会在编译阶段提示错误，而不是等到运行阶段再出现奔溃。宏接口 CHBuildAssert(condition) 的定义为：

    // 如果条件 condition 满足，则结果为 ((void)sizeof(char[-1]))，编译失败
// 如果条件 condition 不满足，则结果为 ((void)sizeof(char[1]))，编译成功
#define CHBuildAssert(condition) \
	((void)sizeof(char[1 - 2*!!(condition)]))

    使用示例：

    #import "CaptainHook.h"

CHConstructor
{
    // 以下 3 行代码将编译成功
    CHBuildAssert(NO);
    CHBuildAssert(false);
    CHBuildAssert(0);
    
    // 以下 3 行代码将编译失败。报错: Array size is negative
    CHBuildAssert(YES);
    CHBuildAssert(true);
    CHBuildAssert(1);
}

  • 代码块的耗时统计（CHProfileScope）

    宏接口 CHProfileScope() 用于在其作用域内初始化一个计时器（以统计其作用域内所包含的代码块的耗时），其定义为：

    #define CHProfileScope() \
	CHProfileScopeWithFormat(@CHStringify(__LINE__) " in %s", __FUNCTION__)

    宏接口 CHProfileScope() 会根据其所在行号和所属函数，生成对宏接口 CHProfileScopeWithFormat 的调用

    #define CHProfileScopeWithFormat(args...) \
	CHProfileScopeWithString(([NSString stringWithFormat:args]))

    宏接口 CHProfileScopeWithFormat 会组织传入的参数，生成对宏接口 CHProfileScopeWithString 的调用

    #define CHProfileScopeWithString(string) \
		struct CHProfileData _profileData __attribute__((cleanup(CHProfileCalculateDurationAndLog_))) = ({ struct CHProfileData _tmp; _tmp.message = (string); _tmp.startTime = mach_absolute_time(); _tmp; })

    宏接口 CHProfileScopeWithString 会初始化一个 struct CHProfileData 结构体类型的变量 _profileData
    其中 __attribute__((cleanup(CHProfileCalculateDurationAndLog_))) 用于告诉编译器：如果声明的变量 _profileData 离开了其作用域，则自动调用销毁函数 CHProfileCalculateDurationAndLog_

    结构体 struct CHProfileData 和销毁函数 CHProfileCalculateDurationAndLog_ 的定义为：

    #import <mach/mach_time.h>

struct CHProfileData
{
	NSString* message;
	uint64_t startTime;
};

__attribute__((unused)) CHInline
static void CHProfileCalculateDurationAndLog_(struct CHProfileData* profileData)
{
	uint64_t duration = mach_absolute_time() - profileData->startTime;
	mach_timebase_info_data_t info;
	mach_timebase_info(&info);
	duration = (duration * info.numer) / info.denom;
	CHLog(@"Profile time: %lldns; %@", duration, profileData->message);
}

    如下代码：

    #import <Foundation/Foundation.h>

#define CHEnableProfiling
#import "CaptainHook.h"

CHConstructor
{
    CHProfileScope();
    
    for (int i = 0; i < 1000; i++) {
        NSLog(@"times = %d", i);
    }
	
	// 用于统计 for 循环的执行时间（单位：纳秒）
}

    等价于

    #import <Foundation/Foundation.h>

#define CHEnableProfiling 1
#import "CaptainHook.h"

CHConstructor
{
    CHProfileScopeWithFormat(@CHStringify(8) " in %s", __FUNCTION__);
	
	for (int i = 0; i < 1000; i++) {
		NSLog(@"times = %d", i);
	}
}

    等价于

    #import <Foundation/Foundation.h>

#define CHEnableProfiling
#import "CaptainHook.h"

CHConstructor
{
    CHProfileScopeWithString(([NSString stringWithFormat:@CHStringify(8) " in %s", __FUNCTION__]));
    
	for (int i = 0; i < 1000; i++) {
		NSLog(@"times = %d", i);
	}
}

    预处理后的结果为：

    ...

#pragma clang module import Darwin.Mach.mach_time /* clang -E: implicit import for #import <mach/mach_time.h> */

struct CHProfileData
{
    NSString *message;
    uint64_t startTime;
};

__attribute__((unused)) inline __attribute__((always_inline))
static void CHProfileCalculateDurationAndLog_(struct CHProfileData *profileData)
{
    uint64_t duration = mach_absolute_time() - profileData->startTime;
    mach_timebase_info_data_t info;
    mach_timebase_info(&info);
    duration = (duration * info.numer) / info.denom;
    NSLog(@"CaptainHook" ": %@", [NSString stringWithFormat:@"Profile time: %lldns; %@", duration, profileData->message]);
}

static __attribute__((constructor)) void CHConstructor6()
{
    struct CHProfileData _profileData __attribute__((cleanup(CHProfileCalculateDurationAndLog_))) =
    ({
        struct CHProfileData _tmp;
        _tmp.message = (([NSString stringWithFormat:@"8" " in %s", __FUNCTION__]));
        _tmp.startTime = mach_absolute_time();
        _tmp;
    });
	
	for (int i = 0; i < 1000; i++) {
		NSLog(@"times = %d", i);
	}
}
Airths
关注
  • 2
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
iOS越狱插件编写 - 支付宝自动咻咻 （一）
yca8939的专栏
02-05 5572
iOS越狱插件编写 - 支付宝自动咻咻 （一）
hook的简单示例
成长之路
04-16 883
//----------------------------------------------------------------------------------------------------extern "C" __declspec(dllexport) void __stdcall SetHook(HWND,bool);LRESULT CALLBACK HookProc(int n
【iOS逆向与安全】iOS插件开发光速入门
最新发布
小陈的技术博客
12-05 2441
经过之前的学习，相信你已经能熟练的使用Frida-trace、IDA Pro等逆向工具。不过，仅仅到这肯定是不够的。接下来，学会把你逆向的结果打包成插件并运行，那iOS逆向，你也就真正的入门了。
给微信聊天记录添加截图功能
weixin_34211761的博客
04-10 473
有时候，知识小集群里讨论的技术问题，比较有价值，我们会把有价值的内容整理出来供大家查阅。但为了保护群友隐私，需要把昵称和头像都打码，如果碰到几百条聊天记录，这样做简直要吐血。而且也不能截一张长图，只能一张一张截取，然后拼接起来。群聊记录只能在微信内分享，这也限制了传播的渠道。为了提高小集成员工作效率，想着能不能给微信做个插件，解决这些问题。我们一直在追求如何更有效率开展我们的工作，比如使用脚本自动...
iOS逆向笔记
weixin_34348174的博客
02-28 276
学习逆向过程中的一些总结 参考资料链接 资料汇总 基本操作 unzip appname.ipa ipa解压,appname.app/appname就是二进制文件 file appname.app/appname 查看包含哪些架构 armv7 32位真机架构 arm64 64位真机架构 otool -l WeChat.app/WeChat | grep -B 2 crypt otool可以输出app...
iOS逆向工程整理_HOOK微信抢红包_0x02
dlmlzz09的专栏
03-16 5919
原理 原理上篇已经说过了，利用iOS的runtime特效，替换方法的实现来达到HOOK的目的。本篇是一个实战教程，讲解怎么来Hook微信的自动抢红包。 第1步：砸壳 首先ssh连上越狱iOS设备，执行ps -e查找微信的app地址 这里的app路径是/var/mobile/Containers/Bundle/Application/690828B8-B63F-4FAC-B7CC-D
captainhook-eslint：Captain Hook插件可使用ESLint验证文件
02-04
moxio / captainhook-eslint 该项目是的插件，可以在git pre-commit挂钩中使用检查JavaScript文件。 默认情况下，将检查所有*.js和*.mjs文件，并在发现一个或多个错误时阻止提交。 ESLint产生的警告将被忽略。 安装...
captainhook-validateauthor:Hook Plugin队长检查提交作者是否有效（例如，白名单中的电子邮件）
03-29
bitexpert / captainhook-validateauthor 该软件包为提供了一个动作，当作者姓名或电子邮件与captainhook.json配置文件中定义的正则表达式不匹配时，该动作将拒绝提交。 如果要确保私人电子邮件地址不会出现在公司...
CaptainHook.h（注释版）
12-02
（CaptainHook.h 头文件）通过使用（大量的宏定义）将（Hook Objective-C 方法的通用操作）抽取成（精简的宏接口），而（这些宏接口）会在（预处理阶段）展开成（通用的 Hook 代码模板）。 通过使用 CaptainHook ...
captainhook:使用http网址运行钩子
04-30
这简化了集成到其他系统，如CI/CD流程，自动化测试，或者实时数据分析。 3. **JavaScript**：CaptainHook使用JavaScript作为主要编程语言，这使得它能广泛适用于Web开发场景，并且可以与Node.js环境无缝集成。...
captainhook：PHP开发人员非常灵活的git hook manager
02-04
您可以使用CaptainHook来验证或准备提交消息，确保代码质量或运行单元测试，然后再将更改提交或推送到git。 拉动最新更改后，您可以自动清除本地缓存或安装最新的作曲家依赖项。 CaptainHook使在团队中共享钩子变...
iOS逆向抖音学习滤镜，你知道吗？
qq_41597968的博客
03-29 1813
逆向不只可以让我娱乐别人的APP,我们也可以从别人的APP中学到一些东西,有时候我们会为了某种实现去逆向。由于前段时间公司项目需要写一个类似抖音的滤镜,不免就对抖音起了好奇心。最后效果如下:IMG_0719.jpg工具依然使用MonkeyDev，然后是分析工具Hopper,log工具NSLogger步骤在这里我还是要推荐下我自己建的iOS开发学习群：680565220，群里都是学ios开发的，如果...
iOS:通过MonkeyDev逆向微信运动,简单粗暴非越狱
weixin_33686714的博客
03-22 730
前言 前一段时间,一直忙于面试,也没做研究什么稀奇古怪的技术.近来也是学习了几天的iOS逆向工程方面的知识,这里就班门弄斧下,看看如何通过逆向工程来修改微信运动数据.先看一下效果图. 前期准备 在逆向之前我们需要准备一下以下工作.以方便我们的逆向功能能顺利开发. 需要技能: 1.懂基本的终端指令以及操作. 2.会使用Xcode. 3.一台未越狱的iPhone. #####1....
CaptainHook 源码分析（二）：构造函数 && 类的声明 && 类的加载
Airths 的博客
12-08 625
目录一个最简单的 CaptainHook 代码生成构造函数（CHConstructor）生成类的声明（CHDeclareClass）生成类的加载（CHLoadLateClass、CHLoadClass）其他常用的宏接口（CHClass、CHMetaClass、CHSuperClass、CHAlloc、CHSharedInstance、CHIsClass、CHRespondsTo） 一个最简单的 CaptainHook 代码 在 .m 文件中单纯地导入 CaptainHook.h 头文件： #import "
iOS逆向之微信和支付宝修改步数 简洁无脑版
热门推荐
Crazy Panda
03-27 3万+
(本教程仅供研究学习用，请勿用于其他用途) 先放两张图片。 支付宝的： 微信的： 这是修改之后的 微信步数上线是98800（不知道为啥是这个数字），支付宝是100000.. 下面列出本文用到的工具 iOSOpenDev 创建动态库用到 hopper 汇编分析 yololib 注入使用 （Extra_Chapter文件夹下的yololib) ios-app-signer
CaptainHook 源码分析（五）：Hook 对象方法 && 类方法
Airths 的博客
12-08 1166
目录Hook 对象方法（CHMethod + CHHook）Hook 对象方法（CHDeclareMethod）CHMethod 与 CHDeclareMethod 的区别Hook 类方法（CHClassMethod + CHClassHook）Hook 类方法（CHDeclareClassMethod）CHClassMethod 与 CHDeclareClassMethod 的区别调用被 Hook 的方法的原始实现（CHSuper） Hook 对象方法（CHMethod + CHHook） 在 Cap
【Mac逆向】手撸钉钉机器人
小陈的技术博客
08-11 593
钉钉在企业中的应用越来越广泛。官方也有对应的自定义机器人服务，但是，如果1分钟内发消息超过20条，则会会限流10分钟。作为技术人，说干就干，申请个小号，手撸一个无限制的机器人。
越狱开发教程－第一个Tweak
keyken的专栏
03-27 1万+
转自：http://moonbear.blogcn.com/articles/ 看到写的比较好的介绍文章，转过来。博主文笔不错，写的很通俗易懂。上次搜索怎么就没找到这呢 越狱开发历程（3）——第一个Tweak Posted on 2012-10-10by 不掏蜂窝的熊 BigBoss有一个分类，称之为Tweaks。网上所说得越狱插件，大多可归类与此。至于tweak这个名称的由来以
iOS(越狱) 应用脱壳反编译hook教程 (系统ios11.3.1)
momoxiaoming的博客
07-09 6777
为什么会有这边博文? 因为公司原因,领导又让我捡起荒废了一年多的ios,了解对ios应用脱壳以及反编译hook相关知识.相比于安卓的hook来说(想了解安卓hook的可以参考我的另外一篇文章),ios的hook要麻烦的多,前人栽树后人乘凉,希望我的这边文章能给大家对ios的hook有个清晰的认识和思路. 一. 项目需求 本文以很久以前上架的一个练手app为例(app有点烂,将就一下吧,点击传送门)...
LLDB（一）：入门指南
Airths 的博客
03-01 7331
目录LLDB 简介LLDB 入门帮助命令与搜索命令：help 与 apropos基础命令总览 LLDB 简介 什么是 LLDB？ LLDB（Low Level Debugger）是新一代高性能调试器，其是一组可重用组件的集合，这些组件大多是 LLVM 项目中的现有库，例如：Clang 表达式解析器，LLVM 反汇编程序，等等 LLDB 是 macOS 上 Xcode 中的默认调试器，Xcode 主窗口底部的控制台便是开发者与 LLDB 交互的区域。LLDB 允许开发者在程序运行的特定时刻暂停进程，查看变

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值