From 028d446ac674cf627bc2ec077709f556f2e908a3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=AD=E5=9F=8E=E5=B0=8F=E5=88=98?= Date: Mon, 6 Jul 2020 04:55:47 +0800 Subject: [PATCH] docs: Data uploader SDK && Readme --- Chapter1 - iOS/1.55.md | 227 +- Chapter1 - iOS/1.74.md | 4 +- Chapter1 - iOS/1.80.md | 2487 ++++++++++++++++- Chapter1 - iOS/collection.md | 124 + Chapter2 - Web FrontEnd/2.40.md | 4 +- Chapter5 - Network/5.3.md | 8 +- README.md | 14 +- SUMMARY.md | 2 +- ...06-29-DataUploadConfigurationStructure.png | Bin 0 -> 68303 bytes ...ainThreadDispatchTaskToConcurrentQueue.png | Bin 0 -> 240158 bytes .../2020-07-04-DataUploaderSDKStructure.png | Bin 0 -> 519832 bytes assets/2020-07-06-XcodeTestCoverage.png | Bin 0 -> 899412 bytes 12 files changed, 2743 insertions(+), 127 deletions(-) create mode 100644 Chapter1 - iOS/collection.md create mode 100644 assets/2020-06-29-DataUploadConfigurationStructure.png create mode 100644 assets/2020-07-01-MainThreadDispatchTaskToConcurrentQueue.png create mode 100644 assets/2020-07-04-DataUploaderSDKStructure.png create mode 100644 assets/2020-07-06-XcodeTestCoverage.png diff --git a/Chapter1 - iOS/1.55.md b/Chapter1 - iOS/1.55.md index 6339768..84c8e98 100644 --- a/Chapter1 - iOS/1.55.md +++ b/Chapter1 - iOS/1.55.md @@ -7,7 +7,17 @@ -## 0x01. 埋点手段 +## 前置说明 + +看到我在下面的代码段，有些命名风格、简写、分类、方法的命名等，我简单做个说明。 + +- 埋点 SDK 叫 `UserAnalysis`，我们规定类的命名一般用 SDK 的名字缩写，当前情况下缩写为 `UA` +- 给 Category 命名，规则为 `类名 + SDK 前缀缩写的小写格式 + 下划线 + 驼峰命名格式的功能描述`。比如给 NSDate 增加一个获取毫秒时间戳的分类，那么类名为 `NSDate+ua_TimeStamp` +- 给 Category 的方法命名，规则为 `SDK 前缀缩写的小写格式 + 下划线 + 驼峰命名格式的功能描述`。比如给 NSDate 增加一个根据当前时间获取毫秒时间戳的方法，那么方法名为 `+ (long long)ua_currentTimestamp;` + + + +## 一. 埋点手段 业界中对于代码埋点主要有3种主流的方案：代码手动埋点、可视化埋点、无痕埋点。简单说说这几种埋点方案。 @@ -17,7 +27,7 @@ -## 0x02. 技术选型 +## 二. 技术选型 @@ -39,11 +49,11 @@ **可视化埋点的出现，是为解决代码埋点流程复杂、成本高、新开发的页面（H5、或者服务端下发的 json 去生成相应页面）不能及时拥有埋点能力** - 前端在「埋点编辑模式」下，以“可视化”的方式去配置、绑定关键业务模块的路径到前端可以唯一确定到view的xpath过程。 + 前端在「埋点编辑模式」下，以“可视化”的方式去配置、绑定关键业务模块的路径到前端可以唯一确定到 view 的xpath 过程。 -用户每次操作的控件，都生成一个 **xpath** 字符串，然后通过接口将 xpath 字符串(view在前端系统中的唯一定位。以 iOS 为例，App名称、控制器名称、一层层view、同类型view的序号：“GoodCell.21.RetailTableView.GoodsViewController.*baoApp”)到真正的业务模块（“宝App-商城控制器-分销商品列表-第21个商品被点击了”）的映射关系上传到服务端。xpath 具体是什么在下文会有介绍。 +用户每次操作的控件，都生成一个 **xpath** 字符串，然后通过接口将 xpath 字符串(view在前端系统中的唯一定位。以 iOS 为例，App名称、控制器名称、一层层view、同类型view的序号：`GoodCell.21.RetailTableView.GoodsViewController.***App` 到真正的业务模块（“某App-商城控制器-分销商品列表-第21个商品被点击了”）的映射关系上传到服务端。xpath 具体是什么在下文会有介绍。 -之后操作 App 就生成对应的 xpath 和埋点数据（开发者通过技术手段将从服务端获取的关键数据塞到前端的 UI 控件上。 iOS 端为例， UIView 的 accessibilityIdentifier 属性可以设置我们从服务端获取的埋点数据）上传到服务端。 +之后操作 App 就生成对应的 xpath 和埋点数据（开发者通过技术手段将从服务端获取的关键数据塞到前端的 UI 控件上。 iOS 端为例， UIView 的 `accessibilityIdentifier` 属性可以设置我们从服务端获取的埋点数据）上传到服务端。 优点：数据量相对准确、后期数据分析成本低 @@ -67,13 +77,13 @@ 怎么说呢？对于关键的业务开发结束上线后、通过可视化方案（类似于一个界面，想想看 Dreamwaver，你在界面上拖拖控件，简单编辑下就可以生成对应的 HTML 代码）点击一下绑定对应关系到服务端。 -那么这个对应关系是什么？我们需要唯一定位一个前端元素，那么想到的办法就是不管 Native 和 Web 前端，控件或者元素来说就是一个树形层级，DOM tree 或者 UI tree，所以我们通过技术手段定位到这个元素，以 Native iOS 为例子，假如点击商品详情页的加入购物车按钮会根据 UI 层级结构生成一个唯一标识 “addCartButton.GoodsViewController.GoodsView.*BaoApp” 。但是用户在使用 App 的时候，上传的是这串东西的 MD5到服务端。 +那么这个对应关系是什么？我们需要唯一定位一个前端元素，那么想到的办法就是不管 Native 和 Web 前端，控件或者元素来说就是一个树形层级，DOM tree 或者 UI tree，所以我们通过技术手段定位到这个元素，以 Native iOS 为例子，假如点击商品详情页的加入购物车按钮会根据 UI 层级结构生成一个唯一标识 `addCartButton.GoodsViewController.GoodsView.*BaoApp`。但是用户在使用 App 的时候，上传的是这串东西的 MD5 到服务端。 这么做有2个原因：服务端数据库存储这串很长的东西不是很好；埋点数据被劫持的话直接看到明文不太好。所以 MD5 再上传。 -## 0x03. 操刀就干 +## 三. 操刀就干 一言以蔽之就是：**AOP -> Event Collector -> Event Cache -> Data Upload** - AOP：通过 runtime hook 的能力做到提供合适的时机去生成点击事件的数据 @@ -95,45 +105,26 @@ 以 iOS 为例。我们会想到 **AOP（Aspect Oriented Programming）**面向切面编程思想。动态地在函数调用前后插入相应的代码，在 Objective-C 中我们可以利用 Runtime 特性，用 **Method Swizzling** 来 hook 相应的函数 -为了给所有类方便地 hook，我们可以给 NSObject 添加个 Category，名字叫做 NSObject+MethodSwizzling +为了给所有类方便地 hook，我们可以给 NSObject 添加个 Category，名字叫做 `NSObject+u a_MethodSwizzling` ```objective-c #pragma mark - public Method -+ (void)lbp_swizzleMethod:(SEL)originalSelector swizzledSelector:(SEL)swizzledSelector ++ (void)ua_swizzleMethod:(SEL)originalSelector swizzledSelector:(SEL)swizzledSelector { - class_swizzleInstanceMethod(self, originalSelector, swizzledSelector); + ua_swizzleInstanceMethod(self, originalSelector, swizzledSelector); } -+ (void)lbp_swizzleClassMethod:(SEL)originalSelector swizzledSelector:(SEL)swizzledSelector ++ (void)ua_swizzleClassMethod:(SEL)originalSelector swizzledSelector:(SEL)swizzledSelector { //类方法实际上是储存在类对象的类(即元类)中，即类方法相当于元类的实例方法,所以只需要把元类传入，其他逻辑和交互实例方法一样。 Class class2 = object_getClass(self); - class_swizzleInstanceMethod(class2, originalSelector, swizzledSelector); + ua_swizzleInstanceMethod(class2, originalSelector, swizzledSelector); } #pragma mark - private method -void class_swizzleInstanceMethod(Class class, SEL originalSEL, SEL replacementSEL) +void ua_swizzleInstanceMethod(Class class, SEL originalSEL, SEL replacementSEL) { - /* - Class class = [self class]; - //原有方法 - Method originalMethod = class_getInstanceMethod(class, originalSelector); - //替换原有方法的新方法 - Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector); - //先尝试給源SEL添加IMP，这里是为了避免源SEL没有实现IMP的情况 - BOOL didAddMethod = class_addMethod(class,originalSelector, - method_getImplementation(swizzledMethod), - method_getTypeEncoding(swizzledMethod)); - if (didAddMethod) {//添加成功：表明源SEL没有实现IMP，将源SEL的IMP替换到交换SEL的IMP - class_replaceMethod(class,swizzledSelector, - method_getImplementation(originalMethod), - method_getTypeEncoding(originalMethod)); - } else {//添加失败：表明源SEL已经有IMP，直接将两个SEL的IMP交换即可 - method_exchangeImplementations(originalMethod, swizzledMethod); - } - */ - Method originMethod = class_getInstanceMethod(class, originalSEL); Method replaceMethod = class_getInstanceMethod(class, replacementSEL); @@ -166,10 +157,10 @@ void class_swizzleInstanceMethod(Class class, SEL originalSEL, SEL replacementSE ```objective-c -static char *lbp_viewController_open_time = "lbp_viewController_open_time"; -static char *lbp_viewController_close_time = "lbp_viewController_close_time"; +static char *ua_viewController_open_time = "ua_viewController_open_time"; +static char *ua_viewController_close_time = "ua_viewController_close_time"; -@implementation UIViewController (lbpka) +@implementation UIViewController (uaka) // load 方法里面添加 dispatch_once 是为了防止手动调用 load 方法。 + (void)load @@ -177,36 +168,16 @@ static char *lbp_viewController_close_time = "lbp_viewController_close_time"; static dispatch_once_t onceToken; dispatch_once(&onceToken, ^{ @autoreleasepool { - [[self class] lbp_swizzleMethod:@selector(viewWillAppear:) swizzledSelector:@selector(lbp_viewWillAppear:)]; - [[self class] lbp_swizzleMethod:@selector(viewWillDisappear:) swizzledSelector:@selector(lbp_viewWillDisappear:)]; + [[self class] ua_swizzleMethod:@selector(viewWillAppear:) swizzledSelector:@selector(ua_viewWillAppear:)]; + [[self class] ua_swizzleMethod:@selector(viewWillDisappear:) swizzledSelector:@selector(ua_viewWillDisappear:)]; } }); } -#pragma mark - add prop +#pragma mark - private method -- (void)setOpenTime:(NSDate *)openTime -{ - objc_setAssociatedObject(self,&lbp_viewController_open_time, openTime, OBJC_ASSOCIATION_RETAIN_NONATOMIC); -} - -- (NSDate *)getOpenTime -{ - return objc_getAssociatedObject(self, &lbp_viewController_open_time); -} - -- (void)setCloseTime:(NSDate *)closeTime -{ - objc_setAssociatedObject(self,&lbp_viewController_close_time, closeTime, OBJC_ASSOCIATION_RETAIN_NONATOMIC); -} - -- (NSDate *)getCloseTime -{ - return objc_getAssociatedObject(self, &lbp_viewController_close_time); -} - -- (void)lbp_viewWillAppear:(BOOL)animated +- (void)ua_viewWillAppear:(BOOL)animated { NSString *className = NSStringFromClass([self class]); NSString *refer = [NSString string]; @@ -227,21 +198,19 @@ static char *lbp_viewController_close_time = "lbp_viewController_close_time"; [UserTrackDataCenter openPage:[self getPageUrl:className] fromPage:refer]; } - [self lbp_viewWillAppear:animated]; + [self ua_viewWillAppear:animated]; } -- (void)lbp_viewWillDisappear:(BOOL)animated +- (void)ua_viewWillDisappear:(BOOL)animated { NSString *className = NSStringFromClass([self class]); if ([self getPageUrl:className]) { [self setCloseTime:[NSDate dateWithTimeIntervalSinceNow:0]]; [UserTrackDataCenter leavePage:[self getPageUrl:className] spendTime:[self p_calculationTimeSpend]]; } - [self lbp_viewWillDisappear:animated]; + [self ua_viewWillDisappear:animated]; } -#pragma mark - private method - - (NSString *)p_calculationTimeSpend { @@ -259,6 +228,30 @@ static char *lbp_viewController_close_time = "lbp_viewController_close_time"; return [NSString stringWithFormat:@"%d",second]; } + +#pragma mark - getter && setter + +- (void)setOpenTime:(NSDate *)openTime +{ + objc_setAssociatedObject(self,&ua_viewController_open_time, openTime, OBJC_ASSOCIATION_RETAIN_NONATOMIC); +} + +- (NSDate *)getOpenTime +{ + return objc_getAssociatedObject(self, &ua_viewController_open_time); +} + +- (void)setCloseTime:(NSDate *)closeTime +{ + objc_setAssociatedObject(self,&ua_viewController_close_time, closeTime, OBJC_ASSOCIATION_RETAIN_NONATOMIC); +} + +- (NSDate *)getCloseTime +{ + return objc_getAssociatedObject(self, &ua_viewController_close_time); +} + + @end ``` @@ -295,19 +288,17 @@ static char *lbp_viewController_close_time = "lbp_viewController_close_time"; ### 5. 同类型的 view 的唯一定位问题 -有个问题，比如我们点击的元素是 UITableViewCell，那么它虽然可以定位到类似于这个标示 xxApp.GoodsViewController.GoodsTableView.GoodsCell，同类型的 Cell 有多个，所以单凭借这个字符串是没有办法定位具体的那个 Cell 被点击了。 +有个问题，比如我们点击的元素是 UITableViewCell，那么它虽然可以定位到类似于这个标示 `xxApp.GoodsViewController.GoodsTableView.GoodsCell`，同类型的 Cell 有多个，所以单凭借这个字符串是没有办法定位具体的那个 Cell 被点击了。 当然有解决方案啦。 - 找出当前元素在父层同类型元素中的索引。根据当前的元素遍历当前元素的父级元素的子元素，如果出现相同的元素，则需要判断当前元素是所在层级的第几个元素 - 对当前的控件元素的父视图的全部子视图进行遍历，如果存在和当前的控件元素同类型的控件，那么需要判断当前控件元素在同类型控件元素中的所处的位置，那么则可以唯一定位。举例：GoodsCell-3.GoodsTableView.GoodsViewController.xxApp - - + 对当前的控件元素的父视图的全部子视图进行遍历，如果存在和当前的控件元素同类型的控件，那么需要判断当前控件元素在同类型控件元素中的所处的位置，那么则可以唯一定位。举例：`GoodsCell-3.GoodsTableView.GoodsViewController.xxApp` ```Objective-c - //UIResponder分类 - - (NSString *)lbp_identifierKa +//UIResponder分类 + - (NSString *)ua_identifierKa { // if (self.xq_identifier_ka == nil) { if ([self isKindOfClass:[UIView class]]) { @@ -316,7 +307,7 @@ static char *lbp_viewController_close_time = "lbp_viewController_close_time"; NSMutableString *str = [NSMutableString string]; //特殊的 加减购 因为带有spm但是要区分加减 需要带TreeNode NSString *className = [NSString stringWithUTF8String:object_getClassName(view)]; - if (!view.accessibilityIdentifier || [className isEqualToString:@"lbpButton"]) { + if (!view.accessibilityIdentifier || [className isEqualToString:@"uaButton"]) { [str appendString:sameViewTreeNode]; [str appendString:@","]; } @@ -382,7 +373,7 @@ static char *lbp_viewController_close_time = "lbp_viewController_close_time"; } ``` - + ![页面唯一标识示意图](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2019-04-09-UserTrack.png) @@ -391,7 +382,9 @@ static char *lbp_viewController_close_time = "lbp_viewController_close_time"; ### 6. 同类型的view，但是点击的意义却不一样。如何唯一标识？ -问题5说明的是在一个界面上有多个不同的 view，他们的类型是同一种（CycleBannerView，但是数据源不一样，那么当数据源长度大于1的时候会轮播，下面会展示 UIPageControl。如果数据源是1个，那么就不会轮播和展示 UIPageControl）。情况6是同一种类型的 View，但是根据展示的内容不一样，点击的意义也不一样。也就是运营需要去知道用户到底点击的是哪一个。如下图所示，「立即抢购」和「分享赚佣金」是同一种类型的 View，但是点击意义不一样，需要我们需要唯一标识出来。之前的方法通过 **“viewPath 配合同类型的 view 去加索引值“** 的方式还是没有办法唯一标识出来。所以想到一个方案，给 NSObject 添加一个分类，在分类里面添加一个协议。让需要复用但需要唯一标识的 view 去实现协议方法，因为是给 NSObject 分类添加的协议，所以 view 不需要去指定遵循。 +问题5说明的是在一个界面上有多个不同的 view，他们的类型是同一种（`CycleBannerView`，但是数据源不一样，那么当数据源长度大于1的时候会轮播，下面会展示 `UIPageControl`。如果数据源是1个，那么就不会轮播和展示 `UIPageControl`）。 + +情况6是同一种类型的 View，但是根据展示的内容不一样，点击的意义也不一样。也就是运营需要去知道用户到底点击的是哪一个。如下图所示，「立即抢购」和「分享赚佣金」是同一种类型的 View，但是点击意义不一样，需要我们需要唯一标识出来。之前的方法通过 **「viewPath 配合同类型的 view 去加索引值」** 的方式还是没有办法唯一标识出来。所以想到一个方案，给 NSObject 添加一个分类，在分类里面添加一个协议。让需要复用但需要唯一标识的 view 去实现协议方法，因为是给 NSObject 分类添加的协议，所以 view 不需要去指定遵循。 !["立即抢购"、"分享赚佣金"同类型view，但点击意义不一样](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2019-04-11-UserTrack01.png) @@ -406,7 +399,7 @@ static char *lbp_viewController_close_time = "lbp_viewController_close_time"; ```objective-c -//NSObject+UniqueIdentify.h +//NSObject+uaUniqueIdentify.h #import NS_ASSUME_NONNULL_BEGIN @@ -425,8 +418,8 @@ NS_ASSUME_NONNULL_BEGIN NS_ASSUME_NONNULL_END -//NSObject+UniqueIdentify.m -#import "NSObject+UniqueIdentify.h" +//NSObject+ua_UniqueIdentify.m +#import "NSObject+ua_UniqueIdentify.h" @implementation NSObject (UniqueIdentify) @@ -459,7 +452,7 @@ NSString *const ShareToAward = @"分享赚佣金"; ```objective-c //UIResponder Category 生成 viewPath -- (NSString *)lbp_identifierKa +- (NSString *)ua_identifierKa { // if (self.xq_identifier_ka == nil) { if ([self isKindOfClass:[UIView class]]) { @@ -468,7 +461,7 @@ NSString *const ShareToAward = @"分享赚佣金"; NSMutableString *str = [NSMutableString string]; //特殊的 加减购 因为带有spm但是要区分加减 需要带TreeNode NSString *className = [NSString stringWithUTF8String:object_getClassName(view)]; - if (!view.accessibilityIdentifier || [className isEqualToString:@"lbpButton"]) { + if (!view.accessibilityIdentifier || [className isEqualToString:@"uaButton"]) { [str appendString:sameViewTreeNode]; [str appendString:@","]; } @@ -499,9 +492,13 @@ NSString *const ShareToAward = @"分享赚佣金"; -### 7. 疑惑点 +### 7. 特殊 case -根据在同一个 view 上会有多个 subview，那么生成的 xpath 会携带在同类型 views 中的索引，所以一个登录、注册按钮的 xpath 可能为 ...btn1、...btn2。那么在版本A上线后运行了一段时间，上传并统计了数据。过了一段时间版本迭代，UI 搞事情，把登录和注册按钮的位置欢乐，变成了注册、登录。按照之前的逻辑生成的 xpath 为 ...btn1、...btn2。那么新的 xpath 虽然唯一，但是点击产生的数据会和之前的埋点数据意义不一样。别怕，你忘了还有一步绑定的逻辑。绑定的这一步会把每次开发的功能，通过可视化界面去将 xpath 和功能名称绑定一下。看下面的动图。所以不用担心虽然生成了唯一的 xpath，但是 App 在不同版本之间 UI 控件位置更换造成之前的统计数据在分析的时候不准确的问题。因为在绑定的时候就将新的 xpath 和功能名称进行了绑定，接口携带版本号。所以分析的时候注意版本号就好了。sql 一句话的事情。 +根据在同一个 view 上会有多个 subview，那么生成的 xpath 会携带在同类型 views 中的索引，所以一个登录、注册按钮的 xpath 可能为 `btn1.LoginView.LoginViewController.*baoApp`、`bt21.LoginView.LoginViewController.*baoApp`。 + +问题来了，当版本 A 上线后运行了一段时间，上传并统计了数据。但是过了一段时间版本迭代，UI 为了 KPI 搞事情，把登录和注册按钮的位置换了一下，变成了注册、登录。按照之前的逻辑生成的 xpath 还是 `btn1.LoginView.LoginViewController.*baoApp`、`bt21.LoginView.LoginViewController.*baoApp`。那么新的 xpath 虽然唯一，但是点击产生的数据会和之前的埋点数据意义不一样。别怕，你忘了还有一步绑定的逻辑。可视化绑定这个步骤会把每次开发的功能，通过可视化界面去将 `xpath` 和功能模块名称绑定一下。 + +看下面的动图。所以不用担心虽然生成了唯一的 `xpath`，但是 App 在不同版本之间 UI 控件位置更换造成之前的统计数据在分析的时候不准确的问题。因为在绑定的时候就将新的 `xpath` 和功能名称进行了绑定，接口携带版本号。所以分析的时候注意版本号就好了。sql 一句话的事情。 @@ -509,24 +506,22 @@ NSString *const ShareToAward = @"分享赚佣金"; + + ### 8. 数据如何处理 -#### A. 如何处理业务数据 - -利用系统提供的 **accessibilityIdentifier** 官方给出的解释是标识用户界面元素的字符串 - -> */** -> -> *A string that identifies the user interface element.* -> -> *default == nil* -> -> **/* -> -> **@property**(**nullable**, **nonatomic**, **copy**) NSString *accessibilityIdentifier NS_AVAILABLE_IOS(5_0); +#### 1. 如何处理业务数据 +利用系统提供的 `accessibilityIdentifier` 官方给出的解释是标识用户界面元素的字符串 +```objective-c +/* + A string that identifies the user interface element. + default == nil +*/ +@property(nullable, nonatomic, copy) NSString *accessibilityIdentifier API_AVAILABLE(ios(5.0)); +``` 服务端下发唯一标识 @@ -538,11 +533,11 @@ cell.accessibilityIdentifier = [[[SDGGoodsCategoryServices sharedInstance].categ -#### B. 基础数据 +#### 2. 基础数据 -设计上分为2个 pod 库，一个是 TriggerKit（专门用来 hook 机会需要的所有事件，页面停留时间、页面标识、view标识），另一个是 Appmonitor（专门用来提供基础数据、埋点数据的维护、上传机制）。所以在 Appmonitor 里面有个类叫做 UserTrackDataCenter 的类，专门提供一些基础数据（系统版本、操作系统、地理位置、网络等信息）。 +设计上分为2个 pod 库，一个是 `UserAnalysis`（专门用来 hook 机会需要的所有事件，页面停留时间、页面标识、view标识），另一个是 AppMonitor（专门用来提供基础数据、埋点数据的维护、上传机制）。所以在 AppMonitor 里面有个类叫做 UserTrackDataCenter 的类，专门提供一些基础数据（系统版本、操作系统、地理位置、网络等信息）。 -对外暴露出一些方法，用来将埋点数据交给 Appmonitor 去维护埋点数据，达到合适的“机制”再去上传埋点数据到服务端。 +对外暴露出一些方法，用来将埋点数据交给 AppMonitor 去维护埋点数据，达到合适的“机制”再去上传埋点数据到服务端。 ```objective-c + (void)clickEventUuid:(NSString *)uuid otherParam:(NSDictionary *)otherParam spmContent:(NSDictionary *)spmContent @@ -562,11 +557,9 @@ cell.accessibilityIdentifier = [[[SDGGoodsCategoryServices sharedInstance].categ ### 9. 曝光时间的统计 - - 曝光的意义是什么？ -我们的产品中可能有合作伙伴的广告，我们需要收取服务费。那如何计价？CPM（cost per Mille）每千人成本、CPC（cost per click）每点击成本、CPA（cost per action）每行动成本，根据这些指标来计算价格。或者自己的产品中运营人员在商城中投放了一次新的活动，为了这次活动在某个钻石展位放了设计人员精心设计的炫酷 Banner。这次活动后运营人员想分析在这个图片的作用下有多少人点击了这个活动页。 +我们的产品中可能有合作伙伴的广告，我们需要收取服务费。那如何计价？`CPM`（cost per Mille）每千人成本、`CPC`（cost per click）每点击成本、`CPA`（cost per action）每行动成本，根据这些指标来计算价格。或者自己的产品中运营人员在商城中投放了一次新的活动，为了这次活动在某个钻石展位放了设计人员精心设计的炫酷 Banner。这次活动后运营人员想分析在这个图片的作用下有多少人点击了这个活动页。 @@ -576,7 +569,7 @@ cell.accessibilityIdentifier = [[[SDGGoodsCategoryServices sharedInstance].categ -#### A. 有效曝光的判断 +#### 1. 有效曝光的判断 显示在屏幕可见区域如何判断？一个 View 显示在屏幕可见区域内，那么它肯定是经过从未初始化到初始化，再到设置 Frame 或者 Bounds 或者 Alpha 或者 Hidden 的。且它的根 view 一定是 UIWindow 对象。所以上面这句话进行分析整理就是下面的条件 @@ -584,7 +577,7 @@ cell.accessibilityIdentifier = [[[SDGGoodsCategoryServices sharedInstance].categ - alpha 小于 0.1 或者 hidden 为 YES - 根视图为 window -对于上面的三点可以用 AOP 进行判断。 hook 掉相应的方法，然后处理判断是否在可见区域内显示。最后的一个点经过一番查找，看到了一个 api `didMoveToWindow` ，根据它可以判断 view 是否显示到屏幕中（文档中说明：当它的 window 对象发送改变的时候会调用 view 的 didMoveToWindow 方法）。 +对于上面的三点可以用 AOP 进行判断。 hook 掉相应的方法，然后处理判断是否在可见区域内显示。最后的一个点经过一番查找，看到了一个 api `- (void)didMoveToWindow;` ，根据它可以判断 view 是否显示到屏幕中（文档中说明：当它的 window 对象发送改变的时候会调用 view 的 `didMoveToWindow` 方法）。 ``` Tells the view that its window object changed. @@ -596,7 +589,7 @@ The window property may be nil by the time that this method is called, indicatin -#### B. 曝光代码的执行效率优化 +#### 2. 曝光代码的执行效率优化 设想一下，某个复杂的页面可能是一个大的 UIViewController 顶部是店铺的基本信息，下面是 2个 UIViewController：左侧负责展示商品的一级、二级、三级分类，且负责选中和未选中的 UI 效果；右侧负责展示商品信息（顶部有商品的排序查找 ，下面是商品展示的 UICollectionView）。由于页面结构复杂，UI 层级嵌套严重，所以代码层面不注意的话，页面上计算量会比较大，CPU 负荷严重，直接影响着手机的 `耗电量`。改进的手段是在合适的地方提前 return 掉（比如 hidden 等于 YES 或者 aplha 小于 0.1 的时候）。 @@ -620,17 +613,15 @@ iOS 11 以下 UITableViewWrapperView 大小为屏幕中第一个完整的屏幕 + + ### 10. 数据的上报 - - 数据通过上面的办法收集完了，那么如何及时、高效的上传到后端，给运营分析、处理呢？ App 运行期间用户会点击非常多的数据，如果实时上传的话对于网络的利用率较低，所以需要考虑一个机制去控制用户产生的埋点数据的上传。 - - -思路是这样的。对外部暴露出一个接口，用来将产生的数据往数据中心存储。用户产生的数据会先保存到 AppMonitor 的内存中去，设置一个临界值（memoryEventMax = 50），如果存储的值达到设置的临界值 memoryEventMax，那么将内存中的数据写入文件系统，以 zip 的形式保存下来，然后上传到埋点系统。如果没有达到临界值但是存在一些 App 状态切换的情况，这时候需要及时保存数据到持久化。当下次打开 App 就去从本地持久化的地方读取是否有未上传的数据，如果有就上传日志信息，成功后删除本地的日志压缩包。 +思路是这样的。对外部暴露出一个接口，用来将产生的数据往数据中心存储。用户产生的数据会先保存到 `AppMonitor` 的内存中去，设置一个临界值（memoryEventMax = 50），如果存储的值达到设置的临界值 memoryEventMax，那么将内存中的数据写入文件系统，以 zip 的形式保存下来，然后上传到埋点系统。如果没有达到临界值但是存在一些 App 状态切换的情况，这时候需要及时保存数据到持久化。当下次打开 App 就去从本地持久化的地方读取是否有未上传的数据，如果有就上传日志信息，成功后删除本地的日志压缩包。 App 应用状态的切换策略如下： @@ -722,6 +713,12 @@ App 应用状态的切换策略如下： } ``` +其实 App 内部的数据上报有很多场景，比如 [APM 监控](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.74.md) 数据的上报、埋点数据的上报、业务线的数据上报等等，所以可以设计为[一个通用、可配置的数据上报 SDK](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md)。 + + + +### 11. 总结 + 使用的时候就是在 hook 系统事件的时候，去调用统计页面上传数据 ```objective-c @@ -736,31 +733,29 @@ App 应用状态的切换策略如下： 总结下来关键步骤： 1. hook 系统的各种事件（UIResponder、UITableView、UICollectionView代理事件、UIControl事件、UITapGestureRecognizers）、hook 应用程序、控制器生命周期。在做本来的逻辑之前添加额外的监控代码 -2. 对于点击的元素按照视图树生成对应的唯一标识（addCartButton.GoodsView.GoodsViewController） 的 md5 值 -3. 在业务开发完毕，进入埋点的编辑模式，将 md5 和关键的页面的关键事件（运营、产品想统计的关键模块：App层级、业务模块、关键页面、关键操作）给绑定起来。比如 addCartButton.GoodsView.GoodsViewController.tbApp 对应了 tbApp-商城模块-商品详情页-加入购物车功能。 +2. 对于点击的元素按照视图树生成对应的唯一标识 `addCartButton.GoodsView.GoodsViewController.**App` 的 md5 值 +3. 在业务开发完毕，进入埋点的编辑模式，将 md5 和关键的页面的关键事件（运营、产品想统计的关键模块：App层级、业务模块、关键页面、关键操作）给绑定起来。比如 `addCartButton.GoodsView.GoodsViewController.**App` 对应了 `**App-商城模块-商品详情页-加入购物车功能`。 4. 将所需要的数据存储下来 5. 设计机制等到合适的时机去上传数据 +## 四. 演示一个完整的埋点上报流程 - -## 举例说明一个完整的埋点上报流程 - -埋伏模块分为2个pod组件库，TriggerKit 负责拦截系统事件，拿到埋点数据。Appmonitor 负责收集埋点数据，本地持久化或内存储存，等到合适时机去上传埋点数据。 +埋伏模块分为2个pod组件库，`UserAnalysis` 负责拦截系统事件，拿到埋点数据。`AppMonitor` 负责收集埋点数据，本地持久化或内存储存，等到合适时机去上传埋点数据。 -1. 通过接口获取数据，给对应的 view 的 accessibilityIdentifier 属性绑定埋点数据 +1. 通过接口获取数据，给对应的 view 的 `accessibilityIdentifier` 属性绑定埋点数据 ![接口拿到的数据](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2019-04-05-userTrack1.png) ![绑定埋点数据到view](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2019-04-05-userTrack2.png) -2. hook 系统事件，点击拿到 view，获取 accessibilityIdentifier 属性值 +2. hook 系统事件，点击拿到 view，获取 `accessibilityIdentifier` 属性值 ![hook系统事件获取accessibilityIdentifier](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2019-04-05-userTrack3.png) -3. 将数据向的数据中心发送，数据中心处理数据（埋点数据结合App基础信息，图上 UserTrackDataCenter 对象）。根据情况将数据存储到内存或者本地，等到合适的时机去上传 +3. 将数据向的数据中心发送，数据中心处理数据（埋点数据结合App基础信息，图上 `UserTrackDataCenter` 对象）。根据情况将数据存储到内存或者本地，等到合适的时机去上传 ![拦截系统事件后将数据交给数据中心处理](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2019-04-05-userTrack4.png) \ No newline at end of file diff --git a/Chapter1 - iOS/1.74.md b/Chapter1 - iOS/1.74.md index 01b139d..b6a0f3a 100644 --- a/Chapter1 - iOS/1.74.md +++ b/Chapter1 - iOS/1.74.md @@ -365,7 +365,7 @@ dispatch_async(dispatch_get_global_queue(0, 0), ^{ #### 3.2 子线程 ping 主线程监听的方式 -开启一个子线程，创建一个初始值为0的信号量、一个初始值为 YES 的布尔值类型标志位。将设置标志位为 NO 的任务派发到主线程中去，子线程休眠阈值时间，时间到后判断标志位是否被主线程成功（值为 NO），如果没成功则认为猪线程发生了卡顿情况，此时 dump 堆栈信息并结合数据上报机制，按照一定策略上传数据到服务器。数据上报会在 [打造功能强大、灵活可配置的数据上报组件](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md) 讲 +开启一个子线程，创建一个初始值为0的信号量、一个初始值为 YES 的布尔值类型标志位。将设置标志位为 NO 的任务派发到主线程中去，子线程休眠阈值时间，时间到后判断标志位是否被主线程成功（值为 NO），如果没成功则认为主线程发生了卡顿情况，此时 dump 堆栈信息并结合数据上报机制，按照一定策略上传数据到服务器。数据上报会在 [打造功能强大、灵活可配置的数据上报组件](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md) 讲 ```Objective-c while (self.isCancelled == NO) { @@ -6578,3 +6578,5 @@ Crash log 统一入库 Kibana 时是没有符号化的，所以需要符号化 - [MDN-HTTP Messages](https://developer.mozilla.org/en-US/docs/Web/HTTP/Messages) - [DWARF 和符号化](https://junyixie.github.io/2018/09/30/dwarf和符号化/) + + diff --git a/Chapter1 - iOS/1.80.md b/Chapter1 - iOS/1.80.md index cf6eb49..e98ec44 100644 --- a/Chapter1 - iOS/1.80.md +++ b/Chapter1 - iOS/1.80.md @@ -1,5 +1,2488 @@ -# 打造一个通用、可配置的数据上报 SDK +# 打造一个通用、可配置、多句柄的数据上报 SDK + +> 一个 App 一般会存在很多场景去上传 App 中产生的数据，比如 APM、埋点统计、开发者自定义的数据等等。所以本篇文章就讲讲如何设计一个通用的、可配置的、多句柄的数据上报 SDK。 +> + + + +## 前置说明 + +因为这篇文章和 APM 是属于姊妹篇，所以看这篇文章的时候有些东西不知道活着好奇的时候可以看[带你打造一套 APM 监控系统](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.74.md)。 + +另外看到我在下面的代码段，有些命名风格、简写、分类、方法的命名等，我简单做个说明。 + +- 数据上报 SDK 叫 `PrismClient`，我们规定类的命名一般用 SDK 的名字缩写，当前情况下缩写为 `PCT` +- 给 Category 命名，规则为 `类名 + SDK 前缀缩写的小写格式 + 下划线 + 驼峰命名格式的功能描述`。比如给 NSDate 增加一个获取毫秒时间戳的分类，那么类名为 `NSDate+pct_TimeStamp` +- 给 Category 的方法命名，规则为 `SDK 前缀缩写的小写格式 + 下划线 + 驼峰命名格式的功能描述`。比如给 NSDate 增加一个根据当前时间获取毫秒时间戳的方法，那么方法名为 `+ (long long)pct_currentTimestamp;` + + + +## 一、 首先定义需要做什么 + +我们要做的是「一个通用可配置、多句柄的数据上报 SDK」，也就是说这个 SDK 具有这么几个功能： + +- 具有从服务端拉取配置信息的能力，这些配置用来控制 SDK 的上报行为（需不需要默认行为？） +- SDK 具有多句柄特性，也就是拥有多个对象，每个对象具有自己的控制行为，彼此之间的运行、操作互相隔离 +- APM 监控作为非常特殊的能力存在，它也使用数据上报 SDK。它的能力是 App 质量监控的保障，所以针对 APM 的数据上报通道是需要特殊处理的。 +- 数据先根据配置决定要不要存，存下来之后再根据配置决定如何上报 + +明白我们需要做什么，接下来的步骤就是分析设计怎么做。 + + + +## 二、 拉取配置信息 + +### 1. 需要哪些配置信息 + +首先明确几个原则： + +- 因为监控数据上报作为数据上报的一个特殊 case，那么监控的配置信息也应该特殊处理。 +- 监控能力包含很多，比如卡顿、网络、奔溃、内存、电量、启动时间、CPU 使用率。每个监控能力都需要一份配置信息，比如监控类型、是否仅 WI-FI 环境下上报、是否实时上报、是否需要携带 Payload 数据。（注：Payload 其实就是经过 gZip 压缩、AES-CBC 加密后的数据） +- 多句柄，所以需要一个字段标识每份配置信息，也就是一个 namespace 的概念 +- 每个 namespace 下都有自己的配置，比如数据上传后的服务器地址、上报开关、App 升级后是否需要清除掉之前版本保存的数据、单次上传数据包的最大体积限制、数据记录的最大条数、在非 WI-FI 环境下每天上报的最大流量、数据过期天数、上报开关等 +- 针对 APM 的数据配置，还需要一个是否需要采集的开关。 + +所以数据字段基本如下 + +```objective-c +@interface PCTItemModel : NSObject + +@property (nonatomic, copy) NSString *type; /<上报数据类型*/ +@property (nonatomic, assign) BOOL onlyWifi; /<是否仅 Wi-Fi 上报*/ +@property (nonatomic, assign) BOOL isRealtime; /<是否实时上报*/ +@property (nonatomic, assign) BOOL isUploadPayload; /<是否需要上报 Payload*/ + +@end + +@interface PCTConfigurationModel : NSObject + +@property (nonatomic, copy) NSString *url; /<当前 namespace 对应的上报地址 */ +@property (nonatomic, assign) BOOL isUpload; /<全局上报开关*/ +@property (nonatomic, assign) BOOL isGather; /<全局采集开关*/ +@property (nonatomic, assign) BOOL isUpdateClear; /<升级后是否清除数据*/ +@property (nonatomic, assign) NSInteger maxBodyMByte; /<最大包体积单位 M (范围 < 3M)*/ +@property (nonatomic, assign) NSInteger periodicTimerSecond; /<定时上报时间单位秒 (范围1 ~ 30秒)*/ +@property (nonatomic, assign) NSInteger maxItem; /<最大条数 (范围 < 100)*/ +@property (nonatomic, assign) NSInteger maxFlowMByte; /<每天最大非 Wi-Fi 上传流量单位 M (范围 < 100M)*/ +@property (nonatomic, assign) NSInteger expirationDay; /<数据过期时间单位 天 (范围 < 30)*/ +@property (nonatomic, copy) NSArray *monitorList; /<配置项目*/ + +@end +``` + +因为数据需要持久化保存，所以需要实现 `NSCoding` 协议。 + +一个小窍门，每个属性写 `encode`、`decode` 会很麻烦，可以借助于宏来实现快速编写。 + +```objective-c +#define PCT_DECODE(decoder, dataType, keyName) \ +{ \ +_##keyName = [decoder decode##dataType##ForKey:NSStringFromSelector(@selector(keyName))]; \ +}; + +#define PCT_ENCODE(aCoder, dataType, key) \ +{ \ +[aCoder encode##dataType:_##key forKey:NSStringFromSelector(@selector(key))]; \ +}; + +- (instancetype)initWithCoder:(NSCoder *)aDecoder { + if (self = [super init]) { + PCT_DECODE(aDecoder, Object, type) + PCT_DECODE(aDecoder, Bool, onlyWifi) + PCT_DECODE(aDecoder, Bool, isRealtime) + PCT_DECODE(aDecoder, Bool, isUploadPayload) + } + return self; +} + +- (void)encodeWithCoder:(NSCoder *)aCoder { + PCT_ENCODE(aCoder, Object, type) + PCT_ENCODE(aCoder, Bool, onlyWifi) + PCT_ENCODE(aCoder, Bool, isRealtime) + PCT_ENCODE(aCoder, Bool, isUploadPayload) +} +``` + + + + + +抛出一个问题：既然监控很重要，那别要配置了，直接全部上传。 + +我们想一想这个问题，监控数据都是不直接上传的，监控 SDK 的责任就是收集监控数据，而且监控后的数据非常多，App 运行期间的网络请求可能都有 n 次，App 启动时间、卡顿、奔溃、内存等可能不多，但是这些数据直接上传后期拓展性非常差，比如根据 APM 监控大盘分析出某个监控能力暂时先关闭掉。这时候就无力回天了，必须等下次 SDK 发布新版本。监控数据必须先存储，假如 crash 了，则必须保存了数据等下次启动再去组装数据、上传。而且数据在消费、新数据在不断生产，假如上传失败了还需要对失败数据的处理，所以这些逻辑还是挺多的，对于监控 SDK 来做这个事情，不是很合适。答案就显而易见了，必须要配置（监控开关的配置、数据上报的行为配置）。 + + + +### 2. 默认配置 + +因为监控真的很特殊，App 一启动就需要去收集 App 的性能、质量相关数据，所以需要一份默认的配置信息。 + +```objective-c +// 初始化一份默认配置 +- (void)setDefaultConfigurationModel { + PCTConfigurationModel *configurationModel = [[PCTConfigurationModel alloc] init]; + configurationModel.url = @"https://.com"; + configurationModel.isUpload = YES; + configurationModel.isGather = YES; + configurationModel.isUpdateClear = YES; + configurationModel.periodicTimerSecond = 5; + configurationModel.maxBodyMByte = 1; + configurationModel.maxItem = 100; + configurationModel.maxFlowMByte = 20; + configurationModel.expirationDay = 15; + + PCTItemModel *appCrashItem = [[PCTItemModel alloc] init]; + appCrashItem.type = @"appCrash"; + appCrashItem.onlyWifi = NO; + appCrashItem.isRealtime = YES; + appCrashItem.isUploadPayload = YES; + + PCTItemModel *appLagItem = [[PCTItemModel alloc] init]; + appLagItem.type = @"appLag"; + appLagItem.onlyWifi = NO; + appLagItem.isRealtime = NO; + appLagItem.isUploadPayload = NO; + + PCTItemModel *appBootItem = [[PCTItemModel alloc] init]; + appBootItem.type = @"appBoot"; + appBootItem.onlyWifi = NO; + appBootItem.isRealtime = NO; + appBootItem.isUploadPayload = NO; + + PCTItemModel *netItem = [[PCTItemModel alloc] init]; + netItem.type = @"net"; + netItem.onlyWifi = NO; + netItem.isRealtime = NO; + netItem.isUploadPayload = NO; + + PCTItemModel *netErrorItem = [[PCTItemModel alloc] init]; + netErrorItem.type = @"netError"; + netErrorItem.onlyWifi = NO; + netErrorItem.isRealtime = NO; + netErrorItem.isUploadPayload = NO; + configurationModel.monitorList = @[appCrashItem, appLagItem, appBootItem, netItem, netErrorItem]; + self.configurationModel = configurationModel; +} +``` + +上面的例子是一份默认配置信息 + + + +### 3. 拉取策略 + +网络拉取使用了基础 SDK （非网络 SDK）的能力 mGet，根据 key 注册网络服务。这些 key 一般是 SDK 内部的定义好的，比如统跳路由表等。 + +这类 key 的共性是 App 在打包阶段会内置一份默认配置，App 启动后会去拉取最新数据，然后完成数据的缓存，缓存会在 `NSDocumentDirectory` 目录下按照 SDK 名称、 App 版本号、打包平台上分配的打包任务 id、 key 建立缓存文件夹。 + +此外它的特点是等 App 启动完成后才去请求网络，获取数据，不会影响 App 的启动。 + +流程图如下 + +![数据上报配置信息获取流程](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2020-06-29-DataUploadConfigurationStructure.png) + +下面是一个截取代码，对比上面图看看。 + +```objective-c +@synthesize configurationDictionary = _configurationDictionary; + +#pragma mark - Initial Methods + ++ (instancetype)sharedInstance { + static PCTConfigurationService *_sharedInstance = nil; + static dispatch_once_t onceToken; + dispatch_once(&onceToken, ^{ + _sharedInstance = [[self alloc] init]; + }); + return _sharedInstance; +} + +- (instancetype)init { + if (self = [super init]) { + [self setUp]; + } + return self; +} + +#pragma mark - public Method + +- (void)registerAndFetchConfigurationInfo { + __weak typeof(self) weakself = self; + NSDictionary *params = @{@"deviceId": [[PrismClient sharedInstance] getCommon].SYS_DEVICE_ID}; + + [self.requester fetchUploadConfigurationWithParams:params success:^(NSDictionary * _Nonnull configurationDictionary) { + weakself.configurationDictionary = configurationDictionary; + [NSKeyedArchiver archiveRootObject:configurationDictionary toFile:[self savedFilePath]]; + } failure:^(NSError * _Nonnull error) { + + }]; +} + +- (PCTConfigurationModel *)getConfigurationWithNamespace:(NSString *)namespace { + if (!PCT_IS_CLASS(namespace, NSString)) { + NSAssert(PCT_IS_CLASS(namespace, NSString), @"需要根据 namespace 参数获取对应的配置信息,所以必须是 NSString 类型"); + return nil; + } + if (namespace.length == 0) { + NSAssert(namespace.length > 0, @"需要根据 namespace 参数获取对应的配置信息,所以必须是非空的 NSString"); + return nil; + } + id configurationData = [self.configurationDictionary objectForKey:namespace]; + if (!configurationData) { + return nil; + } + if (!PCT_IS_CLASS(configurationData, NSDictionary)) { + return nil; + } + NSDictionary *configurationDictionary = (NSDictionary *)configurationData; + return [PCTConfigurationModel modelWithDictionary:configurationDictionary]; +} + + +#pragma mark - private method + +- (void)setUp { + // 创建数据保存的文件夹 + [[NSFileManager defaultManager] createDirectoryAtPath:[self configurationDataFilePath] withIntermediateDirectories:YES attributes:nil error:nil]; + [self setDefaultConfigurationModel]; + [self getConfigurationModelFromLocal]; +} + +- (NSString *)savedFilePath { + return [NSString stringWithFormat:@"%@/%@", [self configurationDataFilePath], PCT_CONFIGURATION_FILEPATH]; +} + +// 初始化一份默认配置 +- (void)setDefaultConfigurationModel { + PCTConfigurationModel *configurationModel = [[PCTConfigurationModel alloc] init]; + configurationModel.url = @"https://.com"; + configurationModel.isUpload = YES; + configurationModel.isGather = YES; + configurationModel.isUpdateClear = YES; + configurationModel.periodicTimerSecond = 5; + configurationModel.maxBodyMByte = 1; + configurationModel.maxItem = 100; + configurationModel.maxFlowMByte = 20; + configurationModel.expirationDay = 15; + + PCTItemModel *appCrashItem = [[PCTItemModel alloc] init]; + appCrashItem.type = @"appCrash"; + appCrashItem.onlyWifi = NO; + appCrashItem.isRealtime = YES; + appCrashItem.isUploadPayload = YES; + + PCTItemModel *appLagItem = [[PCTItemModel alloc] init]; + appLagItem.type = @"appLag"; + appLagItem.onlyWifi = NO; + appLagItem.isRealtime = NO; + appLagItem.isUploadPayload = NO; + + PCTItemModel *appBootItem = [[PCTItemModel alloc] init]; + appBootItem.type = @"appBoot"; + appBootItem.onlyWifi = NO; + appBootItem.isRealtime = NO; + appBootItem.isUploadPayload = NO; + + PCTItemModel *netItem = [[PCTItemModel alloc] init]; + netItem.type = @"net"; + netItem.onlyWifi = NO; + netItem.isRealtime = NO; + netItem.isUploadPayload = NO; + + PCTItemModel *netErrorItem = [[PCTItemModel alloc] init]; + netErrorItem.type = @"netError"; + netErrorItem.onlyWifi = NO; + netErrorItem.isRealtime = NO; + netErrorItem.isUploadPayload = NO; + configurationModel.monitorList = @[appCrashItem, appLagItem, appBootItem, netItem, netErrorItem]; + self.configurationModel = configurationModel; +} + +- (void)getConfigurationModelFromLocal { + id unarchiveObject = [NSKeyedUnarchiver unarchiveObjectWithFile:[self savedFilePath]]; + if (unarchiveObject) { + if (PCT_IS_CLASS(unarchiveObject, NSDictionary)) { + self.configurationDictionary = (NSDictionary *)unarchiveObject; + [self.configurationDictionary enumerateKeysAndObjectsUsingBlock:^(id _Nonnull key, id _Nonnull obj, BOOL * _Nonnull stop) { + if ([key isEqualToString:PRISMNAMESPACE]) { + if (PCT_IS_CLASS(obj, NSDictionary)) { + NSDictionary *configurationDictionary = (NSDictionary *)obj; + self.configurationModel = [PCTConfigurationModel modelWithDictionary:configurationDictionary]; + } + } + }]; + } + } +} + + +#pragma mark - getters and setters + +- (NSString *)configurationDataFilePath { + NSString *filePath = [NSString stringWithFormat:@"%@/%@/%@/%@", NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject, @"prism", [CMAppProfile sharedInstance].mAppVersion, [[PrismClient sharedInstance] getCommon].WAX_CANDLE_TASK_ID]; + return filePath; +} + +- (PCTRequestFactory *)requester { + if (!_requester) { + _requester = [[PCTRequestFactory alloc] init]; + } + return _requester; +} + +- (void)setConfigurationDictionary:(NSDictionary *)configurationDictionary +{ + @synchronized (self) { + _configurationDictionary = configurationDictionary; + } +} + +- (NSDictionary *)configurationDictionary +{ + @synchronized (self) { + if (_configurationDictionary == nil) { + NSDictionary *prismDictionary = [self.configurationModel getDictionary]; + _configurationDictionary = @{PRISMNAMESPACE: prismDictionary}; + } + return _configurationDictionary; + } +} + +@end +``` + + + +## 三、数据存储 + +### 1. 数据存储技术选型 + +记得在做数据上报技术的评审会议上，Android 同事说用 [WCDB](https://github.com/Tencent/wcdb)，特色是 ORM、多线程安全、高性能。然后就被质疑了。因为上个版本使用的技术是基于系统自带的 sqlite2，单纯为了 ORM、多线程问题就额外引入一个三方库，是不太能说服人的。有这样几个疑问 + +- ORM 并不是核心诉求，利用 Runtime 可以在基础上进行修改，也可支持 ORM 功能 + +- 线程安全。WCDB 在线程安全的实现主要是基于`Handle`，`HandlePool` 和 `Database` 三个类完成的。`Handle` 是 sqlite3 指针，`HandlePool` 用来处理连接。 + + ```c++ + RecyclableHandle HandlePool::flowOut(Error &error) + { + m_rwlock.lockRead(); + std::shared_ptr handleWrap = m_handles.popBack(); + if (handleWrap == nullptr) { + if (m_aliveHandleCount < s_maxConcurrency) { + handleWrap = generate(error); + if (handleWrap) { + ++m_aliveHandleCount; + if (m_aliveHandleCount > s_hardwareConcurrency) { + WCDB::Error::Warning( + ("The concurrency of database:" + + std::to_string(tag.load()) + " with " + + std::to_string(m_aliveHandleCount) + + " exceeds the concurrency of hardware:" + + std::to_string(s_hardwareConcurrency)) + .c_str()); + } + } + } else { + Error::ReportCore( + tag.load(), path, Error::CoreOperation::FlowOut, + Error::CoreCode::Exceed, + "The concurrency of database exceeds the max concurrency", + &error); + } + } + if (handleWrap) { + handleWrap->handle->setTag(tag.load()); + if (invoke(handleWrap, error)) { + return RecyclableHandle( + handleWrap, [this](std::shared_ptr &handleWrap) { + flowBack(handleWrap); + }); + } + } + + handleWrap = nullptr; + m_rwlock.unlockRead(); + return RecyclableHandle(nullptr, nullptr); + } + + void HandlePool::flowBack(const std::shared_ptr &handleWrap) + { + if (handleWrap) { + bool inserted = m_handles.pushBack(handleWrap); + m_rwlock.unlockRead(); + if (!inserted) { + --m_aliveHandleCount; + } + } + } + ``` + + 所以 WCDB 连接池通过读写锁保证线程安全。所以之前版本的地方要实现线程安全修改下缺陷就可以。增加了 sqlite3，虽然看起来就是几兆大小，但是这对于公共团队是致命的。业务线开发者每次接入 SDK 会注意App 包体积的变化，为了数据上报增加好几兆，这是不可以接受的。 + +- 高性能的背后是 WCDB 自带的 sqlite3 开启了 `WAL模式` (Write-Ahead Logging)。当 WAL 文件超过 1000 个页大小时，SQLite3 会将 WAL 文件写会数据库文件。也就是 checkpointing。当大批量的数据写入场景时，如果不停提交文件到数据库事务，效率肯定低下，WCDB 的策略就是在触发 checkpoint 时，通过延时队列去处理，避免不停的触发 WalCheckpoint 调用。通过 `TimedQueue` 将同个数据库的 `WalCheckpoint` 合并延迟到2秒后执行 + + ```c++ + { + Database::defaultCheckpointConfigName, + [](std::shared_ptr &handle, Error &error) -> bool { + handle->registerCommittedHook( + [](Handle *handle, int pages, void *) { + static TimedQueue s_timedQueue(2); + if (pages > 1000) { + s_timedQueue.reQueue(handle->path); + } + static std::thread s_checkpointThread([]() { + pthread_setname_np( + ("WCDB-" + Database::defaultCheckpointConfigName) + .c_str()); + while (true) { + s_timedQueue.waitUntilExpired( + [](const std::string &path) { + Database database(path); + WCDB::Error innerError; + database.exec(StatementPragma().pragma( + Pragma::WalCheckpoint), + innerError); + }); + } + }); + static std::once_flag s_flag; + std::call_once(s_flag, + []() { s_checkpointThread.detach(); }); + }, + nullptr); + return true; + }, + (Configs::Order) Database::ConfigOrder::Checkpoint, + }, + ``` + + + + + +一般来说公共组做事情，SDK 命名、接口名称、接口个数、参数个数、参数名称、参数数据类型是严格一致的，差异是语言而已。实在万不得已，能力不能堆砌的情况下是可以不一致的，但是需要在技术评审会议上说明原因，需要在发布文档、接入文档都有所体现。 + + + +所以最后的结论是在之前的版本基础上进行修改，之前的版本是 FMDB。 + + + +### 2. 数据库维护队列 + +#### 1. FMDB 队列 + +`FMDB` 使用主要是通过 `FMDatabaseQueue` 的 `- (void)inTransaction:(__attribute__((noescape)) void (^)(FMDatabase *db, BOOL *rollback))block` 和 `- (void)inDatabase:(__attribute__((noescape)) void (^)(FMDatabase *db))block`。这2个方法的实现如下 + +```objective-c +- (void)inDatabase:(__attribute__((noescape)) void (^)(FMDatabase *db))block { +#ifndef NDEBUG + /* Get the currently executing queue (which should probably be nil, but in theory could be another DB queue + * and then check it against self to make sure we're not about to deadlock. */ + FMDatabaseQueue *currentSyncQueue = (__bridge id)dispatch_get_specific(kDispatchQueueSpecificKey); + assert(currentSyncQueue != self && "inDatabase: was called reentrantly on the same queue, which would lead to a deadlock"); +#endif + + FMDBRetain(self); + + dispatch_sync(_queue, ^() { + + FMDatabase *db = [self database]; + + block(db); + + if ([db hasOpenResultSets]) { + NSLog(@"Warning: there is at least one open result set around after performing [FMDatabaseQueue inDatabase:]"); + +#if defined(DEBUG) && DEBUG + NSSet *openSetCopy = FMDBReturnAutoreleased([[db valueForKey:@"_openResultSets"] copy]); + for (NSValue *rsInWrappedInATastyValueMeal in openSetCopy) { + FMResultSet *rs = (FMResultSet *)[rsInWrappedInATastyValueMeal pointerValue]; + NSLog(@"query: '%@'", [rs query]); + } +#endif + } + }); + + FMDBRelease(self); +} +``` + +```objective-c +- (void)inTransaction:(__attribute__((noescape)) void (^)(FMDatabase *db, BOOL *rollback))block { + [self beginTransaction:FMDBTransactionExclusive withBlock:block]; +} + +- (void)beginTransaction:(FMDBTransaction)transaction withBlock:(void (^)(FMDatabase *db, BOOL *rollback))block { + FMDBRetain(self); + dispatch_sync(_queue, ^() { + + BOOL shouldRollback = NO; + + switch (transaction) { + case FMDBTransactionExclusive: + [[self database] beginTransaction]; + break; + case FMDBTransactionDeferred: + [[self database] beginDeferredTransaction]; + break; + case FMDBTransactionImmediate: + [[self database] beginImmediateTransaction]; + break; + } + + block([self database], &shouldRollback); + + if (shouldRollback) { + [[self database] rollback]; + } + else { + [[self database] commit]; + } + }); + + FMDBRelease(self); +} +``` + +上面的 `_queue` 其实是一个串行队列，通过 `_queue = dispatch_queue_create([[NSString stringWithFormat:@"fmdb.%@", self] UTF8String], NULL);` 创建。所以，`FMDB` 的核心就是以同步的形式向串行队列提交任务，来保证多线程操作下的读写问题（比每个操作加锁效率高很多）。只有一个任务执行完毕，才可以执行下一个任务。 + +上一个版本的数据上报 SDK 功能比较简单，就是上报 APM 监控后的数据，所以数据量不会很大，之前的人封装超级简单，仅以事务的形式封装了一层 FMDB 的增删改查操作。那么就会有一个问题。假如 SDK 被业务线接入，业务线开发者不知道数据上报 SDK 的内部实现，直接调用接口去写入大量数据，结果 App 发生了卡顿，那不得反馈你这个 SDK 超级难用啊。 + + + +#### 2. 针对 FMDB 的改进 + +改法也比较简单，我们先弄清楚 `FMDB` 这样设计的原因。数据库操作的环境可能是主线程、子线程等不同环境去修改数据，主线程、子线程去读取数据，所以创建了一个串行队列去执行真正的数据增删改查。 + +目的就是让不同线程去使用 `FMDB` 的时候不会阻塞当前线程。既然 `FMDB` 内部维护了一个串行队列去处理多线程情况下的数据操作，那么改法也比较简单，那就是创建一个并发队列，然后以异步的方式提交任务到 `FMDB` 中去，`FMDB` 内部的串行队列去执行真正的任务。 + +代码如下 + +```objective-c +// 创建队列 +self.dbOperationQueue = dispatch_queue_create(PCT_DATABASE_OPERATION_QUEUE, DISPATCH_QUEUE_CONCURRENT); +self.dbQueue = [FMDatabaseQueue databaseQueueWithPath:[PCTDatabase databaseFilePath]]; + +// 以删除数据为例，以异步任务的方式向并发队列提交任务，任务内部调用 FMDatabaseQueue 去串行执行每个任务 +- (void)removeAllLogsInTableType:(PCTLogTableType)tableType { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself removeAllLogsInTable:tableName]; + }); +} + +- (void)removeAllLogsInTable:(NSString *)tableName { + NSString *sqlString = [NSString stringWithFormat:@"delete from %@", tableName]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db executeUpdate:sqlString]; + }]; +} +``` + +小实验模拟下流程 + +```objective-c +sleep(1); +NSLog(@"1"); +dispatch_queue_t concurrentQueue = dispatch_queue_create("PCT_DATABASE_OPERATION_QUEUE", DISPATCH_QUEUE_CONCURRENT); +dispatch_async(concurrentQueue, ^{ + sleep(2); + NSLog(@"2"); +}); +sleep(1); +NSLog(@"3"); +dispatch_async(concurrentQueue, ^{ + sleep(3); + NSLog(@"4"); +}); +sleep(1); +NSLog(@"5"); + +2020-07-01 13:28:13.610575+0800 Test[54460:1557233] 1 +2020-07-01 13:28:14.611937+0800 Test[54460:1557233] 3 +2020-07-01 13:28:15.613347+0800 Test[54460:1557233] 5 +2020-07-01 13:28:15.613372+0800 Test[54460:1557280] 2 +2020-07-01 13:28:17.616837+0800 Test[54460:1557277] 4 +``` + + + +![MainThread Dispatch Async Task To ConcurrentQueue](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2020-07-01-MainThreadDispatchTaskToConcurrentQueue.png) + + + +### 3. 数据表设计 + +通用的数据上报 SDK 的功能是数据的保存和上报。从数据的角度来划分，数据可以分为 APM 监控数据和业务线的业务数据。 + +数据各有什么特点呢？APM 监控数据一般可以划分为：基本信息、异常信息、线程信息，也就是最大程度的还原案发线程的数据。业务线数据基本上不会有所谓的大量数据，最多就是数据条数非常多。鉴于此现状，可以将数据表设计为 **meta 表**、**payload 表**。meta 表用来存放 APM 的基础数据和业务线的数据，payload 表用来存放 APM 的线程堆栈数据。 + +数据表的设计是基于业务情况的。那有这样几个背景 + +- APM 监控数据需要报警（具体可以查看 APM 文章，地址在开头 ），所以数据上报 SDK 上报后的数据需要实时解析 +- 产品侧比如监控大盘可以慢，所以符号化系统是异步的 +- 监控数据实在太大了，如果同步解析会因为压力较大造成性能瓶颈 + +所以把监控数据拆分为2块，即 meta 表、payload 表。meta 表相当于记录索引信息，服务端只需要关心这个。而 payload 数据在服务端是不会处理的，会有一个异步服务单独处理。 + +meta 表、payload 表结构如下： + +```sql +create table if not exists ***_meta (id integer NOT NULL primary key autoincrement, report_id text, monitor_type text, is_biz integer NOT NULL, created_time datetime, meta text, namespace text, is_used integer NOT NULL, size integer NOT NULL); + +create table if not exists ***_payload (id integer NOT NULL primary key autoincrement, report_id text, monitor_type text, is_biz integer NOT NULL, created_time datetime, meta text, payload blob, namespace text, is_used integer NOT NULL, size integer NOT NULL); +``` + + + +### 4. 数据库表的封装 + +```objective-c +#import "PCTDatabase.h" +#import + +static NSString *const PCT_LOG_DATABASE_NAME = @"***.db"; +static NSString *const PCT_LOG_TABLE_META = @"***_prism_meta"; +static NSString *const PCT_LOG_TABLE_PAYLOAD = @"***_prism_payload"; +const char *PCT_DATABASE_OPERATION_QUEUE = "com.***.pct_database_operation_QUEUE"; + +@interface PCTDatabase () + +@property (nonatomic, strong) dispatch_queue_t dbOperationQueue; +@property (nonatomic, strong) FMDatabaseQueue *dbQueue; +@property (nonatomic, strong) NSDateFormatter *dateFormatter; + +@end + +@implementation PCTDatabase + +#pragma mark - life cycle ++ (instancetype)sharedInstance { + static PCTDatabase *_sharedInstance = nil; + static dispatch_once_t onceToken; + dispatch_once(&onceToken, ^{ + _sharedInstance = [[self alloc] init]; + }); + return _sharedInstance; +} + +- (instancetype)init { + self = [super init]; + self.dateFormatter = [[NSDateFormatter alloc] init]; + [self.dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss A Z"]; + self.dbOperationQueue = dispatch_queue_create(PCT_DATABASE_OPERATION_QUEUE, DISPATCH_QUEUE_CONCURRENT); + self.dbQueue = [FMDatabaseQueue databaseQueueWithPath:[PCTDatabase databaseFilePath]]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [self createLogMetaTableIfNotExist:db]; + [self createLogPayloadTableIfNotExist:db]; + }]; + return self; +} + +#pragma mark - public Method + +- (void)add:(NSArray *)logs inTableType:(PCTLogTableType)tableType { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself add:logs inTable:tableName]; + }); +} + +- (void)remove:(NSArray *)logs inTableType:(PCTLogTableType)tableType { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself remove:logs inTable:tableName]; + }); +} + +- (void)removeAllLogsInTableType:(PCTLogTableType)tableType { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself removeAllLogsInTable:tableName]; + }); +} + +- (void)removeOldestRecordsByCount:(NSInteger)count inTableType:(PCTLogTableType)tableType { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself removeOldestRecordsByCount:count inTable:tableName]; + }); +} + +- (void)removeLatestRecordsByCount:(NSInteger)count inTableType:(PCTLogTableType)tableType { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself removeLatestRecordsByCount:count inTable:tableName]; + }); +} + +- (void)removeRecordsBeforeDays:(NSInteger)day inTableType:(PCTLogTableType)tableType { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself removeRecordsBeforeDays:day inTable:tableName]; + }); + [self rebuildDatabaseFileInTableType:tableType]; +} + +- (void)removeDataUseCondition:(NSString *)condition inTableType:(PCTLogTableType)tableType { + if (!PCT_IS_CLASS(condition, NSString)) { + NSAssert(PCT_IS_CLASS(condition, NSString), @"自定义删除条件必须是字符串类型"); + return; + } + if (condition.length == 0) { + NSAssert(!(condition.length == 0), @"自定义删除条件不能为空"); + return; + } + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself removeDataUseCondition:condition inTable:tableName]; + }); +} + +- (void)updateData:(NSString *)state useCondition:(NSString *)condition inTableType:(PCTLogTableType)tableType { + if (!PCT_IS_CLASS(state, NSString)) { + NSAssert(PCT_IS_CLASS(state, NSString), @"数据表字段更改命令必须是合法字符串"); + return; + } + if (state.length == 0) { + NSAssert(!(state.length == 0), @"数据表字段更改命令必须是合法字符串"); + return; + } + + if (!PCT_IS_CLASS(condition, NSString)) { + NSAssert(PCT_IS_CLASS(condition, NSString), @"数据表字段更改条件必须是字符串类型"); + return; + } + if (condition.length == 0) { + NSAssert(!(condition.length == 0), @"数据表字段更改条件不能为空"); + return; + } + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself updateData:state useCondition:condition inTable:tableName]; + }); +} + +- (void)recordsCountInTableType:(PCTLogTableType)tableType completion:(void (^)(NSInteger count))completion { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + NSInteger recordsCount = [weakself recordsCountInTable:tableName]; + if (completion) { + completion(recordsCount); + } + }); +} + +- (void)getLatestRecoreds:(NSInteger)count inTableType:(PCTLogTableType)tableType completion:(void (^)(NSArray *records))completion { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + NSArray *records = [weakself getLatestRecoreds:count inTable:tableName]; + if (completion) { + completion(records); + } + }); +} + +- (void)getOldestRecoreds:(NSInteger)count inTableType:(PCTLogTableType)tableType completion:(void (^)(NSArray *records))completion { + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + NSArray *records = [weakself getOldestRecoreds:count inTable:tableName]; + if (completion) { + completion(records); + } + }); +} + +- (void)getRecordsByCount:(NSInteger)count condtion:(NSString *)condition inTableType:(PCTLogTableType)tableType completion:(void (^)(NSArray *records))completion { + if (!PCT_IS_CLASS(condition, NSString)) { + NSAssert(PCT_IS_CLASS(condition, NSString), @"自定义查询条件必须是字符串类型"); + if (completion) { + completion(nil); + } + } + if (condition.length == 0) { + NSAssert(!(condition.length == 0), @"自定义查询条件不能为空"); + if (completion) { + completion(nil); + } + } + [self isExistInTable:tableType]; + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + NSArray *records = [weakself getRecordsByCount:count condtion:condition inTable:tableName]; + if (completion) { + completion(records); + } + }); +} + +- (void)rebuildDatabaseFileInTableType:(PCTLogTableType)tableType { + __weak typeof(self) weakself = self; + dispatch_async(self.dbOperationQueue, ^{ + NSString *tableName = PCTGetTableNameFromType(tableType); + [weakself rebuildDatabaseFileInTable:tableName]; + }); +} + +#pragma mark - CMDatabaseDelegate + +- (void)add:(NSArray *)logs inTable:(NSString *)tableName { + if (logs.count == 0) { + return; + } + __weak typeof(self) weakself = self; + [self.dbQueue inTransaction:^(FMDatabase *_Nonnull db, BOOL *_Nonnull rollback) { + [db setDateFormat:weakself.dateFormatter]; + for (NSInteger index = 0; index < logs.count; index++) { + id obj = logs[index]; + // meta 类型数据的处理逻辑 + if (PCT_IS_CLASS(obj, PCTLogMetaModel)) { + PCTLogMetaModel *model = (PCTLogMetaModel *)obj; + if (model.monitor_type == nil || model.meta == nil || model.created_time == nil || model.namespace == nil) { + PCTLOG(@"参数错误 { monitor_type: %@, meta: %@, created_time: %@, namespace: %@}", model.monitor_type, model.meta, model.created_time, model.namespace); + return; + } + + NSString *sqlString = [NSString stringWithFormat:@"insert into %@ (report_id, monitor_type, is_biz, created_time, meta, namespace, is_used, size) values (?, ?, ?, ?, ?, ?, ?, ?)", tableName]; + [db executeUpdate:sqlString withArgumentsInArray:@[model.report_id, model.monitor_type, @(model.is_biz), model.created_time, model.meta, model.namespace, @(model.is_used), @(model.size)]]; + } + + // payload 类型数据的处理逻辑 + if (PCT_IS_CLASS(obj, PCTLogPayloadModel)) { + PCTLogPayloadModel *model = (PCTLogPayloadModel *)obj; + if (model.monitor_type == nil || model.meta == nil || model.created_time == nil || model.namespace == nil) { + PCTLOG(@"参数错误 { monitor_type: %@, meta: %@, created_time: %@, namespace: %@}", model.monitor_type, model.meta, model.created_time, model.namespace); + return; + } + + NSString *sqlString = [NSString stringWithFormat:@"insert into %@ (report_id, monitor_type, is_biz, created_time, meta, payload, namespace, is_used, size) values (?, ?, ?, ?, ?, ?, ?, ?, ?)", tableName]; + [db executeUpdate:sqlString withArgumentsInArray:@[model.report_id, model.monitor_type, @(model.is_biz), model.created_time, model.meta, model.payload ?: [NSData data], model.namespace, @(model.is_used), @(model.size)]]; + } + } + }]; +} + +- (NSInteger)remove:(NSArray *)logs inTable:(NSString *)tableName { + NSString *sqlString = [NSString stringWithFormat:@"delete from %@ where report_id = ?", tableName]; + [self.dbQueue inTransaction:^(FMDatabase *_Nonnull db, BOOL *_Nonnull rollback) { + [logs enumerateObjectsUsingBlock:^(PCTLogModel *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + [db executeUpdate:sqlString withArgumentsInArray:@[obj.report_id]]; + }]; + }]; + return 0; +} + +- (void)removeAllLogsInTable:(NSString *)tableName { + NSString *sqlString = [NSString stringWithFormat:@"delete from %@", tableName]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db executeUpdate:sqlString]; + }]; +} + +- (void)removeOldestRecordsByCount:(NSInteger)count inTable:(NSString *)tableName { + NSString *sqlString = [NSString stringWithFormat:@"delete from %@ where id in (select id from %@ order by created_time asc limit ? )", tableName, tableName]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db executeUpdate:sqlString withArgumentsInArray:@[@(count)]]; + }]; +} + +- (void)removeLatestRecordsByCount:(NSInteger)count inTable:(NSString *)tableName { + NSString *sqlString = [NSString stringWithFormat:@"delete from %@ where id in (select id from %@ order by created_time desc limit ?)", tableName, tableName]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db executeUpdate:sqlString withArgumentsInArray:@[@(count)]]; + }]; +} + +- (void)removeRecordsBeforeDays:(NSInteger)day inTable:(NSString *)tableName { + // 找出从create到现在已经超过最大 day 天的数据，然后删除 ：delete from ***_prism_meta where strftime('%s', date('now', '-2 day')) >= created_time; + NSString *sqlString = [NSString stringWithFormat:@"delete from %@ where strftime('%%s', date('now', '-%zd day')) >= created_time", tableName, day]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db executeUpdate:sqlString]; + }]; +} + +- (void)removeDataUseCondition:(NSString *)condition inTable:(NSString *)tableName { + NSString *sqlString = [NSString stringWithFormat:@"delete from %@ where %@", tableName, condition]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db executeUpdate:sqlString]; + }]; +} + +- (void)updateData:(NSString *)state useCondition:(NSString *)condition inTable:(NSString *)tableName +{ + NSString *sqlString = [NSString stringWithFormat:@"update %@ set %@ where %@", tableName, state, condition]; + [self.dbQueue inDatabase:^(FMDatabase * _Nonnull db) { + BOOL res = [db executeUpdate:sqlString]; + PCTLOG(res ? @"更新成功" : @"更新失败"); + }]; +} + +- (NSInteger)recordsCountInTable:(NSString *)tableName { + NSString *sqlString = [NSString stringWithFormat:@"select count(*) as count from %@", tableName]; + __block NSInteger recordsCount = 0; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + FMResultSet *resultSet = [db executeQuery:sqlString]; + [resultSet next]; + recordsCount = [resultSet intForColumn:@"count"]; + [resultSet close]; + }]; + return recordsCount; +} + +- (NSArray *)getLatestRecoreds:(NSInteger)count inTable:(NSString *)tableName { + __block NSMutableArray *records = [NSMutableArray new]; + NSString *sql = [NSString stringWithFormat:@"select * from %@ order by created_time desc limit ?", tableName]; + + __weak typeof(self) weakself = self; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db setDateFormat:weakself.dateFormatter]; + FMResultSet *resultSet = [db executeQuery:sql withArgumentsInArray:@[@(count)]]; + while ([resultSet next]) { + if ([tableName isEqualToString:PCT_LOG_TABLE_META]) { + PCTLogMetaModel *model = [[PCTLogMetaModel alloc] init]; + model.log_id = [resultSet intForColumn:@"id"]; + model.report_id = [resultSet stringForColumn:@"report_id"]; + model.monitor_type = [resultSet stringForColumn:@"monitor_type"]; + model.created_time = [resultSet stringForColumn:@"created_time"]; + model.meta = [resultSet stringForColumn:@"meta"]; + model.namespace = [resultSet stringForColumn:@"namespace"]; + model.size = [resultSet intForColumn:@"size"]; + model.is_biz = [resultSet boolForColumn:@"is_biz"]; + model.is_used = [resultSet boolForColumn:@"is_used"]; + [records addObject:model]; + + } else if ([tableName isEqualToString:PCT_LOG_TABLE_PAYLOAD]) { + PCTLogPayloadModel *model = [[PCTLogPayloadModel alloc] init]; + model.log_id = [resultSet intForColumn:@"id"]; + model.report_id = [resultSet stringForColumn:@"report_id"]; + model.monitor_type = [resultSet stringForColumn:@"monitor_type"]; + model.created_time = [resultSet stringForColumn:@"created_time"]; + model.meta = [resultSet stringForColumn:@"meta"]; + model.payload = [resultSet dataForColumn:@"payload"]; + model.namespace = [resultSet stringForColumn:@"namespace"]; + model.size = [resultSet intForColumn:@"size"]; + model.is_biz = [resultSet boolForColumn:@"is_biz"]; + model.is_used = [resultSet boolForColumn:@"is_used"]; + [records addObject:model]; + } + } + [resultSet close]; + }]; + return records; +} + +- (NSArray *)getOldestRecoreds:(NSInteger)count inTable:(NSString *)tableName { + __block NSMutableArray *records = [NSMutableArray array]; + NSString *sqlString = [NSString stringWithFormat:@"select * from %@ order by created_time asc limit ?", tableName]; + + __weak typeof(self) weakself = self; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db setDateFormat:weakself.dateFormatter]; + + FMResultSet *resultSet = [db executeQuery:sqlString withArgumentsInArray:@[@(count)]]; + while ([resultSet next]) { + if ([tableName isEqualToString:PCT_LOG_TABLE_META]) { + PCTLogMetaModel *model = [[PCTLogMetaModel alloc] init]; + model.log_id = [resultSet intForColumn:@"id"]; + model.report_id = [resultSet stringForColumn:@"report_id"]; + model.monitor_type = [resultSet stringForColumn:@"monitor_type"]; + model.created_time = [resultSet stringForColumn:@"created_time"]; + model.meta = [resultSet stringForColumn:@"meta"]; + model.namespace = [resultSet stringForColumn:@"namespace"]; + model.size = [resultSet intForColumn:@"size"]; + model.is_biz = [resultSet boolForColumn:@"is_biz"]; + model.is_used = [resultSet boolForColumn:@"is_used"]; + [records addObject:model]; + + } else if ([tableName isEqualToString:PCT_LOG_TABLE_PAYLOAD]) { + PCTLogPayloadModel *model = [[PCTLogPayloadModel alloc] init]; + model.log_id = [resultSet intForColumn:@"id"]; + model.report_id = [resultSet stringForColumn:@"report_id"]; + model.monitor_type = [resultSet stringForColumn:@"monitor_type"]; + model.created_time = [resultSet stringForColumn:@"created_time"]; + model.meta = [resultSet stringForColumn:@"meta"]; + model.payload = [resultSet dataForColumn:@"payload"]; + model.namespace = [resultSet stringForColumn:@"namespace"]; + model.size = [resultSet intForColumn:@"size"]; + model.is_used = [resultSet boolForColumn:@"is_used"]; + model.is_biz = [resultSet boolForColumn:@"is_biz"]; + [records addObject:model]; + } + } + [resultSet close]; + }]; + return records; +} + +- (NSArray *)getRecordsByCount:(NSInteger)count condtion:(NSString *)condition inTable:(NSString *)tableName { + __block NSMutableArray *records = [NSMutableArray array]; + __weak typeof(self) weakself = self; + NSString *sqlString = [NSString stringWithFormat:@"select * from %@ where %@ order by created_time desc limit %zd", tableName, condition, count]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db setDateFormat:weakself.dateFormatter]; + + FMResultSet *resultSet = [db executeQuery:sqlString]; + + while ([resultSet next]) { + if ([tableName isEqualToString:PCT_LOG_TABLE_META]) { + PCTLogMetaModel *model = [[PCTLogMetaModel alloc] init]; + model.log_id = [resultSet intForColumn:@"id"]; + model.report_id = [resultSet stringForColumn:@"report_id"]; + model.monitor_type = [resultSet stringForColumn:@"monitor_type"]; + model.created_time = [resultSet stringForColumn:@"created_time"]; + model.meta = [resultSet stringForColumn:@"meta"]; + model.namespace = [resultSet stringForColumn:@"namespace"]; + model.size = [resultSet intForColumn:@"size"]; + model.is_biz = [resultSet boolForColumn:@"is_biz"]; + model.is_used = [resultSet boolForColumn:@"is_used"]; + [records addObject:model]; + + } else if ([tableName isEqualToString:PCT_LOG_TABLE_PAYLOAD]) { + PCTLogPayloadModel *model = [[PCTLogPayloadModel alloc] init]; + model.log_id = [resultSet intForColumn:@"id"]; + model.report_id = [resultSet stringForColumn:@"report_id"]; + model.monitor_type = [resultSet stringForColumn:@"monitor_type"]; + model.created_time = [resultSet stringForColumn:@"created_time"]; + model.meta = [resultSet stringForColumn:@"meta"]; + model.payload = [resultSet dataForColumn:@"payload"]; + model.namespace = [resultSet stringForColumn:@"namespace"]; + model.size = [resultSet intForColumn:@"size"]; + model.is_biz = [resultSet boolForColumn:@"is_biz"]; + model.is_used = [resultSet boolForColumn:@"is_used"]; + [records addObject:model]; + } + } + [resultSet close]; + }]; + return records; +} + +- (void)rebuildDatabaseFileInTable:(NSString *)tableName { + NSString *sqlString = [NSString stringWithFormat:@"vacuum %@", tableName]; + [self.dbQueue inDatabase:^(FMDatabase *_Nonnull db) { + [db executeUpdate:sqlString]; + }]; +} + +#pragma mark - private method + ++ (NSString *)databaseFilePath { + NSString *docsPath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0]; + NSString *dbPath = [docsPath stringByAppendingPathComponent:PCT_LOG_DATABASE_NAME]; + PCTLOG(@"上报系统数据库文件位置 -> %@", dbPath); + return dbPath; +} + +- (void)createLogMetaTableIfNotExist:(FMDatabase *)db { + NSString *createMetaTableSQL = [NSString stringWithFormat:@"create table if not exists %@ (id integer NOT NULL primary key autoincrement, report_id text, monitor_type text, is_biz integer NOT NULL, created_time datetime, meta text, namespace text, is_used integer NOT NULL, size integer NOT NULL)", PCT_LOG_TABLE_META]; + BOOL result = [db executeStatements:createMetaTableSQL]; + PCTLOG(@"确认日志Meta表是否存在 -> %@", result ? @"成功" : @"失败"); +} + +- (void)createLogPayloadTableIfNotExist:(FMDatabase *)db { + NSString *createMetaTableSQL = [NSString stringWithFormat:@"create table if not exists %@ (id integer NOT NULL primary key autoincrement, report_id text, monitor_type text, is_biz integer NOT NULL, created_time datetime, meta text, payload blob, namespace text, is_used integer NOT NULL, size integer NOT NULL)", PCT_LOG_TABLE_PAYLOAD]; + BOOL result = [db executeStatements:createMetaTableSQL]; + PCTLOG(@"确认日志Payload表是否存在 -> %@", result ? @"成功" : @"失败"); +} + +NS_INLINE NSString *PCTGetTableNameFromType(PCTLogTableType type) { + if (type == PCTLogTableTypeMeta) { + return PCT_LOG_TABLE_META; + } + if (type == PCTLogTableTypePayload) { + return PCT_LOG_TABLE_PAYLOAD; + } + return @""; +} + +// 每次操作前检查数据库以及数据表是否存在,不存在则创建数据库和数据表 +- (void)isExistInTable:(PCTLogTableType)tableType { + NSString *databaseFilePath = [PCTDatabase databaseFilePath]; + BOOL isExist = [[NSFileManager defaultManager] fileExistsAtPath:databaseFilePath]; + if (!isExist) { + self.dbQueue = [FMDatabaseQueue databaseQueueWithPath:[PCTDatabase databaseFilePath]]; + } + [self.dbQueue inDatabase:^(FMDatabase *db) { + NSString *tableName = PCTGetTableNameFromType(tableType); + BOOL res = [db tableExists:tableName]; + if (!res) { + if (tableType == PCTLogTableTypeMeta) { + [self createLogMetaTableIfNotExist:db]; + } + if (tableType == PCTLogTableTypeMeta) { + [self createLogPayloadTableIfNotExist:db]; + } + } + }]; +} + +@end +``` + + + +### 5. 数据存储流程 + + APM 监控数据会比较特殊点，比如 iOS 当发生 crash 后是没办法上报的，只有将 crash 信息保存到文件中，下次 App 启动后读取 crash 日志文件夹再去交给数据上报 SDK。Android 在发生 crash 后由于机制不一样，可以马上将 crash 信息交给数据上报 SDK。 + +由于 payload 数据，也就是堆栈数据非常大，所以上报的接口也有限制，一次上传接口中报文最大包体积的限制等等。 + +可以看一下 Model 信息， + +```objective-c +@interface PCTItemModel : NSObject + +@property (nonatomic, copy) NSString *type; /**<上报数据类型*/ +@property (nonatomic, assign) BOOL onlyWifi; /**<是否仅 Wi-Fi 上报*/ +@property (nonatomic, assign) BOOL isRealtime; /**<是否实时上报*/ +@property (nonatomic, assign) BOOL isUploadPayload; /**<是否需要上报 Payload*/ + +@end + +@interface PCTConfigurationModel : NSObject + +@property (nonatomic, copy) NSString *url; /**<当前 namespace 对应的上报地址 */ +@property (nonatomic, assign) BOOL isUpload; /**<全局上报开关*/ +@property (nonatomic, assign) BOOL isGather; /**<全局采集开关*/ +@property (nonatomic, assign) BOOL isUpdateClear; /**<升级后是否清除数据*/ +@property (nonatomic, assign) NSInteger maxBodyMByte; /**<最大包体积单位 M (范围 < 3M)*/ +@property (nonatomic, assign) NSInteger periodicTimerSecond; /**<定时上报时间单位秒 (范围1 ~ 30秒)*/ +@property (nonatomic, assign) NSInteger maxItem; /**<最大条数 (范围 < 100)*/ +@property (nonatomic, assign) NSInteger maxFlowMByte; /**<每天最大非 Wi-Fi 上传流量单位 M (范围 < 100M)*/ +@property (nonatomic, assign) NSInteger expirationDay; /**<数据过期时间单位 天 (范围 < 30)*/ +@property (nonatomic, copy) NSArray *monitorList; /**<配置项目*/ + +@end +``` + +监控数据存储流程： + +1. 每个数据（监控数据、业务线数据）过来先判断该数据所在的 namespace 是否开启了收集开关 + +2. 判断数据是否可以落库，根据数据接口中 type 能否命中上报配置数据中的 monitorList 中的任何一项的 type + +3. 监控数据先写入 meta 表，然后判断是否写入 payload 表。判断标准是计算监控数据的 payload 大小是否超过了上报配置数据的 `maxBodyMByte`。超过大小的数据就不能入库,因为这是服务端消耗 payload 的一个上限 + +4. 走监控接口过来的数据，在方法内部会为监控数据增加基础信息（比如 App 名称、App 版本号、打包任务 id、设备类型等等） + + ```objective-c + @property (nonatomic, copy) NSString *xxx_APP_NAME; /** 0, warning, type); + return; + } + + if (!PCT_IS_CLASS(meta, NSDictionary)) { + return; + } + if (meta.allKeys.count == 0) { + return; + } + + // 2. 判断当前 namespace 是否开启了收集 + if (!self.configureModel.isGather) { + PCTLOG(@"%@", [NSString stringWithFormat:@"Namespace: %@ 下数据收集开关为关闭状态", self.namespace]); + return ; + } + + // 3. 判断是否是有效的数据。可以落库（type 和监控参数的接口中 monitorList 中的任一条目的type 相等） + BOOL isValidate = [self validateLogData:type]; + if (!isValidate) { + return; + } + + // 3. 先写入 meta 表 + PCTCommonModel *commonModel = [[PCTCommonModel alloc] init]; + [self sendWithType:type namespace:PRISMNAMESPACE meta:meta isBiz:NO commonModel:commonModel]; + + // 4. 如果 payload 不存在则退出当前执行 + if (!PCT_IS_CLASS(payload, NSData) && !payload) { + return; + } + + // 5. 添加限制(超过大小的数据就不能入库,因为这是服务端消耗 payload 的一个上限) + CGFloat payloadSize = [self calculateDataSize:payload]; + if (payloadSize > self.configureModel.maxBodyMByte) { + NSString *assertString = [NSString stringWithFormat:@"payload 数据的大小超过临界值 %zdKB", self.configureModel.maxBodyMByte]; + NSAssert(payloadSize <= self.configureModel.maxBodyMByte, assertString); + return; + } + + // 6. 合并 meta 与 Common 基础数据，用来存储 payload 上报所需要的 meta 信息 + NSMutableDictionary *metaDictionary = [NSMutableDictionary dictionary]; + NSDictionary *commonDictionary = [commonModel getDictionary]; + // Crash 类型为特例,外部传入的 Crash 案发现场信息不能被覆盖 + if ([type isEqualToString:@"appCrash"]) { + [metaDictionary addEntriesFromDictionary:commonDictionary]; + [metaDictionary addEntriesFromDictionary:meta]; + } else { + [metaDictionary addEntriesFromDictionary:meta]; + [metaDictionary addEntriesFromDictionary:commonDictionary]; + } + + NSError *error; + NSData *metaData = [NSJSONSerialization dataWithJSONObject:metaDictionary options:0 error:&error]; + if (error) { + PCTLOG(@"%@", error); + return; + } + NSString *metaContentString = [[NSString alloc] initWithData:metaData encoding:NSUTF8StringEncoding]; + + // 7. 计算上报时 payload 这条数据的大小（meta+payload） + NSMutableData *totalData = [NSMutableData data]; + [totalData appendData:metaData]; + [totalData appendData:payload]; + + // 8. 再写入 payload 表 + PCTLogPayloadModel *payloadModel = [[PCTLogPayloadModel alloc] init]; + payloadModel.is_used = NO; + payloadModel.namespace = PRISMNAMESPACE; + payloadModel.report_id = PCT_SAFE_STRING(commonModel.REPORT_ID); + payloadModel.monitor_type = PCT_SAFE_STRING(type); + payloadModel.is_biz = NO; + payloadModel.created_time = PCT_SAFE_STRING(commonModel.CREATE_TIME); + payloadModel.meta = PCT_SAFE_STRING(metaContentString); + payloadModel.payload = payload; + payloadModel.size = totalData.length; + [PCT_DATABASE add:@[payloadModel] inTableType:PCTLogTableTypePayload]; + + // 9. 判断是否触发实时上报 + [self handleUploadDataWithtype:type]; +} +``` + +业务线数据存储流程基本和监控数据的存储差不多，有差别的是某些字段的标示，用来区分业务线数据。 + + + +## 四、数据上报机制 + +### 1. 数据上报流程和机制设计 + +数据上报机制需要结合数据特点进行设计，数据分为 APM 监控数据和业务线上传数据。先分析下2部分数据的特点。 + +- 业务线数据可能会要求实时上报，需要有根据上报配置数据控制的能力 + +- 整个数据聚合上报过程需要有根据上报配置数据控制的能力定时器周期的能力，隔一段时间去触发上报 + +- 整个数据（业务数据、APM 监控数据）的上报与否需要有通过配置数据控制的能力 + +- 因为 App 在某个版本下收集的数据可能会对下个版本的时候无效，所以上报 SDK 启动后需要有删除之前版本数据的能力（上报配置数据中删除开关打开的情况下） + +- 同样，需要删除过期数据的能力（删除距今多少个自然天前的数据，同样走下发而来的上报配置项） + +- 因为 APM 监控数据非常大，且数据上报 SDK 肯定数据比较大，所以一个网络通信方式的设计好坏会影响 SDK 的质量，为了网络性能不采用传统的 `key/value` 传输。采用**自定义报文结构** + +- 数据的上报流程触发方式有3种：App 启动后触发（APM 监控到 crash 的时候写入本地，启动后处理上次 crash 的数据，是一个特殊 case ）；定时器触发；数据调用数据上报 SDK 接口后命中实时上报逻辑 + +- 数据落库后会触发一次完整的上报流程 + +- 上报流程的第一步会先判断该数据的 type 能否名字上报配置的 type，命中后如果实时上报配置项为 true，则马上执行后续真正的数据聚合过程；否则中断（只落库，不触发上报） + +- 由于频率会比较高，所以需要做节流的逻辑 + +- 上报流程会首先判断（为了节约用户流量） + + - 判断当前网络环境为 WI-FI 则实时上报 + - 判断当前网络环境不可用，则实时中断后续 + - 判断当前网络环境为蜂窝网络， 则做是否超过**1个自然天内使用流量是否超标**的判断 + - T(当前时间戳) - T(上次保存时间戳) > 24h，则清零已使用的流量，记录当前时间戳到上次上报时间的变量中 + - T(当前时间戳) - T(上次保存时间戳) <= 24h，则判断一个自然天内已使用流量大小是否超过下发的数据上报配置中的流量上限字段，超过则 exit；否则执行后续流程 + +- 数据聚合分表进行，且会有一定的规则 + + - 优先获取 crash 数据 + - 单次网络上报中，整体数据条数不能数据上报配置中的条数限制；数据大小不能超过数据配置中的数据大小 + +- 数据取出后将这批数据标记为 dirty 状态 + +- meta 表数据需要先 `gZip` 压缩，再使用 `AES 128` 加密 + +- payload 表数据需组装自定义格式的报文。格式如下 + + Header 部分： + + ```shell + 2字节大小、数据类型 unsigned short 表示 meta 数据大小 + n 条 payload 数据结构（2字节大小、数据类型为 unsigned int 表示单条 payload 数据大小） + ``` + + ```shell + header + meta 数据 + payload 数据 + ``` + +- 发起数据上报网络请求 + + - 成功回调：删除标记为`dirty` 的数据。判断为流量环境，则将该批数据大小叠加到1个自然天内已使用流量大小的变量中。 + - 失败回调：更新标记为`dirty` 的数据为正常状态。判断为流量环境，则将该批数据大小叠加到1个自然天内已使用流量大小的变量中。 + +整个上报流程图如下： + +![数据上报流程](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2020-07-04-DataUploaderSDKStructure.png) + + + +### 2. 踩过的坑 && 做得好的地方 + +- 之前做针对网络接口基本上都是使用现有协议的 `key/value` 协议上开发的，它的优点是使用简单，缺点是协议体太大。在设计方案的时候分析道数据上报 SDK 网络上报肯定是非常高频的所以我们需要设计自定义的报文协议，这部分的设计上可以参考 `TCP 报文头结构`。 + +- 当时和后端对接接口的时候发现数据上报过去，服务端解析不了。断点调试发现数据聚合后的大小、条数、压缩、加密都是正常的，在本地 Mock 后完全可以反向解析出来。但为什么到服务端就解析不了，联调后发现是**字节端序**（Big-Endian）的问题。简单介绍如下，关于大小端序的详细介绍请查看我的[这篇文章](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter5%20-%20Network/5.3.md) + + 主机字节顺序HBO（Host Byte Order）：与 CPU 类型有关。Big-Endian: PowerPC、IBM、Sun。Little-Endian:x86、DEC + + 网络字节顺序 NBO（Network Byte Order）：网络默认为大端序。 + +- 上面的逻辑有一步是当网络上报成功后需要删除标记为 dirty 的数据。但是测试了一下发现，大量数据删除后数据库文件的大小不变，理论上需要腾出内存数据大小的空间。 + + sqlite 采用的是变长记录存储，当数据被删除后，未使用的磁盘空间被添加到一个内在的“空闲列表”中，用于下次插入数据，这属于优化机制之一，sqlite 提供 `vacuum` 命令来释放。 + + 这个问题类似于 Linux 中的文件引用计数的意思，虽然不一样，但是提出来做一下参考。实验是这样的 + + 1. 先看一下当前各个挂载目录的空间大小：`df -h` + + 2. 首先我们产生一个50M大小的文件 + + 3. 写一段代码读取文件 + + ```c++ + #include + #include + int main(void) + {    FILE *fp = NULL;    + fp = fopen("/boot/test.txt", "rw+");    + if(NULL == fp){       + perror("open file failed");    + return -1;    + }     + while(1){       + //do nothing       sleep(1);    + }    + fclose(fp);   + return 0; + } + ``` + + 4. 命令行模式下使用 `rm` 删除文件 + + 5. 查看文件大小： `df -h`，发现文件被删除了，但是该目录下的可用空间并未变多 + + 解释：实际上，只有当一个文件的引用计数为0（包括硬链接数）的时候，才可能调用 unlink 删除，只要它不是0，那么就不会被删除。所谓的删除，也不过是文件名到 inode 的链接删除，只要不被重新写入新的数据，磁盘上的 block 数据块不会被删除，因此，你会看到，即便删库跑路了，某些数据还是可以恢复的。换句话说，当一个程序打开一个文件的时候（获取到文件描述符），它的引用计数会被+1，rm虽然看似删除了文件，实际上只是会将引用计数减1，但由于引用计数不为0，因此文件不会被删除。 + +- 在数据聚合的时候优先获取 crash 数据，总数据条数需要小于上报配置数据的条数限制、总数据大小需要小于上报配置数据的大小限制。这里的处理使用了递归，改变了函数参数 + + ```objective-c + - (void)assembleDataInTable:(PCTLogTableType)tableType networkType:(NetworkingManagerStatusType)networkType completion:(void (^)(NSArray *records))completion { + // 1. 获取到合适的 Crash 类型的数据 + [self fetchCrashDataByCount:self.configureModel.maxFlowMByte + inTable:tableType + upperBound:self.configureModel.maxBodyMByte + completion:^(NSArray *records) { + NSArray *crashData = records; + // 2. 计算剩余需要的数据条数和剩余需要的数据大小 + NSInteger remainingCount = self.configureModel.maxItem - crashData.count; + float remainingSize = self.configureModel.maxBodyMByte - [self calculateDataSize:crashData]; + // 3. 获取除 Crash 类型之外的其他数据，且需要符合相应规则 + BOOL isWifi = (networkType == NetworkingManagerStatusReachableViaWiFi); + [self fetchDataExceptCrash:remainingCount + inTable:tableType + upperBound:remainingSize + isWiFI:isWifi + completion:^(NSArray *records) { + NSArray *dataExceptCrash = records; + + NSMutableArray *dataSource = [NSMutableArray array]; + [dataSource addObjectsFromArray:crashData]; + [dataSource addObjectsFromArray:dataExceptCrash]; + if (completion) { + completion([dataSource copy]); + } + }]; + }]; + } + + - (void)fetchDataExceptCrash:(NSInteger)count inTable:(PCTLogTableType)tableType upperBound:(float)size isWiFI:(BOOL)isWifi completion:(void (^)(NSArray *records))completion { + // 1. 根据剩余需要数据条数去查询表中非 Crash 类型的数据集合 + __block NSMutableArray *conditions = [NSMutableArray array]; + [self.configureModel.monitorList enumerateObjectsUsingBlock:^(PCTItemModel * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) { + if (isWifi) { + if (![obj.type isEqualToString:@"appCrash"]) { + [conditions addObject:[NSString stringWithFormat:@"'%@'", obj.type]]; + } + } else { + if (!obj.onlyWifi && ![obj.type isEqualToString:@"appCrash"]) { + [conditions addObject:[NSString stringWithFormat:@"'%@'", PCT_SAFE_STRING(obj.type)]]; + } + } + }]; + NSString *queryCrashDataCondition = [NSString stringWithFormat:@"monitor_type in (%@) and is_used = 0 and namespace = '%@'", [conditions componentsJoinedByString:@","], self.namespace]; + + // 2. 根据是否有 Wifi 查找对应的数据 + [PCT_DATABASE getRecordsByCount:count + condtion:queryCrashDataCondition + inTableType:tableType + completion:^(NSArray *_Nonnull records) { + // 3. 非 Crash 类型的数据集合大小是否超过剩余需要的数据大小 + float dataSize = [self calculateDataSize:records]; + + // 4. 大于最大包体积则递归获取 maxItem-1 条非 Crash 数据集合并判断数据大小 + if (size == 0) { + if (completion) { + completion(records); + } + } else if (dataSize > size) { + NSInteger currentCount = count - 1; + return [self fetchDataExceptCrash:currentCount inTable:tableType upperBound:size isWiFI:isWifi completion:completion]; + } else { + if (completion) { + completion(records); + } + } + }]; + } + ``` + +- 整个 SDK 的 Unit Test 通过率 100%，代码分支覆盖率为 93%。测试基于 TDD 和 BDD。测试框架：系统自带的 `XCTest`，第三方的 `OCMock`、`Kiwi`、`Expecta`、`Specta`。测试使用了基础类，后续每个文件都设计继承自测试基类的类。 + + Xcode 可以看到整个 SDK 的测试覆盖率和单个文件的测试覆盖率 + + ![Xcode 测试覆盖率](https://raw.githubusercontent.com/FantasticLBP/knowledge-kit/master/assets/2020-07-06-XcodeTestCoverage.png) + + 也可以使用 [slather](https://github.com/SlatherOrg/slather)。在项目终端环境下新建 `.slather.yml` 配置文件，然后执行语句 `slather coverage -s --scheme prism-client-Example --workspace prism-client.xcworkspace prism-client.xcodeproj`。 + + + +## 五、 接口设计 + +```objective-c +@interface PrismClient : NSObject + +- (instancetype)init NS_UNAVAILABLE; + ++ (instancetype)new NS_UNAVAILABLE; + +/** + 单例方式初始化全局唯一对象。单例之后必须马上 setUp + + @return 单例对象 + */ ++ (instancetype)sharedInstance; + +/** + 当前 SDK 初始化。当前功能：注册配置下发服务。 + */ +- (void)setup; + +/** + 上报 payload 类型的数据 + + @param type 监控类型 + @param meta 元数据 + @param payload payload类型的数据 + */ +- (void)sendWithType:(NSString *)type meta:(NSDictionary *)meta payload:(NSData *__nullable)payload; + +/** + 上报 meta 类型的数据，需要传递三个参数。type 表明是什么类型的数据；prefix 代表前缀，上报到后台会拼接 prefix+type；meta 是字典类型的元数据 + + @param type 数据类型 + @param prefix 数据类型的前缀。一般是业务线名称首字母简写。比如记账：JZ + @param meta description元数据 + */ +- (void)sendWithType:(NSString *)type prefix:(NSString *)prefix meta:(NSDictionary *)meta; + +/** + 获取上报相关的通用信息 + + @return 上报基础信息 + */ +- (PCTCommonModel *)getCommon; + +/** + 是否需要采集上报 + + @return 上报开关 + */ +- (BOOL)isGather:(NSString *)namespace; + +@end +``` + +`PrismClient` 类是整个 SDK 的入口，也是接口的提供者。其中 `- (void)sendWithType:(NSString *)type prefix:(NSString *)prefix meta:(NSDictionary *)meta;` 接口给业务方使用。 + +`- (void)sendWithType:(NSString *)type meta:(NSDictionary *)meta payload:(NSData *__nullable)payload;` 给监控数据使用。 + +`setup` 方法内部开启多个 namespace 下的处理 handler。 + +```objective-c +- (void)setup { + // 注册 mget 获取监控和各业务线的配置信息,会产生多个 namespace,彼此平行、隔离 + [[PCTConfigurationService sharedInstance] registerAndFetchConfigurationInfo]; + + [self.configutations enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) { + PCTService *service = [[PCTService alloc] initWithNamespace:obj]; + [self.services setObject:service forKey:obj]; + }]; + PCTService *prismService = [self.services objectForKey:PRISMNAMESPACE]; + if (!prismService) { + prismService = [[PCTService alloc] initWithNamespace:PRISMNAMESPACE]; + [self.services setObject:prismService forKey:PRISMNAMESPACE]; + } +} +``` + +真正处理逻辑的是 `PCTService` 类。这里贴一下代码，点击展开 + +```objective-c +#define PCT_SAVED_FLOW @"PCT_SAVED_FLOW" +#define PCT_SAVED_TIMESTAMP @"PCT_SAVED_TIMESTAMP" + +@interface PCTService () + +@property (nonatomic, copy) NSString *requestBaseUrl; /**<需要配置的baseUrl*/ +@property (nonatomic, copy) PCTConfigurationModel *configureModel; /**<当前 namespace 下的配置信息*/ +@property (nonatomic, copy) NSString *metaURL; /** 0, warning, type); + return; + } + + if (!PCT_IS_CLASS(meta, NSDictionary)) { + return; + } + if (meta.allKeys.count == 0) { + return; + } + + // 2. 判断当前 namespace 是否开启了收集 + if (!self.configureModel.isGather) { + PCTLOG(@"%@", [NSString stringWithFormat:@"Namespace: %@ 下数据收集开关为关闭状态", self.namespace]); + return ; + } + + // 3. 判断是否是有效的数据。可以落库（type 和监控参数的接口中 monitorList 中的任一条目的type 相等） + BOOL isValidate = [self validateLogData:type]; + if (!isValidate) { + return; + } + + // 3. 先写入 meta 表 + PCTCommonModel *commonModel = [[PCTCommonModel alloc] init]; + [self sendWithType:type namespace:PRISMNAMESPACE meta:meta isBiz:NO commonModel:commonModel]; + + // 4. 如果 payload 不存在则退出当前执行 + if (!PCT_IS_CLASS(payload, NSData) && !payload) { + return; + } + + // 5. 添加限制(超过大小的数据就不能入库,因为这是服务端消耗 payload 的一个上限) + CGFloat payloadSize = [self calculateDataSize:payload]; + if (payloadSize > self.configureModel.maxBodyMByte) { + NSString *assertString = [NSString stringWithFormat:@"payload 数据的大小超过临界值 %zdKB", self.configureModel.maxBodyMByte]; + NSAssert(payloadSize <= self.configureModel.maxBodyMByte, assertString); + return; + } + + // 6. 合并 meta 与 Common 基础数据，用来存储 payload 上报所需要的 meta 信息 + NSMutableDictionary *metaDictionary = [NSMutableDictionary dictionary]; + NSDictionary *commonDictionary = [commonModel getDictionary]; + // Crash 类型为特例,外部传入的 Crash 案发现场信息不能被覆盖 + if ([type isEqualToString:@"appCrash"]) { + [metaDictionary addEntriesFromDictionary:commonDictionary]; + [metaDictionary addEntriesFromDictionary:meta]; + } else { + [metaDictionary addEntriesFromDictionary:meta]; + [metaDictionary addEntriesFromDictionary:commonDictionary]; + } + + NSError *error; + NSData *metaData = [NSJSONSerialization dataWithJSONObject:metaDictionary options:0 error:&error]; + if (error) { + PCTLOG(@"%@", error); + return; + } + NSString *metaContentString = [[NSString alloc] initWithData:metaData encoding:NSUTF8StringEncoding]; + + // 7. 计算上报时 payload 这条数据的大小（meta+payload） + NSMutableData *totalData = [NSMutableData data]; + [totalData appendData:metaData]; + [totalData appendData:payload]; + + // 8. 再写入 payload 表 + PCTLogPayloadModel *payloadModel = [[PCTLogPayloadModel alloc] init]; + payloadModel.is_used = NO; + payloadModel.namespace = PRISMNAMESPACE; + payloadModel.report_id = PCT_SAFE_STRING(commonModel.REPORT_ID); + payloadModel.monitor_type = PCT_SAFE_STRING(type); + payloadModel.is_biz = NO; + payloadModel.created_time = PCT_SAFE_STRING(commonModel.CREATE_TIME); + payloadModel.meta = PCT_SAFE_STRING(metaContentString); + payloadModel.payload = payload; + payloadModel.size = totalData.length; + [PCT_DATABASE add:@[payloadModel] inTableType:PCTLogTableTypePayload]; + + // 9. 判断是否触发实时上报 + [self handleUploadDataWithtype:type]; +} + +- (void)sendWithType:(NSString *)type prefix:(NSString *)prefix meta:(NSDictionary *)meta { + // 1. 校验参数合法性 + NSString *prefixWarning = [NSString stringWithFormat:@"%@不能是空字符串", prefix]; + if (!PCT_IS_CLASS(prefix, NSString)) { + NSAssert1(PCT_IS_CLASS(prefix, NSString), prefixWarning, prefix); + return; + } + if (prefix.length == 0) { + NSAssert1(prefix.length > 0, prefixWarning, prefix); + return; + } + + NSString *typeWarning = [NSString stringWithFormat:@"%@不能是空字符串", type]; + if (!PCT_IS_CLASS(type, NSString)) { + NSAssert1(PCT_IS_CLASS(type, NSString), typeWarning, type); + return; + } + if (type.length == 0) { + NSAssert1(type.length > 0, typeWarning, type); + return; + } + + if (!PCT_IS_CLASS(meta, NSDictionary)) { + return; + } + if (meta.allKeys.count == 0) { + return; + } + + // 2. 私有接口处理 is_biz 逻辑 + PCTCommonModel *commonModel = [[PCTCommonModel alloc] init]; + [self sendWithType:type namespace:prefix meta:meta isBiz:YES commonModel:commonModel]; +} + + +#pragma mark - private method + +// 基础配置 +- (void)setupConfig { + _requestBaseUrl = @"https://common.***.com"; + _metaURL = @"prism/metrics/meta"; + _payloadURL = @"prism/metrics/detail"; +} + +- (void)executeHandlerWhenAppLaunched +{ + // 1. 删除非法数据 + [self handleInvalidateData]; + // 2. 回收数据库磁盘碎片空间 + [self rebuildDatabase]; + // 3. 开启定时器去定时上报数据 + [self executeTimedTask]; +} + +/* + 1. 当 App 版本变化的时候删除数据 + 2. 删除过期数据 + 3. 删除 Payload 表里面超过限制的数据 + 4. 删除上传接口网络成功,但是突发 crash 造成没有删除这批数据的情况,所以启动完成后删除 is_used = YES 的数据 + */ +- (void)handleInvalidateData +{ + NSString *currentVersion = [[PrismClient sharedInstance] getCommon].APP_VERSION; + NSString *savedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:PCT_SAVED_APP_VERSION] ?: [currentVersion copy]; + + NSInteger threshold = [NSDate pct_currentTimestamp]; + if (![currentVersion isEqualToString:savedVersion] && self.configureModel.isUpdateClear) { + [[NSUserDefaults standardUserDefaults] setObject:currentVersion forKey:PCT_SAVED_APP_VERSION]; + } else { + threshold = [NSDate pct_currentTimestamp] - self.configureModel.expirationDay * 24 * 60 * 60 *1000; + } + NSInteger sizeUpperLimit = self.configureModel.maxBodyMByte * 1024 * 1024; + NSString *sqlString = [NSString stringWithFormat:@"(created_time < %zd and namespace = '%@') or size > %zd or is_used = 1", threshold, self.namespace, sizeUpperLimit]; + [PCT_DATABASE removeDataUseCondition:sqlString inTableType:PCTLogTableTypeMeta]; + [PCT_DATABASE removeDataUseCondition:sqlString inTableType:PCTLogTableTypePayload]; +} + +// 启动时刻清理数据表空间碎片,回收磁盘大小 +- (void)rebuildDatabase { + [PCT_DATABASE rebuildDatabaseFileInTableType:PCTLogTableTypeMeta]; + [PCT_DATABASE rebuildDatabaseFileInTableType:PCTLogTableTypePayload]; +} + +// 判断数据是否可以落库 +- (BOOL)validateLogData:(NSString *)dataType { + NSArray *monitors = self.configureModel.monitorList; + __block BOOL isValidate = NO; + [monitors enumerateObjectsUsingBlock:^(PCTItemModel *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + if ([obj.type isEqualToString:dataType]) { + isValidate = YES; + *stop = YES; + } + }]; + return isValidate; +} + +- (void)executeTimedTask { + __weak typeof(self) weakself = self; + self.taskExecutor = [[TMLoopTaskExecutor alloc] init]; + TMTaskOption *dataUploadOption = [[TMTaskOption alloc] init]; + dataUploadOption.option = TMTaskRunOptionRuntime; + dataUploadOption.interval = self.configureModel.periodicTimerSecond; + TMTask *dataUploadTask = [[TMTask alloc] init]; + dataUploadTask.runBlock = ^{ + [weakself upload]; + }; + [self.taskExecutor addTask:dataUploadTask option:dataUploadOption]; +} + +- (void)handleUploadDataWithtype:(NSString *)type { + __block BOOL canUploadInTime = NO; + [self.configureModel.monitorList enumerateObjectsUsingBlock:^(PCTItemModel *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + if ([type isEqualToString:obj.type]) { + if (obj.isRealtime) { + canUploadInTime = YES; + *stop = YES; + } + } + }]; + if (canUploadInTime) { + // 节流 + dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(2 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{ + [self upload]; + }); + } +} + +// 对内和对外的存储都走这个流程。通过这个接口设置 is_biz 信息 +- (void)sendWithType:(NSString *)type namespace:(NSString *)namespace meta:(NSDictionary *)meta isBiz:(BOOL)is_biz commonModel:(PCTCommonModel *)commonModel { + // 0. 判断当前 namespace 是否开启了收集 + if (!self.configureModel.isGather) { + PCTLOG(@"%@", [NSString stringWithFormat:@"Namespace: %@ 下数据收集开关为关闭状态", self.namespace]); + return ; + } + + // 1. 检查参数合法性 + NSString *warning = [NSString stringWithFormat:@"%@不能是空字符串", type]; + if (!PCT_IS_CLASS(type, NSString)) { + NSAssert1(PCT_IS_CLASS(type, NSString), warning, type); + return; + } + if (type.length == 0) { + NSAssert1(type.length > 0, warning, type); + return; + } + + if (!PCT_IS_CLASS(meta, NSDictionary)) { + return; + } + if (meta.allKeys.count == 0) { + return; + } + + // 2. 判断是否是有效的数据。可以落库（type 和监控参数的接口中 monitorList 中的任一条目的type 相等） + BOOL isValidate = [self validateLogData:type]; + if (!isValidate) { + return; + } + + // 3. 合并 meta 与 Common 基础数据 + NSMutableDictionary *mutableMeta = [NSMutableDictionary dictionaryWithDictionary:meta]; + mutableMeta[@"MONITOR_TYPE"] = is_biz ? [NSString stringWithFormat:@"%@-%@", namespace, type] : type; + meta = [mutableMeta copy]; + + commonModel.IS_BIZ = is_biz; + NSMutableDictionary *metaDictionary = [NSMutableDictionary dictionary]; + NSDictionary *commonDictionary = [commonModel getDictionary]; + + // Crash 类型为特例,外部传入的 Crash 案发现场信息不能被覆盖 + if ([type isEqualToString:@"appCrash"]) { + [metaDictionary addEntriesFromDictionary:commonDictionary]; + [metaDictionary addEntriesFromDictionary:meta]; + } else { + [metaDictionary addEntriesFromDictionary:meta]; + [metaDictionary addEntriesFromDictionary:commonDictionary]; + } + + // 4. 转换为 NSData + NSError *error; + NSData *metaData = [NSJSONSerialization dataWithJSONObject:metaDictionary options:0 error:&error]; + if (error) { + PCTLOG(@"%@", error); + return; + } + + // 5. 添加限制(超过 10K 的数据就不能入库,因为这是服务端消耗 meta 的一个上限) + CGFloat metaSize = [self calculateDataSize:metaData]; + if (metaSize > 10 / 1024.0) { + NSAssert(metaSize <= 10 / 1024.0, @"meta 数据的大小超过临界值 10KB"); + return; + } + + NSString *metaContentString = [[NSString alloc] initWithData:metaData encoding:NSUTF8StringEncoding]; + + // 6. 构造 MetaModel 模型 + PCTLogMetaModel *metaModel = [[PCTLogMetaModel alloc] init]; + metaModel.namespace = namespace; + metaModel.report_id = PCT_SAFE_STRING(commonModel.REPORT_ID); + metaModel.monitor_type = PCT_SAFE_STRING(type); + metaModel.created_time = PCT_SAFE_STRING(commonModel.CREATE_TIME); + metaModel.meta = PCT_SAFE_STRING(metaContentString); + metaModel.size = metaData.length; + metaModel.is_biz = is_biz; + + // 7. 写入数据库 + [PCT_DATABASE add:@[metaModel] inTableType:PCTLogTableTypeMeta]; + + // 8. 判断是否触发实时上报（对内的接口则在函数内部判断，如果是对外的则在这里判断） + if (is_biz) { + [self handleUploadDataWithtype:type]; + } +} + +- (BOOL)needUploadPayload:(PCTLogPayloadModel *)model { + __block BOOL needed = NO; + [self.configureModel.monitorList enumerateObjectsUsingBlock:^(PCTItemModel *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + if ([obj.type isEqualToString:model.monitor_type] && obj.isUploadPayload) { + needed = YES; + *stop = YES; + } + }]; + return needed; +} + +/* + 计算 数据包大小，分为2种情况。 + 1. 上传前使用数据表中的 size 字段去判断大小 + 2. 上报完成后则根据真实网络通信中组装的 payload 进行大小计算 + */ +- (float)calculateDataSize:(id)data { + if (PCT_IS_CLASS(data, NSArray)) { + __block NSInteger dataLength = 0; + NSArray *uploadDatasource = (NSArray *)data; + [uploadDatasource enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + if (PCT_IS_CLASS(obj, PCTLogModel)) { + PCTLogModel *uploadModel = (PCTLogModel *)obj; + dataLength += uploadModel.size; + } + }]; + return dataLength / (1024 * 1024.0); + } else if (PCT_IS_CLASS(data, NSData)) { + NSData *rawData = (NSData *)data; + return rawData.length / (1024 * 1024.0); + } else { + return 0; + } +} + +// 上报流程的主函数 +- (void)upload { + /* + 1. 判断能否上报 + 2. 数据聚合 + 3. 加密压缩 + 4. 1分钟内的网络请求合并为1次 + 5. 上报(全局上报开关是开着的情况) + - 成功：删除本地数据、调用更新策略的接口 + - 失败：不删除本地数据 + */ + [self judgeCanUploadCompletionBlock:^(BOOL canUpload, NetworkingManagerStatusType networkType) { + if (canUpload && self.configureModel.isUpload) { + [self handleUploadTask:networkType]; + } + }]; +} + +/** + 上报前的校验 + - 判断网络情况，分为 wifi 和 非 Wi-Fi 、网络不通的情况。 + - 从配置下发的 monitorList 找出 onlyWifi 字段为 true 的 type，组成数组 [appCrash、appLag...] + - 网络不通，则不能上报 + - 网络通，则判断上报校验 + 1. 当前GMT时间戳-保存的时间戳超过24h。则认为是一个新的自然天 + - 清除 currentFlow + - 触发上报流程 + 2. 当前GMT时间戳-保存的时间戳不超过24h + - 当前的流量是否超过配置信息里面的最大流量，未超过（<）：触发上报流程 + - 当前的流量是否超过配置信息里面的最大流量，超过：结束流程 + */ +- (void)judgeCanUploadCompletionBlock:(void (^)(BOOL canUpload, NetworkingManagerStatusType networkType))completionBlock { + // WIFI 的情况下不判断直接上传；不是 WIFI 的情况需要判断「当日最大限制流量」 + [self.requester networkStatusWithBlock:^(NetworkingManagerStatusType status) { + switch (status) { + case NetworkingManagerStatusUnknown: { + PCTLOG(@"没有网络权限哦"); + if (completionBlock) { + completionBlock(NO, NetworkingManagerStatusUnknown); + } + break; + } + case NetworkingManagerStatusNotReachable: { + if (completionBlock) { + completionBlock(NO, NetworkingManagerStatusNotReachable); + } + break; + } + case NetworkingManagerStatusReachableViaWiFi: { + if (completionBlock) { + completionBlock(YES, NetworkingManagerStatusReachableViaWiFi); + } + break; + } + case NetworkingManagerStatusReachableViaWWAN: { + if ([self currentGMTStyleTimeStamp] - self.currentTimestamp.integerValue > 24 * 60 * 60 * 1000) { + self.currentFlow = [NSNumber numberWithFloat:0]; + self.currentTimestamp = [NSNumber numberWithInteger:[self currentGMTStyleTimeStamp]]; + if (completionBlock) { + completionBlock(YES, NetworkingManagerStatusReachableViaWWAN); + } + } else { + if (self.currentFlow.floatValue < self.configureModel.maxFlowMByte) { + if (completionBlock) { + completionBlock(YES, NetworkingManagerStatusReachableViaWWAN); + } + } else { + if (completionBlock) { + completionBlock(NO, NetworkingManagerStatusReachableViaWWAN); + } + } + } + break; + } + } + }]; +} + +- (void)handleUploadTask:(NetworkingManagerStatusType)networkType { + // 数据聚合（2张表分别扫描） -> 压缩 -> 上报 + [self handleUploadTaskInMetaTable:networkType]; + [self handleUploadTaskInPayloadTable:networkType]; +} + +- (void)handleUploadTaskInMetaTable:(NetworkingManagerStatusType)networkType { + __weak typeof(self) weakself = self; + // 1. 数据聚合 + [self assembleDataInTable:PCTLogTableTypeMeta + networkType:networkType + completion:^(NSArray *records) { + if (records.count == 0) { + return; + } + // 2. 加密压缩处理：（meta 整体先加密再压缩，payload一条条先加密再压缩） + __block NSMutableString *metaStrings = [NSMutableString string]; + __block NSMutableArray *usedReportIds = [NSMutableArray array]; + + // 2.1. 遍历拼接model，取出 meta，用 \n 拼接 + [records enumerateObjectsUsingBlock:^(PCTLogModel *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + if (PCT_IS_CLASS(obj, PCTLogMetaModel)) { + PCTLogMetaModel *metaModel = (PCTLogMetaModel *)obj; + BOOL shouldAppendLineBreakSymbol = idx < (records.count - 1); + [usedReportIds addObject:[NSString stringWithFormat:@"'%@'", metaModel.report_id]]; + [metaStrings appendString:[NSString stringWithFormat:@"%@%@", metaModel.meta, shouldAppendLineBreakSymbol ? @"\n" : @""]]; + } + }]; + if (metaStrings.length == 0) { + return; + } + // 2.2 拼接后的内容先压缩再加密 + NSData *data = [PCTDataSerializer compressAndEncryptWithString:metaStrings]; + + // 3. 将取出来用于接口请求的数据标记为 dirty + NSString *updateCondtion = [NSString stringWithFormat:@"report_id in (%@)", [usedReportIds componentsJoinedByString:@","]]; + [[PCTDatabase sharedInstance] updateData:@"is_used = 1" useCondition:updateCondtion inTableType:PCTLogTableTypeMeta]; + + // 4. 请求网络 + NSString *requestURL = [NSString stringWithFormat:@"%@/%@", weakself.requestBaseUrl, weakself.metaURL]; + + [weakself.requester postDataWithRequestURL:requestURL + bodyData:data + success:^{ + [weakself deleteInvalidateData:records inTableType:PCTLogTableTypeMeta]; + if (networkType == NetworkingManagerStatusReachableViaWWAN) { + float currentFlow = [weakself.currentFlow floatValue]; + currentFlow += [weakself calculateDataSize:data]; + weakself.currentFlow = [NSNumber numberWithFloat:currentFlow]; + } + } + failure:^(NSError *_Nonnull error) { + [[PCTDatabase sharedInstance] updateData:@"is_used = 0" useCondition:updateCondtion inTableType:PCTLogTableTypeMeta]; + if (networkType == NetworkingManagerStatusReachableViaWWAN) { + float currentFlow = [weakself.currentFlow floatValue]; + currentFlow += [weakself calculateDataSize:data]; + weakself.currentFlow = [NSNumber numberWithFloat:currentFlow]; + } + }]; + }]; +} + +- (NSData *)handlePayloadData:(NSArray *)rawArray { + // 1. 数据校验 + if (rawArray.count == 0) { + return nil; + } + // 2. 加密压缩处理：（meta 整体先加密再压缩，payload一条条先加密再压缩） + __block NSMutableString *metaStrings = [NSMutableString string]; + __block NSMutableArray *payloads = [NSMutableArray array]; + + + // 2.1. 遍历拼接model，取出 meta，用 \n 拼接 + [rawArray enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + if (PCT_IS_CLASS(obj, PCTLogPayloadModel)) { + PCTLogPayloadModel *payloadModel = (PCTLogPayloadModel *)obj; + BOOL shouldAppendLineBreakSymbol = idx < (rawArray.count - 1); + + [metaStrings appendString:[NSString stringWithFormat:@"%@%@", PCT_SAFE_STRING(payloadModel.meta), shouldAppendLineBreakSymbol ? @"\n" : @""]]; + + // 2.2 判断是否需要上传 payload 信息。如果需要则将 payload 取出。 + if ([self needUploadPayload:payloadModel]) { + if (payloadModel.payload) { + NSData *payloadData = [PCTDataSerializer compressAndEncryptWithData:payloadModel.payload]; + if (payloadData) { + [payloads addObject:payloadData]; + } + } + } + } + }]; + + NSData *metaData = [PCTDataSerializer compressAndEncryptWithString:metaStrings]; + + __block NSMutableData *headerData = [NSMutableData data]; + unsigned short metaLength = (unsigned short)metaData.length; + HTONS(metaLength); // 处理2字节的大端序 + [headerData appendData:[NSData dataWithBytes:&metaLength length:sizeof(metaLength)]]; + + Byte payloadCountbytes[] = {payloads.count}; + NSData *payloadCountData = [[NSData alloc] initWithBytes:payloadCountbytes length:sizeof(payloadCountbytes)]; + [headerData appendData:payloadCountData]; + + [payloads enumerateObjectsUsingBlock:^(NSData *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + unsigned int payloadLength = (unsigned int)obj.length; + HTONL(payloadLength); // 处理4字节的大端序 + [headerData appendData:[NSData dataWithBytes:&payloadLength length:sizeof(payloadLength)]]; + }]; + + __block NSMutableData *uploadData = [NSMutableData data]; + // 先添加 header 基础信息，不需要加密压缩 + [uploadData appendData:[headerData copy]]; + // 再添加 meta 信息，meta 信息需要先压缩再加密 + [uploadData appendData:metaData]; + // 再添加 payload 信息 + [payloads enumerateObjectsUsingBlock:^(NSData *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + [uploadData appendData:obj]; + }]; + return [uploadData copy]; +} + +- (void)handleUploadTaskInPayloadTable:(NetworkingManagerStatusType)networkType { + __weak typeof(self) weakself = self; + // 1. 数据聚合 + [self assembleDataInTable:PCTLogTableTypePayload + networkType:networkType + completion:^(NSArray *records) { + if (records.count == 0) { + return; + } + // 2. 取出可以上传的 payload 数据 + NSArray *canUploadPayloadData = [self fetchDataCanUploadPayload:records]; + + if (canUploadPayloadData.count == 0) { + return; + } + + // 3. 将取出来用于接口请求的数据标记为 dirty + __block NSMutableArray *usedReportIds = [NSMutableArray array]; + [canUploadPayloadData enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) { + if (PCT_IS_CLASS(obj, PCTLogModel)) { + PCTLogModel *model = (PCTLogModel *)obj; + [usedReportIds addObject:[NSString stringWithFormat:@"'%@'", model.report_id]]; + } + }]; + NSString *updateCondtion = [NSString stringWithFormat:@"report_id in (%@)", [usedReportIds componentsJoinedByString:@","]]; + + [[PCTDatabase sharedInstance] updateData:@"is_used = 1" useCondition:updateCondtion inTableType:PCTLogTableTypePayload]; + + // 4. 将取出的数据聚合，组成报文 + NSData *uploadData = [self handlePayloadData:canUploadPayloadData]; + + // 5. 请求网络 + NSString *requestURL = [NSString stringWithFormat:@"%@/%@", weakself.requestBaseUrl, weakself.payloadURL]; + + [weakself.requester postDataWithRequestURL:requestURL + bodyData:uploadData + success:^{ + [weakself deleteInvalidateData:canUploadPayloadData inTableType:PCTLogTableTypePayload]; + if (networkType == NetworkingManagerStatusReachableViaWWAN) { + float currentFlow = [weakself.currentFlow floatValue]; + currentFlow += [weakself calculateDataSize:uploadData]; + weakself.currentFlow = [NSNumber numberWithFloat:currentFlow]; + } + } + failure:^(NSError *_Nonnull error) { + [[PCTDatabase sharedInstance] updateData:@"is_used = 0" useCondition:updateCondtion inTableType:PCTLogTableTypePayload]; + if (networkType == NetworkingManagerStatusReachableViaWWAN) { + float currentFlow = [weakself.currentFlow floatValue]; + currentFlow += [weakself calculateDataSize:uploadData]; + weakself.currentFlow = [NSNumber numberWithFloat:currentFlow]; + } + }]; + }]; +} + +// 清除过期数据 +- (void)deleteInvalidateData:(NSArray *)data inTableType:(PCTLogTableType)tableType { + [PCT_DATABASE remove:data inTableType:tableType]; +} + +// 以秒为单位的时间戳 +- (NSInteger)currentGMTStyleTimeStamp { + return [NSDate pct_currentTimestamp]/1000; +} + +#pragma mark-- 数据库操作 + +/** + 根据接口配置信息中的条件获取表中的上报数据 + - Wi-Fi 的时候都上报 + - 不为 Wi-Fi 的时候：onlyWifi 为 false 的类型进行上报 + */ +- (void)assembleDataInTable:(PCTLogTableType)tableType networkType:(NetworkingManagerStatusType)networkType completion:(void (^)(NSArray *records))completion { + // 1. 获取到合适的 Crash 类型的数据 + [self fetchCrashDataByCount:self.configureModel.maxFlowMByte + inTable:tableType + upperBound:self.configureModel.maxBodyMByte + completion:^(NSArray *records) { + NSArray *crashData = records; + // 2. 计算剩余需要的数据条数和剩余需要的数据大小 + NSInteger remainingCount = self.configureModel.maxItem - crashData.count; + float remainingSize = self.configureModel.maxBodyMByte - [self calculateDataSize:crashData]; + // 3. 获取除 Crash 类型之外的其他数据，且需要符合相应规则 + BOOL isWifi = (networkType == NetworkingManagerStatusReachableViaWiFi); + [self fetchDataExceptCrash:remainingCount + inTable:tableType + upperBound:remainingSize + isWiFI:isWifi + completion:^(NSArray *records) { + NSArray *dataExceptCrash = records; + + NSMutableArray *dataSource = [NSMutableArray array]; + [dataSource addObjectsFromArray:crashData]; + [dataSource addObjectsFromArray:dataExceptCrash]; + if (completion) { + completion([dataSource copy]); + } + }]; + }]; +} + + +- (NSArray *)fetchDataCanUploadPayload:(NSArray *)datasource { + __weak typeof(self) weakself = self; + __block NSMutableArray *array = [NSMutableArray array]; + if (!PCT_IS_CLASS(datasource, NSArray)) { + NSAssert(PCT_IS_CLASS(datasource, NSArray), @"参数必须是数组"); + return nil; + } + [datasource enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { + if (PCT_IS_CLASS(obj, PCTLogPayloadModel)) { + PCTLogPayloadModel *payloadModel = (PCTLogPayloadModel *)obj; + // 判断是否需要上传 payload 信息 + if ([weakself needUploadPayload:payloadModel]) { + [array addObject:payloadModel]; + } + } + }]; + return [array copy]; +} + +// 递归获取符合条件的 Crash 数据集合（count < maxItem && size < maxBodySize） +- (void)fetchCrashDataByCount:(NSInteger)count inTable:(PCTLogTableType)tableType upperBound:(NSInteger)size completion:(void (^)(NSArray *records))completion { + // 1. 先通过接口拿到的 maxItem 数去查询表中的 Crash 数据集合 + NSString *queryCrashDataCondition = [NSString stringWithFormat:@"monitor_type = 'appCrash' and is_used = 0 and namespace = '%@'", self.namespace]; + [PCT_DATABASE getRecordsByCount:count + condtion:queryCrashDataCondition + inTableType:tableType + completion:^(NSArray *_Nonnull records) { + // 2. Crash 数据集合大小是否超过配置接口拿到的最大包体积（单位M） maxBodySize + float dataSize = [self calculateDataSize:records]; + + // 3. 大于最大包体积则递归获取 maxItem-- 条 Crash 数据集合并判断数据大小 + if (size == 0) { + if (completion) { + completion(records); + } + } else if (dataSize > size) { + NSInteger currentCount = count - 1; + [self fetchCrashDataByCount:currentCount inTable:tableType upperBound:size completion:completion]; + } else { + if (completion) { + completion(records); + } + } + }]; +} + +- (void)fetchDataExceptCrash:(NSInteger)count inTable:(PCTLogTableType)tableType upperBound:(float)size isWiFI:(BOOL)isWifi completion:(void (^)(NSArray *records))completion { + // 1. 根据剩余需要数据条数去查询表中非 Crash 类型的数据集合 + __block NSMutableArray *conditions = [NSMutableArray array]; + [self.configureModel.monitorList enumerateObjectsUsingBlock:^(PCTItemModel * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) { + if (isWifi) { + if (![obj.type isEqualToString:@"appCrash"]) { + [conditions addObject:[NSString stringWithFormat:@"'%@'", obj.type]]; + } + } else { + if (!obj.onlyWifi && ![obj.type isEqualToString:@"appCrash"]) { + [conditions addObject:[NSString stringWithFormat:@"'%@'", PCT_SAFE_STRING(obj.type)]]; + } + } + }]; + NSString *queryCrashDataCondition = [NSString stringWithFormat:@"monitor_type in (%@) and is_used = 0 and namespace = '%@'", [conditions componentsJoinedByString:@","], self.namespace]; + + // 2. 根据是否有 Wifi 查找对应的数据 + [PCT_DATABASE getRecordsByCount:count + condtion:queryCrashDataCondition + inTableType:tableType + completion:^(NSArray *_Nonnull records) { + // 3. 非 Crash 类型的数据集合大小是否超过剩余需要的数据大小 + float dataSize = [self calculateDataSize:records]; + + // 4. 大于最大包体积则递归获取 maxItem-1 条非 Crash 数据集合并判断数据大小 + if (size == 0) { + if (completion) { + completion(records); + } + } else if (dataSize > size) { + NSInteger currentCount = count - 1; + return [self fetchDataExceptCrash:currentCount inTable:tableType upperBound:size isWiFI:isWifi completion:completion]; + } else { + if (completion) { + completion(records); + } + } + }]; +} + + +#pragma mark - getters and setters + +- (PCTRequestFactory *)requester { + if (!_requester) { + _requester = [[PCTRequestFactory alloc] init]; + } + return _requester; +} + +- (NSNumber *)currentTimestamp { + if (!_currentTimestamp) { + NSInteger currentTimestampValue = [[NSUserDefaults standardUserDefaults] integerForKey:PCT_SAVED_TIMESTAMP]; + _currentTimestamp = [NSNumber numberWithInteger:currentTimestampValue]; + } + return _currentTimestamp; +} + +- (void)setCurrentTimestamp:(NSNumber *)currentTimestamp { + [[NSUserDefaults standardUserDefaults] setInteger:[currentTimestamp integerValue] forKey:PCT_SAVED_TIMESTAMP]; + _currentTimestamp = currentTimestamp; +} + +- (NSNumber *)currentFlow { + if (!_currentFlow) { + float currentFlowValue = [[NSUserDefaults standardUserDefaults] floatForKey:PCT_SAVED_FLOW]; + _currentFlow = [NSNumber numberWithFloat:currentFlowValue]; + } + return _currentFlow; +} + +- (void)setCurrentFlow:(NSNumber *)currentFlow { + [[NSUserDefaults standardUserDefaults] setFloat:[currentFlow floatValue] forKey:PCT_SAVED_FLOW]; + _currentFlow = currentFlow; +} + +- (PCTConfigurationModel *)configureModel +{ + return [[PCTConfigurationService sharedInstance] getConfigurationWithNamespace:self.namespace]; +} + +- (NSString *)requestBaseUrl +{ + return self.configureModel.url ? self.configureModel.url : @"https://common.***.com"; +} + +- (BOOL)isAppLaunched +{ + id isAppLaunched = [[PrismClient sharedInstance] valueForKey:@"isAppLaunched"]; + return [isAppLaunched boolValue]; +} + +@end +``` + + + +## 六、 总结与思考 + +### 1. 技术方面 + +多线程技术很强大，但是很容易出问题。普通做业务的时候用一些简单的 GCD、NSOperation 等就可以满足基本需求了，但是做 SDK 就不一样，你需要考虑各种场景。比如 FMDB 在多线程读写的时候，设计了 FMDatabaseQueue 以串行队列的方式同步执行任务。但是这样一来假如使用者在主线程插入 n 次数据到数据库，这样会发生 ANR，所以我们还得维护一个任务派发队列，用来维护业务方提交的任务，是一个并发队列，以异步任务的方式提交给 FMDB 以同步任务的方式在串行队列上执行。 + +AFNetworking 2.0 使用了 NSURLConnection，同时维护了一个常驻线程，去处理网络成功后的回调。AF 存在一个常驻线程，假如其他 n 个 SDK 的其中 m 个 SDK 也开启了常驻线程，那你的 App 集成后就有 1+m 个常驻线程。 + +AFNetworking 3.0 使用 NSURLSession 替换 NSURLConnection，取消了常驻线程。为什么换了？ 😂 逼不得已呀，Apple 官方出了 NSURLSession，那就不需要 NSURLConnection，并为之创建常驻线程了。至于为什么 NSURLSession 不需要常驻线程？它比 NSURLConnecction 多做了什么，以后再聊 + +创建线程的过程，需要用到物理内存，CPU 也会消耗时间。新建一个线程，系统会在该进程空间分配一定的内存作为线程堆栈。堆栈大小是 4KB 的倍数。在 iOS 主线程堆栈大小是 1MB，新创建的子线程堆栈大小是 512KB。此外线程创建得多了，CPU 在切换线程上下文时，还会更新寄存器，更新寄存器的时候需要寻址，而寻址的过程有 CPU 消耗。线程过多时内存、CPU 都会有大量的消耗，出现 ANR 甚至被强杀。 + +举了 🌰 是 FMDB 和 AFNetworking 的作者那么厉害，设计的 FMDB 不包装会 ANR，AFNetworking 必须使用常驻线程，为什么？正是由于多线程太强大、灵活了，开发者骚操作太多，所以 FMDB 设计最简单保证数据库操作线程安全，具体使用可以自己维护队列去包一层。AFNetworking 内的多线程也严格基于系统特点来设计。 + +所以有必要再研究下多线程，建议读 GCD 源码，也就是 [libdispatch](https://opensource.apple.com/tarballs/libdispatch/) + + + +### 2. 规范方面 + +很多开发都不做测试，我们公司都严格约定测试。写基础 SDK 更是如此，一个 App 基础功能必须质量稳定，所以测试是保证手段之一。一定要写好 Unit Test。这样子不断版本迭代，对于 UT，输入恒定，输出恒定，这样内部实现如何变动不需要关心，只需要判断恒定输入，恒定输出就足够了。（针对每个函数单一原则的基础上也是满足 UT）。还有一个好处就是当和别人讨论的的时候，你画个技术流程图、技术架构图、测试的 case、测试输入、输出表述清楚，听的人再看看边界情况是否都考虑全，基本上很快沟通完毕，效率考高。 + +在做 SDK 的接口设计的时候，方法名、参数个数、参数类型、参数名称、返回值名称、类型、数据结构，尽量要做到 iOS 和 Android 端一致，除非某些特殊情况，无法保证一致的输出。别问为什么？好处太多了，成熟 SDK 都这么做。 + + + +比如一个数据上报 SDK。需要考虑数据来源是什么，我设计的接口需要暴露什么信息，数据如何高效存储、数据如何校验、数据如何高效及时上报。 假如我做的数据上报 SDK 可以上报 APM 监控数据、同时也开放能力给业务线使用，业务线自己将感兴趣的数据并写入保存，保证不丢失的情况下如何高效上报。因为数据实时上报，所以需要考虑上传的网络环境、Wi-Fi 环境和 4G 环境下的逻辑不一样的、数据聚合组装成自定义报文并上报、一个自然天内数据上传需要做流量限制等等、App 版本升级一些数据可能会失去意义、当然存储的数据也存在时效性。种种这些东西就是在开发前需要考虑清楚的。所以基础平台做事情基本是 **设计思考时间：编码时间 = 7:3**。 + + 为什么？假设你一个需求，预期10天时间；前期架构设计、类的设计、Uint Test 设计估计7天，到时候编码开发2天完成。 这么做的好处很多，比如： + +1. 除非是非常优秀，不然脑子想的再前面到真正开发的时候发现有出入，coding 完发现和前期方案设计不一样。所以建议用流程图、UML图、技术架构图、UT 也一样，设计个表格，这样等到时候编码也就是 coding 的工作了，将图翻译成代码 + +2. 后期和别人讨论或者沟通或者 CTO 进行 code review 的时候不需要一行行看代码。你将相关的架构图、流程图、UML 图给他看看。他再看看一些关键逻辑的 UT，保证输入输出正确，一般来说这样就够了 + + + +### 3. 质量保证 + +UT 是质量保证的一个方面，另一个就是 MR 机制。我们团队 MR 采用 `+1` 机制。每个 merge request 必须有团队内至少3个人 +1，且其中一人必须为同技术栈且比你资深一些的同事 +1，一人为和你参加同一个项目的同事。 + +当有人评论或者有疑问时，你必须解答清楚，别人提出的修改点要么修改好，要么解释清楚，才可以 +1。当 +1 数大于3，则合并分支代码。 + +连带责任制。当你的线上代码存在 bug 时，为你该次 MR +1 的同事具有连带责任。 + + + + + + + +## 参考资料 + +- [WAL](https://en.wikipedia.org/wiki/Write-ahead_logging) +- [WCDB 的 WAL 模式和异步 Checkpoint](https://cloud.tencent.com/developer/article/1031030) + + + + - diff --git a/Chapter1 - iOS/collection.md b/Chapter1 - iOS/collection.md new file mode 100644 index 0000000..f5ea797 --- /dev/null +++ b/Chapter1 - iOS/collection.md @@ -0,0 +1,124 @@ + + +# APM + +内存泄露检测 +各家都是基于 Facebook 的 FBRetainCycleDetector 实现，有： +腾讯 MLeaksFinder +https://github.com/Tencent/MLeaksFinder +PLeakSniffer +https://github.com/music4kid/PLeakSniffer +LeaksMonitor +https://github.com/tripleCC/Laboratory/tree/master/LeaksMonitor + +ANR 检测 +ANR 检测相对比较简单，各家原理基本相同。新建一个 thread 在 threshold 的间隔时间内（一般 200 - 400毫秒）循环等待一个 semaphore，并从主线程 async dispatch semaphore 的 signal 函数，如果超时则报卡顿。 +1. https://gist.github.com/leilee/3275b94c381114332242978fc4366591 +2. https://gist.github.com/Adlai-Holler/ea7e3e98333b3b84f13d19b169ccf989 +1. https://gist.github.com/mikeash/5172803 这个是纯 GCD 的实现 +2. https://gist.github.com/steipete/5664345 PFPDFKit 里用的是这个 +3. https://gist.github.com/jspahrsummers/419266f5231832602bec GitHub 客户端里用的 +4. https://github.com/wojteklu/Watchdog 这个有用 atomic_store 和 atomic_load 实现死锁回调 +5. DoKit +8. https://github.com/ming1016/study/wiki/检测iOS的APP性能的一些方法 +启动优化 +《Reducing Your App's Launch Time》- Apple +https://developer.apple.com/documentation/xcode/improving_your_app_s_performance/reducing_your_app_s_launch_time +《抖音研发实践：基于二进制文件重排的解决方案 APP启动速度提升超15%》 +https://mp.weixin.qq.com/s?__biz=MzI1MzYzMjE0MQ==&mid=2247485101&idx=1&sn=abbbb6da1aba37a04047fc210363bcc9&scene=21#wechat_redirect +// 这种纬度的启动时间优化对小公司来说 ROI 太低 +《美团外卖 iOS App 冷启动治理》 +https://tech.meituan.com/2018/12/06/waimai-ios-optimizing-startup.html + +测量进程的 uptime +https://github.com/tripleCC/Laboratory/blob/master/ProcessStartTime/ProcessStartTime/main.m +https://stackoverflow.com/questions/40649964/ios-get-self-process-start-time-after-the-fact/40677286 + +滴滴出行 DoraemonKit +https://github.com/didi/DoraemonKit +功能非常多，感觉侧重了 UI 的运行时调试。APM 的部分主要依赖第三方库，如 MLeakFinder。有提供问题上报机制，所以会有不少额外的网络请求发送到 dokit 的API。 + +腾讯 Matrix +https://github.com/tencent/matrix +功能精简，只有 ANR 和内存检测。 + +美图秀秀 MTHawkeye +https://github.com/meitu/MTHawkeye/tree/develop/MTHawkeye +监控项目比 DoKit 多，ANR 中能看到主线程堆栈信息，网络层有做一些基本优化指标的监控。 + +阿里巴巴 GodEye +https://github.com/zixun/GodEye +项目已经三年没有维护，不过作者的小专栏有提供整体思路，值得参考学习。https://xiaozhuanlan.com/godeye + + + + + +# 技术博客 + +AloneMonkey http://www.alonemonkey.com/ https://github.com/AloneMonkey #ios #re +yulingtianxia https://yulingtianxia.com/ https://github.com/yulingtianxia #ios #ml +SatanWoo http://satanwoo.github.io/ https://github.com/SatanWoo #ios #ml +Naville Zhang https://mayuyu.io/ https://github.com/Naville #ios #re #llvm +Cocoa Oikawa https://blog.0xbbc.com/ https://github.com/BlueCocoa #ios +jmpews https://jmpews.github.io https://github.com/jmpews #ios #re +kov4l3nko https://kov4l3nko.github.io https://github.com/kov4l3nko #ios +mikeash https://www.mikeash.com/pyblog/ #ios +NSBLOGGING https://kandelvijaya.com/post/ #ios +4ch12dy http://4ch12dy.site/ https://github.com/4ch12dy +ibireme https://blog.ibireme.com/ https://github.com/ibireme/ #ios +bang http://blog.cnbang.net/ https://github.com/bang590 #ios +everettjf https://everettjf.github.io/ https://github.com/everettjf #ios #re +Gityuan http://gityuan.com/ #android #flutter +Meituan https://tech.meituan.com/ #ios #android #company +draveness https://draveness.me/ #ios #golang +chy305chy https://chy305chy.github.io/ #ios +Urinx https://urinx.github.io/v6/ https://github.com/Urinx #ios #re +bdunagan http://bdunagan.com/ #ios +la0s https://la0s.github.io/ #re #ios +caijinglong https://www.kikt.top/ #flutter +weishu http://weishu.me/ https://github.com/tiann #android #re +zixia https://github.com/huan #ml #re +xelz https://github.com/xelzmm http://xelz.info/ #re +ChiChou https://github.com/ChiChou https://blog.chichou.me/ #re + + + +# 学习 + +# 资料 +* 经典WWDC视频 + [WWDC2016:Optimizing App Startup Time](https://developer.apple.com/videos/play/wwdc2016/406) + [WWDC2016:Optimizing I/O for Performance and Battery Life](https://developer.apple.com/videos/play/wwdc2016/719/) + [WWDC2017:App Startup Time: Past, Present, and Future](https://developer.apple.com/videos/play/wwdc2017/413/) +* 图片的加载过程 + [Core Image: Performance, Prototyping, and Python](https://developer.apple.com/videos/play/wwdc2018/719/) +* Facebook的二进制优化，开拓思路 + [通过优化二进制布局提升iOS启动性能](https://www.bilibili.com/video/BV1NJ411w7hv) + + +# 文章 +[如何对 iOS 启动阶段耗时进行分析](https://ming1016.github.io/2019/12/07/how-to-analyze-startup-time-cost-in-ios/) +[objc_msgSend Hook 精简学习过程](https://linux.ctolib.com/czqasngit-objc_msgSend_hook.html) +[如何对 iOS 启动阶段耗时进行分析](http://www.starming.com/2019/12/07/how-to-analyze-startup-time-cost-in-ios/) +[App 启动速度怎么做优化与监控？](https://time.geekbang.org/column/article/85331) +[监控所有的OC方法耗时](https://juejin.im/post/5d146490f265da1bc37f2065) +[Hook objc_msgSend to hotfix](https://www.dazhuanlan.com/2019/10/18/5da8a4b2a7da7/) + +[iOS App启动优化（一）—— 了解App的启动流程](https://juejin.im/post/5da830a4e51d457805049817) +[iOS App启动优化（二）—— 使用“Time Profiler”工具监控App的启动耗时](https://juejin.im/post/5dad6bfb6fb9a04de818fcb8) +[iOS App启动优化（三）—— 自己做一个工具监控App的启动耗时](https://juejin.im/post/5de501e0e51d4540a15879ff) + + +* facebook的启动优化（2015年的老文章） +[Optimizing Facebook for iOS start time](https://engineering.fb.com/ios/optimizing-facebook-for-ios-start-time/) + +[优化 App 的启动时间](http://yulingtianxia.com/blog/2016/10/30/Optimizing-App-Startup-Time/#%E5%AE%89%E5%85%A8) +[深入理解App的启动过程](https://github.com/LeoMobileDeveloper/Blogs/blob/master/iOS/What%20happened%20at%20startup%20time.md) +[iOS启动速度优化](https://github.com/BiBoyang/BoyangBlog/blob/master/File/iOS_APM_03.md) +[iOS app启动速度研究实践](https://zhuanlan.zhihu.com/p/38183046?from=1086193010&wm=3333_2001&weiboauthoruid=1690182120) +[iOS Dynamic Framework 对App启动时间影响实测](https://www.jianshu.com/p/3263009e9228) +[iOS App 启动性能优化](https://mp.weixin.qq.com/s/Kf3EbDIUuf0aWVT-UCEmbA) +[今日头条iOS客户端启动速度优化](https://juejin.im/entry/5b6061bef265da0f574dfd21) +[如何精确度量 iOS App 的启动时间](https://www.jianshu.com/p/c14987eee107) +[ iOS App冷启动治理：来自美团外卖的实践 ](https://mp.weixin.qq.com/s/jN3jaNrvXczZoYIRCWZs7w) \ No newline at end of file diff --git a/Chapter2 - Web FrontEnd/2.40.md b/Chapter2 - Web FrontEnd/2.40.md index 8425f77..54d09ed 100644 --- a/Chapter2 - Web FrontEnd/2.40.md +++ b/Chapter2 - Web FrontEnd/2.40.md @@ -178,7 +178,7 @@ electron 分为**渲染进程和主进程**。和 Native 中的概念不一样 -**解决了不稳定问题。**由于进程之间是彼此隔离的，所以当一个页面或者插件奔溃时，受影响的仅仅是当前的页面或者插件进程，并不会影响到浏览器和其他的页面。也就是说解决了早期浏览器某个页面或者插件奔溃导致整个浏览器的奔溃，从而解决了不稳定问题。 +**解决了不稳定问题**。由于进程之间是彼此隔离的，所以当一个页面或者插件奔溃时，受影响的仅仅是当前的页面或者插件进程，并不会影响到浏览器和其他的页面。也就是说解决了早期浏览器某个页面或者插件奔溃导致整个浏览器的奔溃，从而解决了不稳定问题。 **解决了不流畅问题。** 同样，Javascript 进行也是运行在渲染进程中的，所以即使当前 Javascript 阻塞了渲染进程，影响到的也只是当前的渲染页面，并不会影响到浏览器和其他页面或者插件进程（其他的页面的脚本是运行在自己的渲染进程中的）。 @@ -221,7 +221,7 @@ Chrome 团队一直在寻求新的弹性方案，既可以解决资源占用较 #### 1.4 未来面向服务的架构 -2016年 Chrome 官方团队使用 “**面向服务的架构**”（Services Oriented Architecture，简称 SOA）的思想设计了最新的 Chrome 架构。Chrome 整体架构会向现代操作系统所采用的“面向服务的架构”方向发展。 +2016年 Chrome 官方团队使用“**面向服务的架构**”（Services Oriented Architecture，简称 SOA）的思想设计了最新的 Chrome 架构。Chrome 整体架构会向现代操作系统所采用的“面向服务的架构”方向发展。 之前的各种模块会被重构成为单独的服务（Services），每个服务都可以运行在独立的进程中，访问服务必须使用定义好的接口，通过 IPC 进行通信。从而构建一个更内聚、低耦合、易于维护和拓展的系统。 diff --git a/Chapter5 - Network/5.3.md b/Chapter5 - Network/5.3.md index 3a297aa..a896c0b 100644 --- a/Chapter5 - Network/5.3.md +++ b/Chapter5 - Network/5.3.md @@ -32,7 +32,7 @@ 在几乎所有的机器上，**多字节对象都被存储为连续的字节序列**。例如在 C 语言中，一个 `int` 类型的变量 x 地址为 0x100，那么其对应的地址表达式 `&x` 的值为 `0x100`，且 x 的4个字节将被存储在存储器的 `0x100`,`0x101`,`0x102`,`0x103` 位置。 -字节的排列方式有2个通用规则。例如一个多位整数，按照存储地址从低到高排序的字节中，如果该整数的最低有效字节（类似于最低有效位）排在最高有效字节前面，则成为**“小端序“**；反之成为**”大端序“**。在计算机网络中，字节序是一个必须要考虑的因素，因为不同类型的机器可能采用不同标准的字节序，所以均需要按照网络标准进行转化。 +字节的排列方式有2个通用规则。例如一个多位整数，按照存储地址从低到高排序的字节中，如果该整数的最低有效字节（类似于最低有效位）排在最高有效字节前面，则称为“**小端序**“；反之成为”**大端序**“。在计算机网络中，字节序是一个必须要考虑的因素，因为不同类型的机器可能采用不同标准的字节序，所以均需要按照网络标准进行转化。 假设一个类型为 int 的变量 x，位于地址 0x100 处，它的值为 0x01234567，地址范围为 0x100～0x103字节，其内部的排列顺序由机器决定，也就是和 CPU 有关，和操作系统无关。 @@ -164,6 +164,12 @@ NBO(Network Byte Order)：按照从高到低的顺序存储，在网络上使用 主机字节顺序（HBO：Host Byte Order）：不同机器 HBO 不相同，与 CPU 有关。计算机存储数据有两种字节优先顺序：Big Endian 和 Little Endian。Internet 以 Big Endian 顺序在网络上传输，所以对于在内部是以 Little Endian 方式存储数据的机器，在网络通信时就需要进行转换。 +Big-Endian: PowerPC、IBM、Sun + +Little-Endian:x86、DEC + +ARM 既可以工作在大端模式，也可以工作在小端模式。 + ## 如何转换 diff --git a/README.md b/README.md index 0e57cfa..b13fcd1 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,15 @@ ## **knowledge-kit** + ### 目的 -形式记录大前端路上的探索,主要研究基础平台开发、工程效率、质量监控保证、SDK 输出、多端融合能力、动态化、组件化、工程化能力。 +形式记录大前端路上的探索，主要研究基础平台开发、工程效率、质量监控保证、SDK 输出、多端融合能力、动态化、组件化、工程化能力。 技术点: iOS、Web 前端、后端、Hybrid、Node 的应用、爬虫、反爬虫、后端、数据库、算法等领域。 -偶尔记录自学经济学遇到的概念或者有趣的生活现象解读. +偶尔记录自学经济学遇到的概念或者有趣的生活现象解读。 + ## 目录 @@ -15,10 +17,14 @@ 如果要方便的查看文章目录，请点击[链接](https://github.com/FantasticLBP/knowledge-kit/blob/master/SUMMARY.md) + ## 反馈 -定期更新博文。如果在查看文章的时候发现了问题可以提出 issue。（95年小双鱼, 技术专家进阶中，有技术问题或者想聊聊程序员的事情可以通过微博联系）[微博](http://weibo.com/u/3194053975) +定期更新博文。如果在查看文章的时候发现了问题可以提出 issue。（95年小双鱼，关注大前端领域，有事情可以通过[微博](http://weibo.com/u/3194053975)联系） + + + ## 交流 -如果你也是大前端路上的一名修行者,可以加我 Wechat：704568245，拉你入群一起在「大前端自习室」学习交流。 \ No newline at end of file +如果你也是大前端路上的一名修行者，可以通过[微博](http://weibo.com/u/3194053975)联系我，拉你入群一起在「大前端自习室」学习交流。 \ No newline at end of file diff --git a/SUMMARY.md b/SUMMARY.md index 2b5f2fd..cd4a840 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -82,7 +82,7 @@ * [77、iOS 打包系统构建加速](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.77.md) * [78、上架包预检](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.78.md) * [79、深入理解各种锁](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.79.md) - * [80、打造一个通用、可配置的数据上报 SDK](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md) + * [80、打造一个通用、可配置、多句柄的数据上报 SDK](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md) * [81、__asm__ 重命名符号](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.81.md) * [82、runtime](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.82.md) * [83、NSURLProtocol 应用场景](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.83.md) diff --git a/assets/2020-06-29-DataUploadConfigurationStructure.png b/assets/2020-06-29-DataUploadConfigurationStructure.png new file mode 100644 index 0000000000000000000000000000000000000000..32e80174bbd0368231f6dff361ef2af522168fac GIT binary patch literal 68303 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