RAC库的导入教程

1、Now to study;步骤0 安装系统需要的包 # For Mac # 先安装 Xcode( 开发工具，它将帮你安装好 Unix 环境需要的开发包 步骤1 安装 RVM RVM 是干什么的这里就不解释了，后面你将会慢慢搞明白。$ curl -L https:/get.rvm.io | bash -s stable期间可能会问你sudo管理员密码，以及自动通过homebrew安装依赖包，等待一段时间后就可以成功安装好 RVM。然后，载入 RVM 环境（新开 Termal 就不用这么做了，会自动重新载入的）$ source /.rvm/scripts/rvm检查一下是否安装

2、正确 $ rvm -v rvm 1.22.17 (stable) by Wayne E. Seguin <wayneeseguin>, Michal Papis <mpapis> https:/rvm.io/步骤2 用 RVM 安装 Ruby 环境  $ rvm install 2.0.0同样继续等待漫长的下载，编译过程，完成以后，Ruby, Ruby Gems 就安装好了。步骤3 设置 Ruby 版本 RVM 装好以后，需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本$ rvm 2.0.0 -default同样，也可以用其他版

3、本号，前提是你有用 rvm install 安装过那个版本这个时候你可以测试是否正确$ ruby -v ruby 2.0.0p247 (2013-06-27 revision 41674) x86_64-darwin13.0.0 $ gem -v 2.1.6这有可能是因为Ruby的默认源使用的是，国内访问这个网址有时候会有问题，网上的一种解决方案是将远替换成淘宝的，替换方式如下： $gem source -r / $ gem source -a  要想验证是否替换成功了，可以执

4、行：$ gem sources -l  正常的输出结果：CURRENT SOURCES/到这里就已经把Ruby环境成功的安装到了Mac OS X上，接下来就可以进行相应的开发使用了。如何下载和安装CocoaPods？假如你在本地已经安装好Ruby环境，那么下载和安装CocoaPods将十分简单，只需要一行命令。在Terminator（也就是终端）中输入以下命令（注意，本文所有命令都是在终端中输入并运行的。什么，你不知道什么是终端？那请小编吃饭，小编告诉你）：sudo gem install cocoap

5、ods如何使用CocoaPods？为了确定类库（你要添加的类库）是否支持CocoaPods，可以用CocoaPods的搜索功能验证一下。在终端中输入：$ pod search AFNetworking在终端中进入（cd命令）你项目所在目录，然后在当前目录下，利用vim创建Podfile，运行：$ vim Podfile 然后在Podfile文件中输入以下文字：platform :ios, '7.0' pod "AFNetworking", "> 2.0" 注意，这段文字不是小编凭空生成的，可以在AFNetworking的github

6、页面找到。这两句文字的意思是，当前AFNetworking支持的iOS最高版本是iOS 7.0, 要下载的AFNetworking版本是2.0。然后保存退出。vim环境下，保存退出命令是：:wq 这时候，你会发现你的项目目录中，出现一个名字为Podfile的文件，而且文件内容就是你刚刚输入的内容。注意，Podfile文件应该和你的工程文件.xcodeproj在同一个目录下。这时候，你就可以利用CocoPods下载AFNetworking类库了。还是在终端中的当前项目目录下，运行以下命令：$ pod install 因为是在你的项目中导入AFNetworking，这就是为什么这个命令需要你进入你

7、的项目所在目录中运行。运行上述命令之后，小编的终端出现以下信息：EricmatoMacBook-Pro:CocoaPodsDemo ericwang$ pod install Analyzing dependencies Downloading dependencies Installing AFNetworking (2.0.2) Generating Pods project Integrating client project ! From now on use CocoaPodsDemo.xcworkspace. 注意最后一句话，意思是：以后打开项目就用 CocoaPodsDemo.x

