# LDNetDiagnoService_IOS

**Repository Path**: leegithub/LDNetDiagnoService_IOS

## Basic Information

- **Project Name**: LDNetDiagnoService_IOS
- **Description**: 利用ping和traceroute的原理，对指定域名（通常为后台API的提供域名）进行网络诊断，并收集诊断日志。功能通过Service的方式提供给各个产品项目，由各个项目组决定如何使用。
- **Primary Language**: Objective-C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-01-07
- **Last Updated**: 2024-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LDNetDiagnoService_IOS
===============

利用ping和traceroute的原理，对指定域名（通常为后台API的提供域名）进行网络诊断，并收集诊断日志。功能通过Service的方式提供给各个产品项目，由各个项目组决定如何使用。



## LDNetDiagnoService最终效果
-------------------
* 调用网络诊断服务，监控日志输出；
* 诊断结束之后，返回日志文本;
* 调用者可以选择保存、邮件上传、接口上传等方式上传监控日志；

如下图所示：

![](LDNetDiagnoServiceDemoTests/netdiagnosis_ios.jpg)



## 如何集成LDNetDiagnoService_IOS
-------------------
	
在项目工程的Podfile文件中加载LDNetDiagnoService库：

```
pod 'LDNetDiagnoService', :git =>  'https://github.com/Lede-Inc/LDNetDiagnoService_IOS.git'
```



## 如何使用LDNetDiagnoService_IOS
---------------------------------
通过pod或者代码拷贝service代码到工程之后，即可通过如下方式调用网络诊断服务：

1. 初始化service，并为service设置监控日志输出的delegate；

tip：初始化参数只需要初始化appcode，userID, dormain（必须）, 其他参数如果不设置，service会自动补上这些日志参数；

```
// Do any additional setup after loading the view, typically from a nib.
_netDiagnoService = [[LDNetDiagnoService alloc] initWithAppCode:@"test"
                                                        appName:@"网络诊断应用"
                                                     appVersion:@"1.0.0"
                                                         userID:@"huipang@corp.netease.com"
                                                       deviceID:nil
                                                        dormain:_txtfield_dormain.text
                                                    carrierName:nil
                                                 ISOCountryCode:nil
                                              MobileCountryCode:nil
                                                  MobileNetCode:nil];
_netDiagnoService.delegate = self;
```

	

2. service中提供开启或停止网络诊断的功能；

```
- (void)startNetDiagnosis
{
    [_txtfield_dormain resignFirstResponder];
    _netDiagnoService.dormain = _txtfield_dormain.text;
    if (!_isRunning) {
       	...
        [_netDiagnoService startNetDiagnosis];
    } else {
        ...
        [_netDiagnoService stopNetDialogsis];
    }
}
```

3. 重载delegate方法，监控网络诊断日志；

	* 监控诊断开始
	
			#pragma mark NetDiagnosisDelegate
			-(void)netDiagnosisDidStarted {
    			NSLog(@"开始诊断～～～");
			}

	* 监控网络诊断过程中的日志输出
	
			-(void)netDiagnosisStepInfo:(NSString *)stepInfo {
    			NSLog(@"%@", stepInfo);
    			_logInfo = [_logInfo stringByAppendingString:stepInfo];
    			dispatch_async(dispatch_get_main_queue(), ^{
        			_txtView_log.text = _logInfo;
    			});
			}

	* 诊断结束，输出全部日志记录

			-(void)netDiagnosisDidEnd:(NSString *)allLogInfo;{
			    //可以保存到文件，也可以通过邮件发送回来
    			dispatch_async(dispatch_get_main_queue(), ^{
        			[_indicatorView stopAnimating];
        			[btn setTitle:@"开始诊断" forState:UIControlStateNormal];
			        _isRunning = NO;
    			});
			}
 

## 如何通过textview监控日志输出
---------------------------------
* 如果产品需要通过textview接口日志输出过程，可以参考demo例子中的ViewController的代码；

* 在网络诊断结束的时候，将日志文件上传；


## 技术支持
-------------------


>
to be continued ....

庞辉, 电商技术中心，popo：__huipang@corp.netease.com__