CocoaPods新手上路
本文会介绍如何使用CocoaPods。CocoaPods一个依赖关系管理工具。
那么什么是依赖关系管理工具？我们为什么需要这个工具？
作为一个iOS开发者，你肯定会使用第三方库。通常，我们直接把第三方库的源代码直接加入到我们的项目中（手动创建一个static library还是很无聊滴），但是这么做有一些缺点：
- 浪费空间。源代码可能已经存在你的代码托管中
- 有些时候，很难获得某个具体版本的第三方库
- 没有一个集中的地方可以查看哪些库现在可以使用
- 更新新版本的时候，是件无聊的事情，有些时候还很痛苦
一个依赖关系管理工具可以帮助你克服大部分上面提到的问题。它会帮你下载你所用到的库的源代码、创建和维护你所需要的环境。
本文会用cocoapod来创建一个应用，这个应用用于获取你在trakt.tv上收听的节目信息。
等会你就会发现使用cocoaPods所带来的好处
CocoaPods的官网是这么描述它自己的”The best way to manage library dependencies in Objective-C projects”。 就目前来看，所言非虚。
与其你自己每次从Github中下载代码，然后拷贝到你的项目中，还不如让CocoaPods来帮你完成这个工作。
trakt.tv这个应用的需求就是-我们希望创建一个应用，可以显示将要播放的电视节目的信息。
安装CocoaPods
安装RubyGems
CocoaPods需要ruby环境，幸运的是所有的mac电脑都已经预装了ruby，所以你需要更新一下你的RubyGems(如果你的系统版本低于OS X Lion)
只需要输入如下命令就可以更新你的RubyGems：
sudo gem update –system
安装command line工具
确保你在你的Xcode中安装了command line tool(命令行工具)。在最新的Mac OS X Lion和Xcode中，命令行工具默认没有安装。可以通过如下方式安装command line tool:
- 从这里下载，然后安装
- 打开xcode，打开components界面。Xcode->Preferences->Downloads->Components.里面应该有一个选项是”Command Line Tools”,后面应该“Install”或者“Update”按钮，点一下按钮就行。安装完成后，按钮的文字会变成“Installed”。如下图：
安装CocoaPods
完成以上步骤后，只需要输入如下命令就可以安装CocoaPods了：
sudo gem install cocoapods
pod setup
第一次安装可能需要一些时间，耐心等待一下
创建一个“CocoaPodsExample”工程
打开Xcode，然后创建一个基于“Single View Application”的工程。工程的名字“CocoaPodsExample”，“Device Family”选为“iPhone”，选中“Use Storyboards”和“Use Automatic Reference Counting”。如下图：
点击下一步然后选择一个地方存放你的工程。
找一张图片作为Launch Images。如果没有合适的可以下载这一张-placeholder.png。把这张图片拖到工程中，选中“Copy items into destination group’s folder(if needed)”。
下面打开MainStoryboard.storyboard，并按照如下步骤进行修改：
- 添加一个scroll view。确保这个scroll view的宽度和高度是100%
- 修改scroll view的属性。打开属性选择器，不选“Shows Horizontal Scrollers”,”Shows Verticall Scollers”。选中“Scrolling Enabled”, “Paging Enabled”, “Direction Lock Enabled”
- 添加一个page control。确保这个page control是之前scroll view的兄弟视图，而不是scroll view的子视图，并且page control应该在scroll view的前面，不然你就看不到page control了。
storyboard应该看起来像下图：
最后把scroll view和page view连接到一个outlet中，我们把scroll view的outlet命名为showsScrollView，并且把当前的view controller做为scroll view的delegate。把page control的outlet命名为showPageControl，给page control的“Value Changed”事件绑定一个方法，方法名称是pageChanged。
现在你可以关了你的Xcode了，接下来就是开始创建你的Podfile了。
创建你的第一个依赖关系
打开终端，并且打开存放你的“CocoaPodsExample”工程的文件夹。输入如下命令：
touch Podfile open -e Podfile
TextEdit会被打开，你可以往打开的空白Podfile中添加内容了。
我们往Podfile中加入如下内容：
platform :iOS pod 'AFNetworking', '0.9.1'
如你所见，Podfile的格式很简单。首先，你设置platform为ios（因为有一些框架只支持iOS或者Mac OS X中的一个，而不是都有）。然后，你添加你的第一个依赖-“AFNetworking”，并且指定了，你需要的是0.9.1。
编辑Podfile，除了上面的方法，你还可以使用别的你喜欢的编辑工具，比如vim
有关Podfile的格式，你可以在A Podfile和Podfile(frames)中得到更详细信息
保存Podfile之后，我们可以开始配置你的工程了。
在终端中执行如下命令：
pod install
执行完后，你应该会在终端中看到下图：
如果这个时候，你打开你工程所在的文件夹会看到下图：
CocoaPods创建了一个文件夹-“Pods”，这个文件夹存放了所有的依赖的库和一个workspace文件，CocoaPodsExample.xcworkspace
VERY IMPORTANT！
从现在开始，你必须用workspace文件(CocoaPodsExample.xcworkspace)打开工程，而不是在是用工程文件(CocoaPodsExample.xcodeproj)
测试AFNetworking
测试AFNetworking是否成功加入已经CocoaPods是否真的工作，可以创建一个基于iOS/Cocoa Touch/Objective-C class的类，我们称之为SKTraktAPIClient，并且是这个类是NSObject的子类。切记把这个类加入到CocoaPodsExample中而不是Pods工程中。如果你现在看一下你工程文件的导航，你会看到有两个独立的项目：CocoaPodsExample和Pods
打开SKTraktAPIClient.h，并且用如下代码替换已有代码：
#import <Foundation/Foundation.h> #import <AFNetworking/AFHTTPClient.h> extern NSString *const kTraktAPIKey; extern NSString *const kTraktBaseURLString; @interface SKTrakeAPIClient : AFHTTPClient +(SKTrakeAPIClient *)sharedClient; @end
上面的代码做了如下事情：
- 第一行代码导入Foundation头文件
- 第二行代码导入AFNetworking的头文件，AFNetworking将会是SKTraktAPIClient的头文件
- 接下来的两行定了两个变量
- 最后我们定义了一个方法，该方法会返回一个独立的SKTraktAPIClient实力
为什么在已经有AFNetworking可以处理所有的HTTP请求的情况下，我们还要创建一个SKTraktAPIClient类？原因就在于，我们希望有一个类可以处理所有我们和trakt.tv的请求，可以使用同样的Base URL和api key。这样子可以方便之后的维护。
现在打开SKTraktAPIClient.m，并且用如下的代码替换已有的代码：
#import "SKTraktAPIClient.h"
#import <AFJSONRequestOperation.h>
NSString *const kTraktAPIKey = @"fc3df235908f83107cedd7914950d7a0";
NSString *const kTraktBaseURLString = @"http://api.trakt.tv";
@implementation SKTraktAPIClient
+(SKTraktAPIClient *)sharedClient{
static SKTraktAPIClient *_sharedClient = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
_sharedClient = [[self alloc] initWithBaseURL:[NSURL URLWithString:kTraktBaseURLString]];
});
return _sharedClient;
}
-(id)initWithBaseURL:(NSURL *)url{
self = [super initWithBaseURL:url];
if(!self){
return nil;
}
[self registerHTTPOperationClass:[AFJSONRequestOperation class]];
[self setDefaultHeader:@"Accept" value:@"application/json"];
self.parameterEncoding = AFJSONParameterEncoding;
return self;
}
@end
首先我们导入了AFJSONRequestOperation.h，这样子所有的返回值都是JSON格式的。我们创建了sharedClient，这里使用了GCD(Grand Central Dispatch)，确保了实现SKTraktAPIClient的单例，随意只要是通过sharedClient方法获得的SKTraktAPIClient都是同一个实例，不会重复创建。除了这个以外，我们还重写了initWithBaseURL方法，原因就是之后所有用initiWithBaseURL创建的方法，它们都有同样的response格式-json格式
下面打开AppDelegate.m加入下面代码：
#import <AFNetworking.h>
在application:didFinishLaunchingWithOptions:加入如下代码：
[AFNetworkActivityIndicatorManager sharedManager].enabled = YES;
以上代码开启了automatic network activity indication manager，这个是AFNetworking支持的功能。通过这种方法，你就不需要每次发送请求打开activity indication，完成后关闭activity indication。
现在打开ViewController.m，并且加入如下代码：
#import "SKTraktAPIClient.h" #import <AFNetworking.h>
并用如下代码替换viewDidLoad
-(void)viewDidLoad {
[super viewDidLoad];
// 1 - Create trakt API client
SKTraktAPIClient* client = [SKTraktAPIClient sharedClient];
// 2 - Create date instance with today's date
NSDate* today = [NSDate date];
// 3 - Create date formatter
NSDateFormatter* formatter = [[NSDateFormatter alloc] init];
formatter.dateFormat = @"yyyyMMdd";
NSString* todayString = [formatter stringFromDate:today];
// 4 - Create API query request
NSString* path = [NSString stringWithFormat:@"user/calendar/shows.json/%@/%@/%@/%d", kTraktAPIKey, @"marcelofabri", todayString, 3];
NSURLRequest* request = [client requestWithMethod:@"GET" path:path parameters:nil];
// 5 - Create JSON request operation
AFJSONRequestOperation* operation = [AFJSONRequestOperation JSONRequestOperationWithRequest:request success:^(NSURLRequest *request, NSHTTPURLResponse *response, id JSON) {
// 6 - Request succeeded block
NSLog(@"%@", JSON);
} failure:^(NSURLRequest *request, NSHTTPURLResponse *response, NSError *error, id JSON) {
// 7 - Request failed block
}];
// 8 - Start request
[operation start];
}
编译运行之后，你可以在你的控制台中看到类似下图的日志：
可见，CocoaPods正确帮我们配置了AFNetworking。