8、cworkspace 打开，而不是之前的.xcodeproj文件。你也许会郁闷，为什么会出现.xcodeproj文件呢。这正是你刚刚运行$ pod install命令产生的新文件。除了这个文件，你会发现还多了另外一个文件“Podfile.lock”和一个文件夹“Pods”。 点击 CocoaPodsDemo.xcworkspace 打开之后工程之后，项目Xcode目录结构如下图：你会惊喜地发现，AFNetwoking已经成功导入项目了（红框部分）！现在，你就可以开始使用AFNetworking.h啦。可以稍微测试一下，在你的项目任意代码文件中输入：#import <AFNetworkin

9、g.h> 或者 #import "AFNetworking.h" 然后编译，看看是否出错。如果你严格按照小编上述的步骤来，是不可能出错的啦。至此，CocoPods的第一个应用场景讲述完毕。别看小编写了这么多，其实过程是十分简单的。总结一下就是：1. 先在项目中创建Podfile，Podfile的内容是你想导入的类库。一般类库的原作者会告诉你导入该类库应该如何写Podfile；2. 运行命令：$ pod install.下面，小编继续讲述第二种使用场景。场景2：如何正确编译运行一个包含CocoPods类库的项目你也许曾经遇到过（特别是新手iOS开发者）这种情况，好不容易

10、在GitHub上找到一份代码符合自己想需求，兴冲冲下载下来，一编译，傻眼了，发现有各种各样错误。一看，原来是缺失了各种其他第三方类库。这时候莫慌，你再仔细一看，会发现你下载的代码包含了Podfile。没错，这意味着你可以用CocoaPods很方便下载所需要的类库。下面，小编以代码 UAAppReviewManager 为例来说明如何正确编译运行一个包含CocoPods类库的项目。UAAppReviewManager是一个能够让你方便地将提醒用户评分的功能加入你的应用中。当你去UAAppReviewManager的GitHub地址下载这份代码之后，打开Example工程（UA

11、AppReviewManagerExample），编译，你会发现Xcode报告一大堆错误，基本都是说你编译的这份代码找不到某某头文件，这就意味着你要成功编译UAAppReviewManager的Example代码，必须先导入一些第三方类库。同时你会发现在UAAppReviewManagerExample文件夹下面有三个跟CocosPods相关的文件（文件夹）：Podfile，Podfile.lock和Pods，如下图：用这时候，打开终端，进入UAAppReviewManagerExample所在的目录，也就是和Podfile在同一目录下，和场景1一样，输入以下命令（由于已经有Podfile，所

12、以不需要再创建Podfile）：$ pod update 过几秒（也许需要十几秒，取决于你的网络状况）之后，终端出现：Analyzing dependencies Fetching podspec for UAAppReviewManager from ./ Downloading dependencies Installing UAAppReviewManager (0.1.6) Generating Pods project Integrating client project ! From now on use UAAppReviewManagerExample.xcworkspace.

13、 这时候，再回到UAAppReviewManagerExample文件夹看一看，会看到多了一个文件UAAppReviewManagerExample.xcworkspace：根据终端的信息提示，你以后就需用新产生的UAAppReviewManagerExample.xcworkspace来运行这个Example代码了。打开UAAppReviewManagerExample.xcworkspace，编译运行，成功！如下图：注意，这里有个小问题，如果刚刚你不是输入$ pod update，而是输入$ pod install，会发现类库导入不成功，并且终端出现下面提示：! Required vers

