iOS开发常用的第三方类库

IOS常用类库

目录[-]

• Reachability 检测网络连接
• ASIHTTPRequest 网络请求
• MBProgressHUD 提示效果
• SVProgressHUD 提示效果
• ZAActivityBar 提示效果
• SBJson JSON解析
• JSONKit JSON解析
• SDWebImage 图片异步加载及缓存
• UIActivityIndicator-for-SDWebImage 为SDWebImage显示加载效果
• UIImage+Resize 调整图片大小
• ImageCacheResize 异步加载图片、缓存及调整大小
• EGOTableViewPullRefresh  下拉刷新
• PullToRefresh 下拉刷新
• STableViewController  下拉刷新、上拉加载更多
• SVPullToRefresh 下拉刷新、上拉加载更多
• CMPopTipView 提示信息
• PrettyKit
• MGBox2
• Nimbus
• FlatUIKit
• MUKMediaGallery
• PTShowcaseViewController
• MWPhotoBrowser
• ios-image-filters
• PDF Reader Core for iOS
• DTCoreText
• FTCoreText
• CoreTextWrapper
• Base64
• RNCryptor

在iOS开发中不可避免的会用到一些第三方类库，它们提供了很多实用的功能，使我们的开发变得更有效率；同时，也可以从它们的源代码中学习到很多有用的东西。

Reachability 检测网络连接

用来检查网络连接是否可用：包括WIFI和WWAN(3G/EDGE/CDMA等)两种工作模式。

可以从Apple网站下载到： http://developer.apple.com/library/ios/#samplecode/Reachability/History/History.html#//apple_ref/doc/uid/DTS40007324-RevisionHistory-DontLinkElementID_1  。

现在有更好的替代品：https://github.com/tonymillion/Reachability，比Apple提供的兼容性更好，而且更加好用，更具体的使用方法请看它提供的例子。

?

1 2 3 4 5 6 7 8 9

Reachability* reach = [Reachability reachabilityWithHostname:@"www.google.com"]; reach.reachableBlock = ^(Reachability*reach) {     NSLog(@"网络可用!"); }; reach.unreachableBlock = ^(Reachability*reach) {     NSLog(@"网络不可用!"); }; // 开始监听 [reach startNotifier];

 

ASIHTTPRequest 网络请求

ASIHTTPRequest是对CFNetwork API的一个包装，它提供了一套更加简洁的API，使用起来也更加简单。

官方网站：http://allseeing-i.com/ASIHTTPRequest/

GitHub：https://github.com/pokeb/asi-http-request

它不仅仅支持基本的HTTP请求，而且支持基于REST的服务(GET/POST/PUT/DELETE)。

最让人喜欢的是，它支持block语法：

?

1 2 3 4 5 6 7 8 9 10 11 12 13

