1.简介

该工程包含iOS开发中使用到的工具，文件操作，网络访问，提示UI，设备唯一ID，keychain存储，以便于开发者能迅速搭建基础模块。
源码地址 :https://github.com/ydbwwhq/HWCommon

2.使用方法

• 下载该项目，直接将HWCommon文件夹拖入项目即可

• import"HWCommon.h"，导入所有工具类

即可快速搭建项目的基础功能模块

3.具体工具类使用实例

3.1 HWWaitV

该类主要提供加载中的提示框，如网络请求时，可以调用该方法

3.1.1 API使用介绍

• 在屏幕中间弹出加载框

   [HWWaitV show];           
  

• 在屏幕指定位置弹出加载框

  [HWWaitV showInCenter:CGPointMake(10,10)];
  

• 隐藏提示框

  [HWWaitV hidden];
  

3.2 HWUtility

该类主要包含经常用到的一些工具类操作，如返回当前时间戳

3.2.1 API使用介绍

• 获取字符串的字节长度

   [HWUtility getStrByteLength:@"Hale"];
  

• 检测字符串是否包含空格

  [HWUtility isIncludeSpace:@"Hale Wang"];
  

• 获取时间戳单位s

   [HWUtility getTimestamp];
  

• 获取屏屏幕缩放比例,主要获取的屏幕相对于iPhone6系列尺寸的缩放比例，在UI适配时会用到

   [HWUtility getScreenPer];
  

• 获取导航栏高度，在状态栏是否显示时，正确返回导航栏高度

  [HWUtility  getNavigationH];
  

• 根据时间和时间格式 返回时间字符串 针对手机系统的时区

  [HWUtility getDateTime:@"yyyy-mm-dd hh:mm:ss" Date:[NSDate new]];
  

• 根据时间和时间格式 返回时间字符串 可以自定义时区

  NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
  [dateFormatter setDateFormat:@"yyyy-mm-dd hh:mm:ss"];
  [HWUtility getDateFormatTime:dateFormatter  Date::[NSDate new]];
  

• 判断字符串是否为空 其中包含字符创为nil，null或者字符串为空格的情况

  [HWUtility isBlankString:@"  " ];
  

• 判断电话号码是否合法

  [HWUtility  isLegalMoblieNum:@"322431143"];
  

• 判断邮箱是否合法

  [HWUtility  isLegalEmail:@"fasffadssdf"];
  

• 字典转为base64编码的字符串

  [HWUtility base64EncodingWithDic:@{@"key":@"afdsfda"}];
  

• NSData转化为Base64编码

  [HWUtility base64EncodingWithData:[NSData new]];
  

• 字符串转化为Base64字符串

  [HWUtility  base64EncodingWithStr:@"afsddfsa"];
  

• 字符串的MD5值

  [HWUtility getMD5String:@"fsdadfsfdsa"];
  

• NSData转化为字典，客户端和服务器交互，经常会返回NSData类型的数据，使用该API可以直接转化为字典

  [HWUtility dicFromData:[NSData new]];
  

• 字符串转化为字典

  [HWUtility dicFromJsonStr:@""];
  

• 字典转化为字符串

  [HWUtility jsonStrFromDic:@{@"key":@"asddsf"}];

• 字典转化为NSData

  [HWUtility dataFromDic:@{@"key":@"asddsf"}];   
  

• 字典或者数组转化为字符串

  [HWUtility jsonStrFromObj:@{@"key":@"asddsf"}]];
  

• 字符串转化为字典或者数组

  [HWUtility ObjFromJsonStr:@"fasdsfadfsa"];
  

• 获取当前控制器

  [HWUtility currentViewController];
  

• 判断是否在同一天

  [HWUtility isSameDay:11212424  Time2:24324234];
  

• 产生一个随机整数

  [HWUtility getRandomNumber:0 to ：100];
  

• 产生一个随机浮点数

  [HWUtility randomBetween:0.1 And:0.2];
  

3.3 HWDevice

3.3.1 API使用介绍

• 判断手机是否越狱

  [HWDevice isJailbroken];
  