14、ion (UAAppReviewManager (from ./) not found for UAAppReviewManager. Available versions: 0.1.6 这里的意思大概是Podfile文件过期，类库有升级，但是Podfile没有更改。$ pod install只会按照Podfile的要求来请求类库，如果类库版本号有变化，那么将获取失败。但是 $ pod update会更新所有的类库，获取最新版本的类库。而且你会发现，如果用了 $ pod update，再用 $ pod install 就成功了。那你也许会问，什么时候用&

15、#160;$ pod install，什么时候用 $ pod update 呢，我又不知道类库有没有新版本。好吧，那你每次直接用 $ pod update 算了。或者先用 $ pod install，如果不行，再用 $ pod update。好了，小编就啰嗦到这里吧。上述都只是CocoaPods的最基本用法。要继续研究CocoaPods其他高级用法，请点击这里CocoaPods Wiki。开始动手因为我之前安装了 CocoaPods ,所以我这次写的ReactiveCocoaDemo 是基于CocoaPods的.如

16、果没有安装的可以童鞋,可以直接从github上下载 ReactiveCocoa前期工作:1.打开xcode 创建一个工程,我命名的工程名为ReactiveCocoaDemo,2.终端到工程路径下cd ReactiveCocoaDemo/ pod search ReactiveCocoa3.配置依赖文件vi Podfile platform :ios,'5.0' pod 'ReactiveCocoa' wq4.下载文件 pod install /update5:打开“Build Phases” 选中相应的target, 添加 RAC 到 “Link Bi

17、nary With Libraries”.加上libReactiveCocoa-iOS.a如下图6:在Header Search Paths 中添加$(BUILD_ROOT)/./IntermediateBuildFilesPath/UninstalledProducts/include"7:在 “Other Linker Flags” 添加 -ObjC8:在ReactiveCocoaDemo-Prefix.pch 将RAC的头文件加进去#import "ReactiveCocoa.h"ReactiveCocoa和响应式编程在说ReactiveCocoa之前，先要

18、介绍一下FRP（Functional Reactive Programming，响应式编程），在维基百科中有这样一个例子介绍：在命令式编程环境中，a = b + c 表示将表达式的结果赋给a，而之后改变b或c的值不会影响a。但在响应式编程中，a的值会随着b或c的更新而更新。Excel就是响应式编程的一个例子。单元格可以包含字面值或类似”=B1+C1的公式，而包含公式的单元格的值会依据其他单元格的值的变化而变化 。而ReactiveCocoa简称RAC，就是基于响应式编程思想的Objective-C实践，它是Github的一个开源项目，你可以在这里找到它。关于FRP和ReactiveCocoa可

19、以去看leezhong的这篇blog，图文并茂，讲的很好。ReactiveCocoa框架概览先来看一下leezhong再博文中提到的比喻，让你对有个ReactiveCocoa很好的理解：可以把信号想象成水龙头，只不过里面不是水，而是玻璃球(value)，直径跟水管的内径一样，这样就能保证玻璃球是依次排列，不会出现并排的情况(数据都是线性处理的，不会出现并发情况)。水龙头的开关默认是关的，除非有了接收方(subscriber)，才会打开。这样只要有新的玻璃球进来，就会自动传送给接收方。可以在水龙头上加一个过滤嘴(filter)，不符合的不让通过，也可以加一个改动装置，把球改变成符合自己的需求(m

20、ap)。也可以把多个水龙头合并成一个新的水龙头(combineLatest:reduce:)，这样只要其中的一个水龙头有玻璃球出来，这个新合并的水龙头就会得到这个球。下面我来逐一介绍ReactiveCocoa框架的每个组件StreamsStreams 表现为RACStream类，可以看做是水管里面流动的一系列玻璃球，它们有顺序的依次通过，在第一个玻璃球没有到达之前，你没法获得第二个玻璃球。RACStream描述的就是这种线性流动玻璃球的形态，比较抽象，它本身的使用意义并不很大，一般会以signals或者sequences等这些更高层次的表现形态代替。SignalsSignals

21、60;表现为RACSignal类，就是前面提到水龙头，ReactiveCocoa的核心概念就是Signal，它一般表示未来要到达的值，想象玻璃球一个个从水龙头里出来，只有了接收方（subscriber）才能获取到这些玻璃球（value）。Signal会发送下面三种事件给它的接受方（subscriber)，想象成水龙头有个指示灯来汇报它的工作状态，接受方通过-subscribeNext:error:completed:对不同事件作出相应反应· next 从水龙头里流出的新玻璃球（value）· error 获取新的玻璃球发生了错误，一般要发送一个NSErr