NSURL *url = [NSURL URLWithString:@"  http://allseeing-i.com  "]; __block ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url]; [request setCompletionBlock:^{    // Use when fetching text data    NSString *responseString = [request responseString];      // Use when fetching binary data    NSData *responseData = [request responseData]; }]; [request setFailedBlock:^{    NSError *error = [request error]; }]; [request startAsynchronous];

它的ASIFormDataRequest子类可以横容易的提交表单数据和文件：

?

1 2 3 4 5 6 7 8

ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:url]; [request setPostValue:@"Ben" forKey:@"first_name"]; [request setPostValue:@"Copsey" forKey:@"last_name"]; // Upload a file on disk [request setFile:@"/Users/ben/Desktop/ben.jpg" withFileName:@"myphoto.jpg" andContentType:@"image/jpeg" forKey:@"photo"]; // Upload an NSData instance [request setData:imageData withFileName:@"myphoto.jpg" andContentType:@"image/jpeg" forKey:@"photo"];

详细的使用方法请下载相应的源代码及例子，或者从官方的使用说明http://allseeing-i.com/ASIHTTPRequest/How-to-use开始。

 

MBProgressHUD 提示效果

支持各种状态加载的提示效果，以及带进度的提示效果。

GitHub：https://github.com/matej/MBProgressHUD

一般会在.m文件实现MBProgressHUDDelegate协议，并声明HUD变量：

?

1 2 3 4 5 6 7 8 9 10 11 12

@interface SampleViewController () {     MBProgressHUD *HUD; } #pragma mark - #pragma mark MBProgressHUDDelegate methods   - (void)hudWasHidden:(MBProgressHUD *)hud {   // Remove HUD from screen when the HUD was hidded   [HUD removeFromSuperview];   HUD = nil; }

在执行某个异步请求时开始调用：

?

1 2 3 4 5

HUD = [MBProgressHUD showHUDAddedTo:self.webView animated:YES]; HUD.labelText = @"正在请求..."; // mode参数可以控制显示的模式 //HUD.mode = MBProgressHUDModeText; HUD.delegate = self;

请求完成时隐藏提示效果：

?

1	[HUD hide:YES];

对于同步方法一般都是用showWhileExecuting方法，方法执行完成之后会自动隐藏提示效果：

?

1	[HUD showWhileExecuting:@selector(myTask) onTarget:self withObject:nil animated:YES];

 

SVProgressHUD 提示效果

GitHub：https://github.com/samvermette/SVProgressHUD

SVProgressHUD和MBProgressHUD效果差不多，不过不需要使用协议，同时也不需要声明实例。

直接通过类方法进行调用即可：

?

1	[SVProgressHUD method]

可以使用以下方法来显示状态：

?

1 2 3 4

+ (void)show; + (void)showWithMaskType:(SVProgressHUDMaskType)maskType; + (void)showWithStatus:(NSString*)string; + (void)showWithStatus:(NSString*)string maskType:(SVProgressHUDMaskType)maskType;

如果需要明确的进度，则使用以下方法：

?

1 2 3

+ (void)showProgress:(CGFloat)progress; + (void)showProgress:(CGFloat)progress status:(NSString*)status; + (void)showProgress:(CGFloat)progress status:(NSString*)status maskType:(SVProgressHUDMaskType)maskType;

通过dismiss方法来隐藏提示：

?

1	+ (void)dismiss;

另外提供了以下方法用于显示状态，并在1秒后自动隐藏提示(使用的图标来源于Glyphish：http://www.glyphish.com/)：

?

1 2 3

+ (void)showSuccessWithStatus:(NSString*)string; + (void)showErrorWithStatus:(NSString *)string; + (void)showImage:(UIImage*)image status:(NSString*)string;// use 28x28 white pngs

 

ZAActivityBar 提示效果

GitHub：https://github.com/zacaltman/ZAActivityBar

ZAActivityBar和SVProgressHUD非常相似，它提供了更加简洁的API来显示提示效果。

ZAActivityBar使用的动画效果来源于ZKBounceAnimation(https://github.com/khanlou/SKBounceAnimation)，成功、失败的状态图标来源于Pictos(http://pictos.cc/)。

显示加载状态：

?

1	[ZAActivityBar showWithStatus:@"加载中..."];

显示成功、失败状态：

?

1 2	[ZAActivityBar showSuccessWithStatus:@"成功!"]; [ZAActivityBar showErrorWithStatus:@"失败!"];

隐藏提示：

?

1	[ZAActivityBar dismiss];

 

SBJson JSON解析

官方： http://sbjson.org/

GitHub：https://github.com/stig/json-framework

API使用起来稍显繁琐，特别是初始化的时候：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69

@interface TestViewController () {     SBJsonStreamParser *parser;     SBJsonStreamParserAdapter *adapter; }   // 冗长的初始化方法足以吓到一大片人 - (void)initSBJSON {     // We don't want *all* the individual messages from the   // SBJsonStreamParser, just the top-level objects. The stream   // parser adapter exists for this purpose.   adapter = [[SBJsonStreamParserAdapter alloc] init];       // Set ourselves as the delegate, so we receive the messages   // from the adapter.   adapter.delegate = self;       // Create a new stream parser..   parser = [[SBJsonStreamParser alloc] init];       // .. and set our adapter as its delegate.   parser.delegate = adapter;       // Normally it's an error if JSON is followed by anything but   // whitespace. Setting this means that the parser will be   // expecting the stream to contain multiple whitespace-separated   // JSON documents.   parser.supportMultipleDocuments = YES; }   #pragma mark SBJsonStreamParserAdapterDelegate methods   - (void)parser:(SBJsonStreamParser *)parser foundArray:(NSArray *)array {     [NSExceptionraise:@"unexpected" format:@"Should not get here"]; }   - (void)parser:(SBJsonStreamParser *)parser foundObject:(NSDictionary *)dict {     NSLog(@"SBJson parser foundObject");     // 处理返回的数据 }   // 使用ASIHTTPRequest请求测试 - (void) loadData {     __block ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];     [request setRequestMethod:@"POST"];     [request setCompletionBlock:^{         // Use when fetching text data         //NSString *responseString = [request responseString];         // Use when fetching binary data         NSData *responseData = [request responseData];         NSLog(@"Connection didReceiveData of length: %u", responseData.length);                   // Parse the new chunk of data. The parser will append it to         // its internal buffer, then parse from where it left off in         // the last chunk.         SBJsonStreamParserStatus status = [parser parse:responseData];                   if (status == SBJsonStreamParserError) {             NSLog(@"Parser error: %@", parser.error);         }else if (status == SBJsonStreamParserWaitingForData) {             NSLog(@"Parser waiting for more data");         }     }];     [request setFailedBlock:^{         NSError *error = [request error];         NSLog(@"failed - %@ %@", [error localizedDescription], error);     }];     [request startAsynchronous]; }

 

JSONKit JSON解析

GitHub：https://github.com/johnezang/JSONKit

提供比SBJson更优异的性能以及更加简便的使用方法，但是中文最好使用utf-8格式(\uXXXX)，否则容易造成乱码。

API调用起来非常简单，省去了SBJson那么一大堆的方法：

?

1 2	JSONDecoder* decoder = [[JSONDecoder alloc] initWithParseOptions:JKParseOptionNone]; id result = [decoder objectWithData:jsonData];

详细的使用方法请看它的GitHub主页。

 

SDWebImage 图片异步加载及缓存

SDWebImage用于异步下载网络上的图片，并支持对图片的缓存等。

多数情况下是使用UIImageView+WebCache为UIImageView异步加载图片：

?

1 2 3 4

#import // ... [cell.imageView setImageWithURL:[NSURL URLWithString:@"  http://www.domain.com/path/to/image.jpg  "]                    placeholderImage:[UIImage imageNamed:@"placeholder.png"]];

需要注意的是，pladeholderImage的大小一定要大于UIImageView的大小，否则可能不显示placeholderImage图片。

它还支持block语法用于在加载完成时做一些操作：

?

1 2 3

[cell.imageView setImageWithURL:[NSURL URLWithString:@"  http://www.domain.com/path/to/image.jpg  "]                placeholderImage:[UIImage imageNamed:@"placeholder.png"]                       completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType) {... completion code here ...}];

SDWebImage并不局限于UIImageView上，使用SDWebImageManager完成更多的操作：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14

SDWebImageManager *manager = [SDWebImageManager sharedManager]; [manager downloadWithURL:imageURL                  options:0                  progress:^(NSUInteger receivedSize,long long expectedSize)                  {                      // 下载进度                  }                  completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType)                  {                      if (image)                      {                          // 下载完成                      }                  }];

或者使用Image Downloader也是一样的效果：

?

1 2 3 4 5 6 7 8 9 10 11 12 13

[SDWebImageDownloader.sharedDownloader downloadImageWithURL:imageURL         options:0        progress:^(NSUInteger receivedSize,long long expectedSize)        {            // 进度        }        completed:^(UIImage *image, NSData *data, NSError *error,BOOL finished)        {            if (image && finished)            {                // 下载完成            }        }];

 

UIActivityIndicator-for-SDWebImage 为SDWebImage显示加载效果

GitHub：https://github.com/JJSaccolo/UIActivityIndicator-for-SDWebImage

用于为SDWebImage在UIImageView加载图片时，显示加载效果(UIActivityIndicatorView实现)，它提供以下方法：

?

1 2 3 4 5 6 7

- (void)setImageWithURL:(NSURL *)url usingActivityIndicatorStyle:(UIActivityIndicatorViewStyle)activityStyle; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder usingActivityIndicatorStyle:(UIActivityIndicatorViewStyle)activityStyle; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options usingActivityIndicatorStyle:(UIActivityIndicatorViewStyle)activityStyle; - (void)setImageWithURL:(NSURL *)url completed:(SDWebImageCompletedBlock)completedBlock usingActivityIndicatorStyle:(UIActivityIndicatorViewStyle)activityStyle; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder completed:(SDWebImageCompletedBlock)completedBlock usingActivityIndicatorStyle:(UIActivityIndicatorViewStyle)activityStyle; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDWebImageCompletedBlock)completedBlock usingActivityIndicatorStyle:(UIActivityIndicatorViewStyle)activityStyle; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletedBlock)completedBlock usingActivityIndicatorStyle:(UIActivityIndicatorViewStyle)activityStyle;

 

UIImage+Resize 调整图片大小

GitHub：https://github.com/coryalder/UIImage_Resize

提供多种方法为图片设置透明度、圆角、裁剪、调整大小等：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14

- (UIImage *)imageWithAlpha; - (UIImage *)transparentBorderImage:(NSUInteger)borderSize; - (UIImage *)roundedCornerImage:(NSInteger)cornerSize borderSize:(NSInteger)borderSize; - (UIImage *)croppedImage:(CGRect)bounds; - (UIImage *)thumbnailImage:(NSInteger)thumbnailSize           transparentBorder:(NSUInteger)borderSize                cornerRadius:(NSUInteger)cornerRadius        interpolationQuality:(CGInterpolationQuality)quality; - (UIImage *)resizedImage:(CGSize)newSize      interpolationQuality:(CGInterpolationQuality)quality; - (UIImage *)   resizedImageWithContentMode:(UIViewContentMode)contentMode                        bounds:(CGSize)bounds          interpolationQuality:(CGInterpolationQuality)quality;

更详细使用见：http://vocaro.com/trevor/blog/2009/10/12/resize-a-uiimage-the-right-way/

 

ImageCacheResize 异步加载图片、缓存及调整大小

GitHub：https://github.com/toptierlabs/ImageCacheResize

整合了SDWebImage和UIImage+Resize的功能，用于图片的异步加载、缓存、以及下载完成后调整大小并显示在UIImageView上。

提供了以下API用于加载图片以及加载完成后调整图片大小：

?

1 2 3 4 5 6

- (void)setImageWithURL:(NSURL *)url andCropToBounds:(CGRect)bounds; - (void)setImageWithURL:(NSURL *)url andResize:(CGSize)size withContentMode:(UIViewContentMode)mode; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder andCropToBounds:(CGRect)bounds; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options  andResize:(CGSize)size; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options  andResize:(CGSize)size withContentMode:(UIViewContentMode)mode; - (void)setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options  andCropToBounds:(CGRect)bounds;

使用方法和SDWebImage一样简单，如以下官方例子：

?

1 2

[imageview setImageWithURL:[NSURL URLWithString:@"  http://t0.gstatic.com/images?q=tbn:ANd9GcQfraHpiabjEY8iDdBe9OUQYHMtwfuAv9ZRR0RYKuoVF_EpE8Fp5A  "] andResize:CGSizeMake(30, 30) withContentMode:UIViewContentModeScaleAspectFit]; // 按比例缩放 [imageview setImageWithURL:[NSURL URLWithString:@"  http://t0.gstatic.com/images?q=tbn:ANd9GcQfraHpiabjEY8iDdBe9OUQYHMtwfuAv9ZRR0RYKuoVF_EpE8Fp5A  "] andCropToBounds:CGRectMake(0, 0, 100, 100)]; // 裁剪成100x100大小