RAC库的导入教程

-Now to study;步骤0 安装系统需要的包# For Mac # 先安装 *code(developer.apple./*code/) 开发工具，它将帮你安装好 Uni* 环境需要的开发包步骤1 安装 RVMRVM 是干什么的这里就不解释了，后面你将会慢慢搞明白。$ curl -L s:/get.rvm.io | bash -s stable期间可能会问你sudo管理员密码，以及自动通过homebrew安装依赖包，等待一段时间后就可以成功安装好 RVM。然后，载入 RVM 环境新开 Termal 就不用这么做了，会自动重新载入的$ source /.rvm/scripts/rvm检查一下是否安装正确 $ rvm -v rvm 1.22.17 (stable) by Wayne E. Seguin , Michal Papis s:/rvm.io/步骤2 用 RVM 安装 Ruby 环境$ rvm instal同样继续等待漫长的下载，编译过程，完成以后，Ruby, Ruby Gems 就安装好了。步骤3 设置 Ruby 版本RVM 装好以后，需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本$ rvm 2.0.0 -default同样，也可以用其他版本号，前提是你有用 rvm install 安装过那个版本这个时候你可以测试是否正确$ ruby -v ruby 2.0.0p247 (2013-06-27 revision 41674) *86_64-darwin13.0.0 $ gem -v 2.1.6这有可能是因为Ruby的默认源使用的是cocoapods.org，国访问这个网址有时候会有问题，网上的一种解决方案是将远替换成淘宝的，替换方式如下： 要想验证是否替换成功了，可以执行：$gemsources-l 正常的输出结果：CURRENTSOURCESruby.taobao.org/到这里就已经把Ruby环境成功的安装到了Mac OS *上，接下来就可以进展相应的开发使用了。如何下载和安装CocoaPods？假设你在本地已经安装好Ruby环境，则下载和安装CocoaPods将十分简单，只需要一行命令。在Terminator也就是终端中输入以下命令注意，本文所有命令都是在终端中输入并运行的。什么，你不知道什么是终端？那请小编吃饭，小编告诉你：sudo gem install cocoapods如何使用CocoaPods？为了确定类库你要添加的类库是否支持CocoaPods，可以用CocoaPods的搜索功能验证一下。在终端中输入：$ pod search AFNetworking在终端中进入cd命令你工程所在目录，然后在当前目录下，利用vim创立Podfile，运行：$ vim Podfile 然后在Podfile文件中输入以下文字：platform :ios, 7.0 pod AFNetworking, 2.0 注意，这段文字不是小编凭空生成的，可以在AFNetworking的github页面找到。这两句文字的意思是，当前AFNetworking支持的iOS最高版本是iOS 7.0, 要下载的AFNetworking版本是2.0。然后保存退出。vim环境下，保存退出命令是：:wq 这时候，你会发现你的工程目录中，出现一个名字为Podfile的文件，而且文件容就是你刚刚输入的容。注意，Podfile文件应该和你的工程文件.*codeproj在同一个目录下。这时候，你就可以利用CocoPods下载AFNetworking类库了。还是在终端中的当前工程目录下，运行以下命令：$ pod install 因为是在你的工程中导入AFNetworking，这就是为什么这个命令需要你进入你的工程所在目录中运行。运行上述命令之后，小编的终端出现以下信息：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.*cworkspace. 注意最后一句话，意思是：以后翻开工程就用 CocoaPodsDemo.*cworkspace 翻开，而不是之前的.*codeproj文件。你也许会郁闷，为什么会出现.*codeproj文件呢。这正是你刚刚运行$ pod install命令产生的新文件。除了这个文件，你会发现还多了另外一个文件“Podfile.lock和一个文件夹“Pods。 点击 CocoaPodsDemo.*cworkspace 翻开之后工程之后，工程*code目录构造如下列图：你会惊喜地发现，AFNetwoking已经成功导入工程了红框局部！现在，你就可以开场使用AFNetworking.h啦。可以稍微测试一下，在你的工程任意代码文件中输入：#import 或者 #import AFNetworking.h 然后编译，看看是否出错。如果你严格按照小编上述的步骤来，是不可能出错的啦。至此，CocoPods的第一个应用场景讲述完毕。别看小编写了这么多，其实过程是十分简单的。总结一下就是：1. 先在工程中创立Podfile，Podfile的容是你想导入的类库。一般类库的原作者会告诉你导入该类库应该如何写Podfile；2. 运行命令：$ pod install.下面，小编继续讲述第二种使用场景。场景2：如何正确编译运行一个包含CocoPods类库的工程你也许曾经遇到过特别是新手iOS开发者这种情况，好不容易在GitHub上找到一份代码符合自己想需求，兴冲冲下载下来，一编译，傻眼了，发现有各种各样错误。一看，原来是缺失了各种其他第三方类库。这时候莫慌，你再仔细一看，会发现你下载的代码包含了Podfile。没错，这意味着你可以用CocoaPods很方便下载所需要的类库。下面，小编以代码UAAppReviewManager为例来说明如何正确编译运行一个包含CocoPods类库的工程。UAAppReviewManager是一个能够让你方便地将提醒用户评分的功能参加你的应用中。当你去UAAppReviewManager的GitHub地址下载这份代码之后，翻开E*ample工程UAAppReviewManagerE*ample，编译，你会发现*code报告一大堆错误，根本都是说你编译的这份代码找不到*头文件，这就意味着你要成功编译UAAppReviewManager的E*ample代码，必须先导入一些第三方类库。同时你会发现在UAAppReviewManagerE*ample文件夹下面有三个跟CocosPods相关的文件文件夹：Podfile，Podfile.lock和Pods，如下列图：用这时候，翻开终端，进入UAAppReviewManagerE*ample所在的目录，也就是和Podfile在同一目录下，和场景1一样，输入以下命令由于已经有Podfile，所以不需要再创立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 UAAppReviewManagerE*ample.*cworkspace. 这时候，再回到UAAppReviewManagerE*ample文件夹看一看，会看到多了一个文件UAAppReviewManagerE*ample.*cworkspace：根据终端的信息提示，你以后就需用新产生的UAAppReviewManagerE*ample.*cworkspace来运行这个E*ample代码了。翻开UAAppReviewManagerE*ample.*cworkspace，编译运行，成功！如下列图：注意，这里有个小问题，如果刚刚你不是输入$ pod update，而是输入$ pod install，会发现类库导入不成功，并且终端出现下面提示：! Required version (UAAppReviewManager (from ./) not found for UAAppReviewManager. Available versions: 0.1.6 这里的意思大概是Podfile文件过期，类库有升级，但是Podfile没有更改。$ pod install只会按照Podfile的要求来请求类库，如果类库版本号有变化，则将获取失败。但是$ pod update会更新所有的类库，获取最新版本的类库。而且你会发现，如果用了$ pod update，再用$ pod install就成功了。那你也许会问，什么时候用$ pod install，什么时候用$ pod update呢，我又不知道类库有没有新版本。好吧，那你每次直接用$ pod update算了。或者先用$ pod install，如果不行，再用$ pod update。好了，小编就啰嗦到这里吧。上述都只是CocoaPods的最根本用法。要继续研究CocoaPods其他高级用法，请点击这里CocoaPods Wiki。开场动手因为我之前安装了CocoaPods,所以我这次写的ReactiveCocoaDemo 是基于CocoaPods的.如果没有安装的可以童鞋,可以直接从github上下载ReactiveCocoa前期工作:1.翻开*code 创立一个工程,我命名的工程名为ReactiveCocoaDemo,2.终端到工程路径下cdReactiveCocoaDemo/ pod search ReactiveCocoa3.配置依赖文件viPodfile platform :ios,5.0 pod ReactiveCocoawq4.下载文件 pod install /update5:翻开“Build Phases 选中相应的target, 添加 RAC 到 “Link Binary With Libraries.加上libReactiveCocoa-iOS.a如下列图6:在Header Search Paths 中添加$(BUILD_ROOT)/./IntermediateBuildFilesPath/UninstalledProducts/include7:在 “Other Linker Flags 添加 -ObjC8:在ReactiveCocoaDemo-Prefi*.pch 将RAC的头文件加进去#import ReactiveCocoa.hReactiveCocoa和响应式编程在说ReactiveCocoa之前，先要介绍一下FRPFunctional Reactive Programming，响应式编程，在维基百科中有这样一个例子介绍：在命令式编程环境中，a = b + c 表示将表达式的结果赋给a，而之后改变b或c的值不会影响a。但在响应式编程中，a的值会随着b或c的更新而更新。E*cel就是响应式编程的一个例子。单元格可以包含字面值或类似=B1+C1的公式，而包含公式的单元格的值会依据其他单元格的值的变化而变化 。而ReactiveCocoa简称RAC，就是基于响应式编程思想的Objective-C实践，它是Github的一个开源工程，你可以在这里找到它。关于FRP和ReactiveCocoa可以去看leezhong的这篇blog，图文并茂，讲的很好。ReactiveCocoa框架概览先来看一下leezhong再博文中提到的比喻，让你对有个ReactiveCocoa很好的理解：可以把信号想象成水龙头，只不过里面不是水，而是玻璃球(value)，直径跟水管的径一样，这样就能保证玻璃球是依次排列，不会出现并排的情况(数据都是线性处理的，不会出现并发情况)。水龙头的开关默认是关的，除非有了接收方(subscriber)，才会翻开。这样只要有新的玻璃球进来，就会自动传送给接收方。可以在水龙头上加一个过滤嘴(filter)，不符合的不让通过，也可以加一个改动装置，把球改变成符合自己的需求(map)。也可以把多个水龙头合并成一个新的水龙头(combineLatest:reduce:)，这样只要其中的一个水龙头有玻璃球出来，这个新合并的水龙头就会得到这个球。下面我来逐一介绍ReactiveCocoa框架的每个组件StreamsStreams表现为RACStream类，可以看做是水管里面流动的一系列玻璃球，它们有顺序的依次通过，在第一个玻璃球没有到达之前，你没法获得第二个玻璃球。RACStream描述的就是这种线性流动玻璃球的形态，比拟抽象，它本身的使用意义并不很大，一般会以signals或者sequences等这些更高层次的表现形态代替。SignalsSignals表现为RACSignal类，就是前面提到水龙头，ReactiveCocoa的核心概念就是Signal，它一般表示未来要到达的值，想象玻璃球一个个从水龙头里出来，只有了接收方subscriber才能获取到这些玻璃球value。Signal会发送下面三种事件给它的承受方subscriber)，想象成水龙头有个指示灯来汇报它的工作状态，承受方通过-subscribeNe*t:error:completed:对不同事件作出相应反响 ne*t从水龙头里流出的新玻璃球value error获取新的玻璃球发生了错误，一般要发送一个NSError对象，说明哪里错了 completed全部玻璃球已经顺利抵达，没有更多的玻璃球参加了一个生命周期的Signal可以发送任意多个“ne*t事件，和一个“error或者“completed事件当然“error和“completed只可能出现一种Subjectssubjects表现为RACSubject类，可以认为是“可变的mutable信号/自定义信号，它是嫁接非RAC代码到Signals世界的桥梁，很有用。嗯。 这样讲还是很抽象，举个例子吧：123RACSubject *letters=RACSubject subject;RACSignal *signal=letters sendNe*t:a;可以看到a只是一个NSString对象，要想在水管里顺利流动，就要借RACSubject的力。Commandscommand表现为RACCommand类，偷个懒直接举个例子吧，比方一个简单的注册界面： 123456789101112131415161718192021RACSignal *formValid=RACSignalcombineLatest:self.userNameField.rac_te*tSignal,self.emailField.rac_te*tSignal,reduce:(NSString *userName,NSString *email)return(userName.length>0&&email.length>0); RACCommand *createAccountCommand=RACCommand commandWithCanE*ecuteSignal:formValid; RACSignal *networkResults=createAccountCommand addSignalBlock:RACSignal *(id value) /. 网络交互代码 switchToLatest deliverOn:RACScheduler mainThreadScheduler; / 绑定创立按钮的 UI state 和点击事件self.createButton rac_signalForControlEvents:UIControlEventTouchUpInsidee*ecuteCommand:createAccountCommand; Sequencessequence表现为RACSequence类，可以简单看做是RAC世界的NSArray，RAC增加了-rac_sequence方法，可以使诸如NSArray这些集合类collection classes直接转换为RACSequence来使用。Schedulersscheduler表现为RACScheduler类，类似于GCD，but schedulers support cancellationbut schedulers support cancellation, and always e*ecute serially.ReactiveCocoa的简单使用实践出真知，下面就举一些简单的例子，一起看看RAC的使用Subscription接收-subscribeNe*t:-subscribeError:-subscribeCompleted:1234567RACSignal *letters=A B C D E F G H IcomponentsSeparatedByString: .rac_sequence.signal;/ 依次输出 A B C Dletters subscribeNe*t:(NSString *)NSLog(%,*);Injecting effects注入效果-doNe*t:-doError:-doCompleted:，看下面注释应该就明白了：1234567891011121314151617181920_block unsignedsubscriptions=0; RACSignal *loggingSignal=RACSignal createSignal:RACDisposable *(id<RACSubscriber>subscriber)subscriptions+;subscriber sendCompleted;returnnil; / 不会输出任何东西loggingSignal=loggingSignal doCompleted:NSLog(about to complete subscription %u,subscriptions); / 输出:/ about to complete subscription 1/ subscription 1loggingSignal subscribeCompleted:NSLog(subscription %u,subscriptions); Mapping-map:映射，可以看做对玻璃球的变换、重新组装1234567RACSequence *letters=A B C D E F G H IcomponentsSeparatedByString: .rac_sequence;/ Contains: AA BB CC DD EE FF GG HH IIRACSequence *mapped=letters map:(NSString *value)returnvalue stringByAppendingString:value;Filtering-filter:过滤，不符合要求的玻璃球不允许通过1234567RACSequence *numbers=1 2 3 4 5 6 7 8 9componentsSeparatedByString: .rac_sequence; / Contains: 2 4 6 8RACSequence *filtered=numbers filter:BOOL(NSString *value)return(value.intValue%2)=0; Concatenating-concat:把一个水管拼接到另一个水管之后123456RACSequence *letters=A B C D E F G H IcomponentsSeparatedByString: .rac_sequence;RACSequence *numbers=1 2 3 4 5 6 7 8 9componentsSeparatedByString: .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 concatenated1234567RACSequence *letters=A B C D E F G H IcomponentsSeparatedByString: .rac_sequence;RACSequence *numbers=1 2 3 4 5 6 7 8 9componentsSeparatedByString: .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 9RACSequence *flattened=sequenceOfSequences flatten; Signals are merged merge可以理解成把几个水管的龙头合并成一个，哪个水管中的玻璃球哪个先到先吐哪个玻璃球12345678910111213141516171819202122RACSubject *letters=RACSubject subject;RACSubject *numbers=RACSubject subject;RACSignal *signalOfSignals=RACSignal createSignal:RACDisposable *(id<RACSubscriber>subscriber)subscriber sendNe*t:letters;subscriber sendNe*t:numbers;subscriber sendCompleted;returnnil;RACSignal *flattened=signalOfSignals flatten;/ Outputs: A 1 B C 2flattened subscribeNe*t:(NSString *)NSLog(%,*);letters sendNe*t:A;numbers sendNe*t:1;letters sendNe*t:B;letters sendNe*t:C;numbers sendNe*t:2;Mapping and flattening-flattenMap:先 map 再 flatten123456789101112131415161718192021222324252627282930RACSequence *numbers=1 2 3 4 5 6 7 8 9componentsSeparatedByString: .rac_sequence; / Contains: 1 1 2 2 3 3 4 4 5 5 6 6 7 7 8 8 9 9RACSequence *e*tended=numbers flattenMap:(NSString *num)returnnum,num.rac_sequence; / Contains: 1_ 3_ 5_ 7_ 9_RACSequence *edited=numbers flattenMap:(NSString *num)if(num.intValue%2=0)returnRACSequence empty;elseNSString *newNum=num stringByAppendingString:_;returnRACSequence return:newNum; RACSignal *letters=A B C D E F G H IcomponentsSeparatedByString: .rac_sequence.signal; lettersflattenMap:(NSString *letter)returndatabase saveEntriesForLetter:letter;subscribeCompleted:NSLog(All database entries saved successfully.); Sequencing-then:12345678910111213RACSignal *letters=A B C D E F G H IcomponentsSeparatedByString: .rac_sequence.signal;/ 新水龙头只包含: 1 2 3 4 5 6 7 8 9/ 但当有接收时，仍会执行旧水龙头doNe*t的容，所以也会输出 A B C D E F G H IRACSignal *sequenced=lettersdoNe*t:(NSString *letter)NSLog(%,letter);then:return1 2 3 4 5 6 7 8 9componentsSeparatedByString: .rac_sequence.signal;Merging+merge:前面在flatten中提到的水龙头的合并123456789101112131415RACSubject *letters=RACSubject subject;RACSubject *numbers=RACSubject subject;RACSignal *merged=RACSignal merge:letters,numbers; / Outputs: A 1 B C 2merged subscribeNe*t:(NSString *)NSLog(%,*); letters sendNe*t:A;numbers sendNe*t:1;letters sendNe*t:B;letters sendNe*t:C;numbers sendNe*t:2; Combining latest values+combineLatest:任何时刻取每个水龙头吐出的最新的那个玻璃球1234567891011121314151617181920RACSubject *letters=RACSubject subject;RACSubject *numbers=RACSubject subject;RACSignal *combined=RACSignalcombineLatest:letters,numbersreduce:(NSString *letter,NSString *number)returnletter stringByAppendingString:number;/ Outputs: B1 B2 C2 C3combined subscribeNe*t:(id*)NSLog(%,*);letters sendNe*t:A;letters sendNe*t:B;numbers sendNe*t:1;numbers sendNe*t:2;letters sendNe*t:C;numbers sendNe*t:3;Switching-switchToLatest:取指定的那个水龙头的吐出的最新玻璃球1234567891011121314151617181920212223RACSubject *letters=RACSubject subject;RACSubject *numbers=RACSubject subject;RACSubject *signalOfSignals=RACSubject subject; RACSignal *switched=signalOfSignals switchToLatest; / Outputs: A B 1 Dswitched subscribeNe*t:(NSString *)NSLog(%,*); signalOfSignals sendNe*t:letters;letters sendNe*t:A;letters sendNe*t:B; signalOfSignals sendNe*t:numbers;letters sendNe*t:C;numbers sendNe*t:1; signalOfSignals sendNe*t:letters;numbers sendNe*t:2;letters sendNe*t:D; 常用宏RAC 可以看作*个属性的值与一些信号的联动1234RAC(self.submitButton.enabled)=RACSignal combineLatest:self.usernameField.rac_te*tSignal,self.passwordField.rac_te*tSignalreduce:id(NSString *userName,NSString *password)return(userName.length>=6&&password.length>=6);RACObserve 监听属性的改变，使用block的KVO1234RACObserve(self.te*tField,te*t)subscribeNe*t:(NSString *newName) NSLog(%,newName); UI EventRAC为系统UI提供了很多category，非常棒，比方UITe*tView、UITe*tField文本框的改动rac_te*tSignal，UIButton的的按下rac_command等等。. z.