22、or对象，表明哪里错了· completed 全部玻璃球已经顺利抵达，没有更多的玻璃球加入了一个生命周期的Signal可以发送任意多个“next”事件，和一个“error”或者“completed”事件（当然“error”和“completed”只可能出现一种）Subjectssubjects 表现为RACSubject类，可以认为是“可变的（mutable）”信号/自定义信号，它是嫁接非RAC代码到Signals世界的桥梁，很有用。嗯。 这样讲还是很抽象，举个例子吧： 123RACSubject *letters = RACSubject subject;RAC

23、Signal *signal = letters sendNext:"a" 可以看到"a"只是一个NSString对象，要想在水管里顺利流动，就要借RACSubject的力。Commandscommand 表现为RACCommand类，偷个懒直接举个例子吧，比如一个简单的注册界面： 123456789101112131415161718192021     RACSignal *formValid = RACSignal       &

24、#160; combineLatest:             self.userNameField.rac_textSignal,             self.emailField.rac_textSignal,            &#

25、160;     reduce:(NSString *userName, NSString *email)             return (userName.length &gt; 0                    

26、 &amp;&amp; email.length &gt; 0);               RACCommand *createAccountCommand = RACCommand commandWithCanExecuteSignal:formValid;    RACSignal *networkResults = createAccountCommand      

27、60; addSignalBlock:RACSignal *(id value)            /. 网络交互代码               switchToLatest        deliverOn:RACScheduler mainThreadScheduler;     

28、; / 绑定创建按钮的 UI state 和点击事件     self.createButton rac_signalForControlEvents:UIControlEventTouchUpInside executeCommand:createAccountCommand;   Sequencessequence 表现为RACSequence类，可以简单看做是RAC世界的NSArray，RAC增加了-rac_sequence方法，可以使诸如NSArray这些集合类（collection classes）直接转换为RACSeque

29、nce来使用。Schedulersscheduler 表现为RACScheduler类，类似于GCD，but schedulers support cancellationbut schedulers support cancellation, and always execute serially.ReactiveCocoa的简单使用实践出真知，下面就举一些简单的例子，一起看看RAC的使用Subscription接收 -subscribeNext: -subscribeError: -subscribeCompleted: 1234567RACSign

30、al *letters = "A B C D E F G H I" componentsSeparatedByString:" ".rac_sequence.signal; / 依次输出 A B C Dletters subscribeNext:(NSString *x)     NSLog("%", x); Injecting effects注入效果 -doNext: -doError: -doCompleted:，看下面注释应该就明白了： 1

31、234567891011121314151617181920 _block unsigned subscriptions = 0;   RACSignal *loggingSignal = RACSignal createSignal: RACDisposable * (id&lt;RACSubscriber&gt; subscriber)     subscriptions+;     subscriber sendCompleted;     r

