1.CocoaPods 的安装与使用

作者: 小白哥有话说 | 来源:发表于2016-12-23 16:46 被阅读142次

    一.CocoaPods 的安装
    目前CocoaPods 的最新版本为1.0,于2016年5月10号发布的

    1.替换ruby源 (简单来说就是更换ruby的镜像环境,翻墙到我们指定的环境中才能安装CocoaPods)

    ruby -v 查看ruby 版本

    $ ruby -v
    ruby 2.0.0p648 (2015-04-13 revision 50295) [x86_64-darwin14]
    

    gem sources -l 查看ruby源

    $ gem sources -l
    *** CURRENT SOURCES ***
    
    https://rubygems.org/
    

    https://rubygems.org/ 这个源在墙内无法访问到,所以更换到 https://gems.ruby-china.org

    移除原有的源:
    gem sources --remove https://rubygems.org/
    添加新的源:
    gem source -a https://gems.ruby-china.org
    验证更换是否成功:
    gem sources -l 成功则显示:
    *** CURRENT SOURCES ***
    
    https://gems.ruby-china.org
    

    2.更新gem版本:(gem是管理Ruby的标准包,他的版本低的话,也无法安装CocoaPods)

    gem -v : 查看gem的版本
    2.4.8
    sudo gem update --system   // 更新gem版本,国内的需要切换ruby源
    

    3.开始安装CocoaPods
    安装命令为:

    如果是OS X 10.11 以前安装命令为:(这个没使用过)
    sudo gem install cocoapods
    如果是Mac系统为OS X EL Capitan 用下面的命令(就用这个,其他测试不可行)
    sudo gem install -n /usr/local/bin cocoa pods
    执行以上命令有时候会报:
    Error installing cocoapods:  activesupport requires Ruby version >= 2.2.2,
    详见第三点:三.CocoaPods 的常见坑(错误)
    
    4.卸载CocoaPods 方法(没有用过)
    sudo gem uninstall cocoa pods
    

    终于成功了,别着急,输入:

    pod --version 查看CocoaPods有没有安装成功
    1.1.1  
    

    执行以下命令把cocoa pods 的所有第三方库索引引到本地

    pod setup(慢慢的等待吧,目前是365M的大小,切记不要关闭终端)
    

    打开新的终端:

    cd  ~/.cocoapods/repos (进入这个目录)
    du -sh (查看下载进度)等待完成吧!
    不要偷懒要什么镜像会加快速度,亲测不可以的!
    

    二.CocoaPods 的使用

    1.新建一个Xcode项目工程
    如以我建的TestCocopods为例进行讲解:
    2.新建Podfile文件

    cd  /Users/XXXuser/Documents/Example/TestCocopods(进入到对应的文件目录中)
    touch Podfile  (新建Podfile文件必须用Podfile命名,不要问我为什么)
    

    3.编辑Podfile文件
    用Xcode打开Podfile 文件夹,键入以下的代码
    注意以下我写的“//”注释不要复制到里面去

    platform :ios, '8.0'// 引用1解释
    inhibit_all_warnings!
    
    project 'TestCocopods'// 引用2解释
    
    workspace 'TestCocopods'// 引用3解释
    use_frameworks!
    
    target 'TestCocopods' do// 引用4解释
    pod 'AFNetworking', '~> 3.1.0'// 引用5解释
    end
    

    引用1解释:8.0代表引用的平台的最低版本,不写默认为iOS版本为4.3,所以必须写的
    引用2解释:
    引用3解释:
    引用4解释:
    2和3和4解释都是我当前引用的工程文件的名称
    引用5解释:引用的第三方库名和版本(Cocopods 版本1.0之后必须写上所引用第三方库的版本)
    可以用 pod search 库名 可以查看该库是否存在以及最新的版本等

    注意点:Podfile的编辑,第一次最好用Xcode打开,后续修改可以直接用文本编辑器或者vi命令修改

    4.进入项目根目录中,执行 pod install 命令

    cd  /Users/XXXuser/Documents/Example/TestCocopods(进入到对应的文件目录中)
    pod install  (如此CocoaPods 的第三方库的集成基本完毕)
    

    关闭终端,关闭工程,打开下面图片所示的图片:

    871F74C8-B4EF-4B2A-9128-F4D25C1C852A.png

    愉快的引用第三方库吧!

    三.CocoaPods 的常见坑(错误)
    神坑一:安装CocoaPods 的时候 执行
    sudo gem install -n /usr/local/bin cocoa pods
    报如下的错误:Error installing cocoapods: activesupport requires Ruby version >= 2.2.2.

    错误原因:ruby 的版本比较低造成安装失败,应该这样执行用RVM升级ruby

    $curl -L get.rvm.io | bash -s stable
    //等待安装成功后,出现下面的提示
    In case of problems: https://rvm.io/helpandhttps://twitter.com/rvm_io
    依次执行以下命令
    $source ~/.bashrc 
    $source ~/.bash_profile
    rvm -v 
    //出现
    rvm 1.28.0 (latest) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]
    

    如此RVM升级ruby版本完毕

    $ruby -v  // 查看ruby版本
    $rvm list known
    
    //出现好长的提醒,执行以下命令:
    rvm install 2.2.2  // 安装ruby 2.2.2 版本的命令
    

    如此继续执行:
    sudo gem install -n /usr/local/bin cocoa pods
    安装CocoaPods

    其他神坑暂未碰到,没有发言权!
    四.CocoaPods 的常用快捷键

    以下来源大牛的总结:

    1. pod setup
      将所有第三方的Podspec索引文件更新到本地的~/.cocoapods/repos目录下,更新本地仓库。

    2. pod repo update
      执行 pod repo update更新本地仓库,本地仓库完成后,即可搜索到指定的第三方库,作用类似pod setup。不过这个命令经常不单独调用。比如执行pod setup、pod search、pod install、pod update会默认执行pod repo update

    3. pod search xxx
      查找某一个开源库。查找开源库之前,默认会执行pod repo update指令

    4. pod list
      列出所有可用的第三方库.现在已经2.4W+了.还在不断地增长

    5. pod install

    会根据Podfile.lock文件中列举的版本号来安装第三方框架
    如果一开始Podfile.lock文件不存在, 就会按照Podfile文件列举的版本号来安装第三方框架
    安装开源库之前, 默认会执行pod repo update指令

    1. pod update

    将所有第三方框架更新到最新版本, 并且创建一个新的Podfile.lock文件
    安装开源库之前, 默认会执行pod repo update指令

    1. pod install –no-repo-update
    2. pod update –no-repo-update
      安装开源库之前, 不会执行pod repo update指令

    参考资料:

    CocoaPods的使用教程比较牛:http://ios.jobbole.com/90957/?utm_source=blog.jobbole.com&utm_medium=relatedPosts

    CocoaPods的常见神坑与错误:http://www.jianshu.com/p/ad98a3364803

    相关文章

      网友评论

        本文标题:1.CocoaPods 的安装与使用

        本文链接:https://www.haomeiwen.com/subject/zqmkvttx.html