• 获取设备的唯一ID

  [HWDevice getDeviceID];
  

• 获取系统版本号，如iOS9.0

   [HWDevice systemVersion];
  

• 获取手机型号,如iPhone6,iPhone7

  [HWDevice phoneModel];
  

• 获取手机分辨率

  [HWDevice screenResolution];
  

3.4 HWKeyChain

3.4.1 API使用介绍

• 保存数据到KeyChain

   [HWKeyChain save:@"key" data:@"value"];
  

• 从KeyChain中读取值

  [HWKeyChain load:@"key"];
  

• 删除KeyChain中的数据

  [HWKeyChain  deleteData:@"key"];
  

3.5 HWRequest

该类继承了 NSMutableURLRequest，所以可以支持所有原生Request的属性，可根据自己的需求自行设定超时时间等。

3.5.1 API使用介绍

• Get请求

  HWRequest *request = [[HWRequest alloc]initWithURLStr:@"https://dasfdsdfs"];
  
  [request asynGetRequest:@{@"key":@"value"} onSuccess:^(NSData *data) {
    if(successCallBack)
    {
        successCallBack(data);
    }
  } onFailure:^(NSError *error) {
    if(failureCallBack)
    {
        failureCallBack(error);
    }
  }];
  [request startRequest];
  

• Post请求,默认设置超时时间为30s，content-type为application/json，

  HWRequest *request = [[HWRequest alloc]initWithURLStr:@"https://dasfdsdfs"];
  [request asynPostRequest:@{@"key":@"value"} onSuccess:^(NSData *data) {
    if(successCallBack)
    {
        successCallBack(data);
    }
  } onFailure:^(NSError *error) {
    if(failureCallBack)
    {
        failureCallBack(error);
    }
  }];
  [request startRequest];
  

3.6 HWTipView

该类提供提示语的吐司，类似android的吐司效果

3.6.1 API使用介绍

• 弹出吐司

  [HWTipView showTip：@"登录成功"];
  

• 隐藏吐司

  [HWTipView hiddenTip];
  

• 设置提示框字体大小

  [HWTipView setFontSize:12];
  

• 设置提示框背景色

  [HWTipView setBgColor:[UIColor redColor]];
  

• 设置提示框圆角大小

  [HWTipView setCornerRadius:2];
  

3.7 HWFile

3.7.1 API使用介绍

• 创建文件

  [HWFile createFile:@"user/info.txt"];
  

• 删除文件

  [HWFile deleteFile:@"user/info.txt"];
  

• 判断文件是否存在

  [HWFile fileExistsAtPath:@"user/info.txt"];
  

• 写文件操作，其中append表示是否是在原有内容后面写入内容或者覆盖写入

  [HWFile writeFile:@"dsadfsafd" filePath:@"user/info.txt" append:false];
  

• 读取文件，返回的是NSData类型的数据

  [HWFile readFile:@"user/info.txt"];
  

• 获取Document路径

  [HWFile getDocumentPath];
  

• 从文件中读取对象,返回NSObject类型

  [HWFile readObjFromFile:@"user/info.txt"];
  

• 把对象存入文件，该对象是自定义的对象或者包含自定义的对象，该自定义的对象需要实现NSCoder协议

  [HWFile writeObjTofile:[NSObject new]  filePath:@"user/info.txt"];
  

3.8 HWNetwork

3.8.1 API使用介绍

• 获取网络类型 wifi 无网络 3G 4G 2G

  [HWNetwork networkType];
  

• 获取网络运营商 中国联通 中国移动

  [HWNetwork networkOperator];

• 判断网络是否可用

  [HWNetwork isConnectionAvailable];
  

• 判断是否连接到wifi

  [HWNetwork isConnectWifi];
  

• 判断是否连接网络

  [HWNetwork isConnectInternet];
  

• 网络状态码，WLAN网，无线网，无网络的状态码

  [HWNetwork networkStatus];
  

4.总结

后续工具类还会持续更新，如果有任何疑问或者建议，请邮箱联系1334849513@qq.com
源码地址 :https://github.com/ydbwwhq/HWCommon