mirror of
https://github.com/DKJone/DKWechatHelper.git
synced 2025-05-24 03:23:39 +08:00
90 lines
3.1 KiB
Objective-C
90 lines
3.1 KiB
Objective-C
/*
|
||
* OCMethodTrace.h
|
||
* OCMethodTrace
|
||
*
|
||
* https://github.com/omxcodec/OCMethodTrace.git
|
||
*
|
||
* Copyright (C) 2018 Michael Chen <omxcodec@gmail.com>
|
||
*
|
||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
* you may not use this file except in compliance with the License.
|
||
* You may obtain a copy of the License at
|
||
*
|
||
* http://www.apache.org/licenses/LICENSE-2.0
|
||
*
|
||
* Unless required by applicable law or agreed to in writing, software
|
||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
* See the License for the specific language governing permissions and
|
||
* limitations under the License.
|
||
*/
|
||
|
||
#import <Foundation/Foundation.h>
|
||
|
||
// 方法跟踪条件block
|
||
// @param sel 方法名
|
||
typedef BOOL (^OMTConditionBlock)(SEL sel);
|
||
|
||
// 方法调用前会调用该block
|
||
// @param target 跟踪目标对象
|
||
// @param cls 调用方法所在的类(可以是target所在的类，也可以是target的父类)
|
||
// @param sel 方法名
|
||
// @param args 参数列表
|
||
// @param deep 调用层次
|
||
typedef void (^OMTBeforeBlock)(id target, Class cls, SEL sel, NSArray *args, int deep);
|
||
|
||
// 方法调用后会调用该block
|
||
// @param target 跟踪目标对象
|
||
// @param cls 调用方法所在的类(可以是target所在的类，也可以是target的父类)
|
||
// @param sel 方法名
|
||
// @param ret 返回值
|
||
// @param deep 调用层次
|
||
// @param interval 执行方法的ms耗时
|
||
typedef void (^OMTAfterBlock)(id target, Class cls, SEL sel, id ret, int deep, NSTimeInterval interval);
|
||
|
||
// target位置
|
||
typedef NS_ENUM(NSUInteger, OMTTargetPosition) {
|
||
OMTTargetPositionBeforeSelf = 0, // before-调用者self
|
||
OMTTargetPositionBeforeArgument, // before-参数
|
||
OMTTargetPositionAfterSelf, // after-调用者self
|
||
OMTTargetPositionAfterReturnValue, // after-返回值
|
||
OMTTargetPositionMax,
|
||
};
|
||
|
||
// 日志级别
|
||
typedef NS_ENUM(NSUInteger, OMTLogLevel) {
|
||
OMTLogLevelError = 0,
|
||
OMTLogLevelDebug,
|
||
OMTLogLevelMax,
|
||
};
|
||
|
||
@protocol OCMethodTraceDelegate <NSObject>
|
||
|
||
@optional
|
||
// 获取target的description回调
|
||
- (NSString *)descriptionWithTarget:(id)target class:(Class)cls selector:(SEL)sel targetPosition:(OMTTargetPosition)targetPosition;
|
||
// 日志回调
|
||
- (void)log:(OMTLogLevel)level format:(NSString *)format, ... NS_FORMAT_FUNCTION(2,3);
|
||
|
||
@end
|
||
|
||
@interface OCMethodTrace : NSObject
|
||
|
||
@property (nonatomic, assign) BOOL disableTrace; // 屏蔽before和after调用，hook完成后默认打开
|
||
@property (nonatomic, weak) id<OCMethodTraceDelegate> delegate; // 回调
|
||
@property (nonatomic, assign) OMTLogLevel logLevel; // 日志级别，默认OMTLogLevelDebug
|
||
|
||
+ (OCMethodTrace *)sharedInstance;
|
||
|
||
// 跟踪打印目标(实例或类)方法调用
|
||
// @param cls 跟踪打印目标类
|
||
// @param condition 判断是否跟踪方法的block
|
||
// @param before 被跟踪的方法调用前会调用该block
|
||
// @param after 被跟踪的方法调用后会调用该block
|
||
- (void)traceMethodWithClass:(Class)cls
|
||
condition:(OMTConditionBlock)condition
|
||
before:(OMTBeforeBlock)before
|
||
after:(OMTAfterBlock)after;
|
||
|
||
@end
|