CocoaPods安装过程及使用

安装CocoaPods查阅了一些资料，整理个人笔记，方便日后查阅。

下载安装Xcode，开发工具，它将帮你安装好 Unix 环境需要的开发包

1.查看ruby版本

             终端输入：$ruby -v 

           此时会出现

 

             pengdeMacBook-Pro:~ peng$ ruby -v

             ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin16]

 

2，升级Ruby环境

            终端输入：$gem update --system

           此时会出现

            ERROR: While executing gem ... (Gem::FilePermissionError)

            You don‘t have write permissions for the /Library/Ruby/Gems/2.0.0 directory.

            pengdeMacBook-Pro:~ peng$  sudo gem update —system

            这个是因为你没有权限去更新Ruby

            这个时候你可以在终端使用：$sudo gem update --system来进行升级

 

3，升级gem

           终端输入 $sudo gem update --system

           此时会出现

 

           RubyGems installed the following executables:

           /System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/bin/gem

            Ruby Interactive (ri) documentation was installed. ri is kind of like man 

            pages for ruby libraries. You may access it like this:

            ri Classname

            ri Classname.class_method

            ri Classname#instance_method

            If you do not wish to install this documentation in the future, use the

            --no-document flag, or set it as the default in your ~/.gemrc file. See

            'gem help env' for details.

            RubyGems system software updated

4，更换Ruby镜像

             终端输入

                          gem sources --remove https://rubygems.org/ 

                          gem sources -a https://gems.ruby-china.org/ 

                          gem sources -l  （用来检查使用替换镜像位置成功）

                          新版镜像

                          gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

 

                 此时出现，表示替换成功

 

                                *** CURRENT SOURCES ***

                                https://gems.ruby-china.org/

 

                注意：

                       在更新完ruby，更换Ruby镜像－－淘宝的那个镜像(https://ruby.taobao.org/ )已经不可用了。

                       官方的需要FQ。所以我们现在用最新支持的ruby镜像(https://gems.ruby-china.org/)

 

5，安装CocoaPods

                    终端输入

                        $sudo gem install -n /usr/local/bin cocoapods --pre     cocoapods beta版

                        $sudo gem install -n /usr/local/bin cocoapods              cocoapods 正式版

                    此时显示

 

                     unable to convert "\x84" from ASCII-8BIT to UTF-8 for lib/active_support/values/unicode_tables.dat

                     Installing ri documentation for activesupport-4.2.9

                     Parsing documentation for cocoapods-core-1.3.0.beta.2

                     Installing ri documentation for cocoapods-core-1.3.0.beta.2

                     Parsing documentation for cocoapods-1.3.0.beta.2

                     Installing ri documentation for cocoapods-1.3.0.beta.2

                     23 gems installed

                    

              错误处理：

                             以前会用  $sudo gem install cocoapods  ,如今会报错

 

            安装：sudo gem install cocoapods报Operation not permitted - /usr/bin/xcodeproj这个错误，解决办法为：

                             用     $ sudo gem install -n /usr/local/bin cocoapods --pre     

                             这段命令代替   sudo gem install cocoa pods 

                               就完美解决了

               注意：

                              $sudo gem update cocoapods       更新命令  （应该用不到或者极少用，不知道还能用不，待测）

 

6.安装

           终端输入      

                      $ pod setup  

               需要等一段时间，安装完成后

 

          使用search命令搜索类库名：

                                            $pod search AFNetworking

          错误处理：

             [!] Unable to find a pod with name, author, summary, or description matching `AFNetworking`

                   先移除掉本地的master,在终端输入  $pod repo remove master

           再次安装 $ pod setup

 

                   但是再次输入pod search fmdb依然是提示找不到,是因为之前pod search的时候生成了search_index.json,

                   把它删除掉即可输入命令：rm ~/Library/Caches/CocoaPods/search_index.json回车

                   即可正常查找，此时安装完成。

 

             参考资料：

                                http://www.cnblogs.com/wangluochong/p/5567082.html

                              http://blog.csdn.net/u013602835/article/details/52956512

                              http://blog.csdn.net/prl18353364833/article/details/53905487

                              http://www.cnblogs.com/i-am-lvjiazhen/p/6148703.html

 

使用篇

 

1.打开xcode,新建一个工程，工程名为CocoapodsSample。

使用命令cd，cd后面跟的是工程目录名，可以直接拉进来，

2，回车后，输入命令创建Podfile文件     

                             $ touch Podfile

 

3，使用vim编辑podfile文件，使用命令

 

                         $ vim Podfile

 

 

4,点击 i  进入编辑模式

 

                platform :ios, '7.0'
                pod "AFNetworking", "2.5.0"

 

 

这两句文字的意思是，当前AFNetworking支持的iOS最高版本是iOS 7.0, 要下载的AFNetworking版本是2.5.0。

在编辑完后按 esc,然后按":",这个时候输入wq保存退出。

5，这时候，你就可以利用CocoPods下载AFNetworking类库了。还是在终端中的当前项目目录下，运行以下命令：

 

                 $ pod install

如果有一些包已经存在了，或者我们更改了Podfile里面的版本，可以使用以下命令更新

 

 

                 $ pod update

 

 

 关于Podfile文件编辑时，第三方库版本号的各种写法：

pod ‘AFNetworking’ //不显式指定依赖库版本，表示每次都获取最新版本

pod ‘AFNetworking’,  ‘2.0’     //只使用2.0版本

pod ‘AFNetworking’, ‘>2.0′     //使用高于2.0的版本

pod ‘AFNetworking’, ‘>=2.0′     //使用大于或等于2.0的版本

pod ‘AFNetworking’, ‘<2.0′     //使用小于2.0的版本

pod ‘AFNetworking’, ‘<=2.0′     //使用小于或等于2.0的版本

pod ‘AFNetworking’, ‘~>0.1.2′     //使用大于等于0.1.2但小于0.2的版本，相当于>=0.1.2并且<0.2.0
pod ‘AFNetworking’, ‘~>0.1′     //使用大于等于0.1但小于1.0的版本
pod ‘AFNetworking’, ‘~>0′     //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本