87 lines
4.0 KiB
Objective-C
Executable File
87 lines
4.0 KiB
Objective-C
Executable File
//
|
||
// ABSBootingProtection.h
|
||
// AntilockBrakeSystem
|
||
//
|
||
// Created by 地风（ElonChan） on 16/5/16.
|
||
// Copyright © 2016年 Ali. All rights reserved.
|
||
//
|
||
|
||
#import <Foundation/Foundation.h>
|
||
|
||
typedef void (^ABSBoolCompletionHandler)(BOOL succeeded, NSError *error);
|
||
typedef void (^ABSRepairBlock)(ABSBoolCompletionHandler completionHandler);
|
||
typedef void (^ABSReportBlock)(NSUInteger crashCounts);
|
||
|
||
typedef NS_ENUM(NSInteger, ABSBootingProtectionStatus) {
|
||
ABSBootingProtectionStatusNormal, /**< APP 启动正常 */
|
||
ABSBootingProtectionStatusNormalChecking, /**< 正在检测是否会在特定时间内是否会 Crash，注意：检测状态下“连续启动崩溃计数”个数小于或等于上限值 */
|
||
ABSBootingProtectionStatusNeedFix, /**< APP 出现连续启动 Crash，需要采取修复措施 */
|
||
ABSBootingProtectionStatusFixing, /**< APP 出现连续启动 Crash，正在修复中... */
|
||
};
|
||
|
||
/**
|
||
* 启动连续 crash 保护。
|
||
* 启动后 `_crashOnLaunchTimeIntervalThreshold` 秒内 crash，反复超过 `_continuousCrashOnLaunchNeedToReport` 次则上报日志，超过 `_continuousCrashOnLaunchNeedToFix` 则启动修复操作。
|
||
*/
|
||
@interface ABSBootingProtection : NSObject
|
||
|
||
/**
|
||
* 启动连续 crash 保护方法。
|
||
* 前置条件：在 App 启动时注册 crash 处理函数，在 crash 时调用[ABSBootingProtection addCrashCountIfNeeded]。
|
||
* 启动后一定时间内（`crashOnLaunchTimeIntervalThreshold`秒内）crash，反复超过一定次数（`continuousCrashOnLaunchNeedToReport`次）则上报日志，超过一定次数（`continuousCrashOnLaunchNeedToFix`次）则启动修复程序；在一定时间内（`crashOnLaunchTimeIntervalThreshold`秒） 秒后若没有 crash 将“连续启动崩溃计数”计数置零。
|
||
`reportBlock` 上报逻辑，
|
||
`repairtBlock` 修复逻辑，完成后执行 `[self setCrashCount:0]`
|
||
|
||
*/
|
||
- (void)launchContinuousCrashProtect;
|
||
|
||
/*!
|
||
* 当前启动Crash的状态
|
||
*/
|
||
@property (nonatomic, assign, readonly) ABSBootingProtectionStatus bootingProtectionStatus;
|
||
|
||
/*!
|
||
* 达到需要执行上报操作的“连续启动崩溃计数”个数。
|
||
*/
|
||
@property (nonatomic, assign, readonly) NSUInteger continuousCrashOnLaunchNeedToReport;
|
||
|
||
/*!
|
||
* 达到需要执行修复操作的“连续启动崩溃计数”个数。
|
||
*/
|
||
@property (nonatomic, assign, readonly) NSUInteger continuousCrashOnLaunchNeedToFix;
|
||
|
||
/*!
|
||
* APP 启动后经过多少秒，可以将“连续启动崩溃计数”清零
|
||
*/
|
||
@property (nonatomic, assign, readonly) NSTimeInterval crashOnLaunchTimeIntervalThreshold;
|
||
|
||
/*!
|
||
* 借助 context 可以让多个模块注册事件，并且事件 block 能独立执行，互不干扰。
|
||
*/
|
||
@property (nonatomic, copy, readonly) NSString *context;
|
||
|
||
/*!
|
||
* @details 启动后kCrashOnLaunchTimeIntervalThreshold秒内crash，反复超过continuousCrashOnLaunchNeedToReport次则上报日志，超过continuousCrashOnLaunchNeedToFix则启动修复程序；当所有操作完成后，执行 completion。在 crashOnLaunchTimeIntervalThreshold 秒后若没有 crash 将 kContinuousCrashOnLaunchCounterKey 计数置零。
|
||
* @param context 借助 context 可以让多个模块注册事件，并且事件 block 能独立执行，互不干扰。
|
||
*/
|
||
- (instancetype)initWithContinuousCrashOnLaunchNeedToReport:(NSUInteger)continuousCrashOnLaunchNeedToReport
|
||
continuousCrashOnLaunchNeedToFix:(NSUInteger)continuousCrashOnLaunchNeedToFix
|
||
crashOnLaunchTimeIntervalThreshold:(NSTimeInterval)crashOnLaunchTimeIntervalThreshold
|
||
context:(NSString *)context;
|
||
/*!
|
||
* 当前“连续启动崩溃“的状态
|
||
*/
|
||
+ (ABSBootingProtectionStatus)bootingProtectionStatusWithContext:(NSString *)context continuousCrashOnLaunchNeedToFix:(NSUInteger)continuousCrashOnLaunchNeedToFix;
|
||
|
||
/*!
|
||
* 设置上报逻辑，参数 crashCounts 为启动连续 crash 次数
|
||
*/
|
||
- (void)setReportBlock:(ABSReportBlock)reportBlock;
|
||
|
||
/*!
|
||
* 设置修复逻辑
|
||
*/
|
||
- (void)setRepairBlock:(ABSRepairBlock)repairtBlock;
|
||
|
||
@end
|