32、eturn nil; ;   / 不会输出任何东西 loggingSignal = loggingSignal doCompleted:     NSLog("about to complete subscription %u", subscriptions); ;   / 输出: / about to complete subscription 1 / subscription 1 loggingSignal subscribeCompleted:     NSLog(&q

33、uot;subscription %u", subscriptions); ;   Mapping-map: 映射，可以看做对玻璃球的变换、重新组装 1234567RACSequence *letters = "A B C D E F G H I" componentsSeparatedByString:" ".rac_sequence; / Contains: AA BB CC DD EE FF GG HH IIRACSequence *mapped = letters map:(NSString *value)

34、     return value stringByAppendingString:value; Filtering-filter: 过滤，不符合要求的玻璃球不允许通过 1234567 RACSequence *numbers = "1 2 3 4 5 6 7 8 9" componentsSeparatedByString:" ".rac_sequence;   / Contains: 2 4 6 8 RACSequence *filtered = numbers filter: B

35、OOL (NSString *value)     return (Value % 2) = 0; ;   Concatenating-concat: 把一个水管拼接到另一个水管之后 123456RACSequence *letters = "A B C D E F G H I" componentsSeparatedByString:" ".rac_sequence;RACSequence *numbers = "1 2 3 4 5 6 7 8 9" co

36、mponentsSeparatedByString:" ".rac_sequence; / Contains: A B C D E F G H I 1 2 3 4 5 6 7 8 9RACSequence *concatenated = letters concat:numbers; Flattening-flatten:Sequences are concatenated 1234567 RACSequence *letters = "A B C D E F G H I" componentsSeparatedByString:&q

37、uot; ".rac_sequence; RACSequence *numbers = "1 2 3 4 5 6 7 8 9" componentsSeparatedByString:" ".rac_sequence; RACSequence *sequenceOfSequences = letters, numbers .rac_sequence;   / Contains: A B C D E F G H I 1 2 3 4 5 6 7 8 9 RACSequence *flattened = sequenceOfSequence

38、s flatten;   Signals are merged （merge可以理解成把几个水管的龙头合并成一个，哪个水管中的玻璃球哪个先到先吐哪个玻璃球） 12345678910111213141516171819202122RACSubject *letters = RACSubject subject;RACSubject *numbers = RACSubject subject;RACSignal *signalOfSignals = RACSignal createSignal: RACDisposable * (id&lt;RACSubscriber&g

39、t; subscriber)     subscriber sendNext:letters;    subscriber sendNext:numbers;    subscriber sendCompleted;    return nil; RACSignal *flattened = signalOfSignals flatten; / Outputs: A 1 B C 2flattened subscrib

40、eNext:(NSString *x)     NSLog("%", x); letters sendNext:"A"numbers sendNext:"1"letters sendNext:"B"letters sendNext:"C"numbers sendNext:"2" Mapping and flattening-flattenMap: 先 map 再 flatten 12345678910111

41、2131415161718192021222324252627282930 RACSequence *numbers = "1 2 3 4 5 6 7 8 9" componentsSeparatedByString:" ".rac_sequence;   / Contains: 1 1 2 2 3 3 4 4 5 5 6 6 7 7 8 8 9 9 RACSequence *extended = numbers flattenMap:(NSString *num)     return num, num

42、 .rac_sequence; ;   / Contains: 1_ 3_ 5_ 7_ 9_ RACSequence *edited = numbers flattenMap:(NSString *num)     if (Value % 2 = 0)         return RACSequence empty;      else       &

43、#160; NSString *newNum = num stringByAppendingString:"_"         return RACSequence return:newNum;      ;         RACSignal *letters = "A B C D E F G H I" componentsSeparatedByString:" "

44、;.rac_sequence.signal;   letters     flattenMap:(NSString *letter)         return database saveEntriesForLetter:letter;          subscribeCompleted:        

45、0;NSLog("All database entries saved successfully.");        Sequencing-then: 12345678910111213RACSignal *letters = "A B C D E F G H I" componentsSeparatedByString:" ".rac_sequence.signal; / 新水龙头只包含: 1 2 3 4 5 6 7 8 9/ 但当有接收时，仍会执行旧水龙头doNext的

46、内容，所以也会输出 A B C D E F G H IRACSignal *sequenced = letters    doNext:(NSString *letter)         NSLog("%", letter);        then:        return "1

47、2 3 4 5 6 7 8 9" componentsSeparatedByString:" ".rac_sequence.signal;     Merging+merge: 前面在flatten中提到的水龙头的合并 123456789101112131415 RACSubject *letters = RACSubject subject; RACSubject *numbers = RACSubject subject; RACSignal *merged = RACSignal merge: le

48、tters, numbers ;   / Outputs: A 1 B C 2 merged subscribeNext:(NSString *x)     NSLog("%", x); ;   letters sendNext:"A" numbers sendNext:"1" letters sendNext:"B" letters sendNext:"C" numbers sendNext:"2"  

49、Combining latest values+combineLatest: 任何时刻取每个水龙头吐出的最新的那个玻璃球 1234567891011121314151617181920RACSubject *letters = RACSubject subject;RACSubject *numbers = RACSubject subject;RACSignal *combined = RACSignal    combineLatest: letters, numbers     reduce:(NSString *letter, NSString *number)         return letter stringByAppend