CocoaPods安装教程

前言

• 由于升级到Xcode 8，原来那么多好用的插件都不能用了，其中也包括CocoaPods插件，无奈之下只得通过终端使用了
• CocoaPods能让开发者非常方便的使用第三方类库，并且为我们的工程设置好相应的系统依赖和编译参数
• 其他介绍性的描述我就不说了，直接把我遇到的问题总结一下，以免重复踩坑~~~

准备工作

• 替换RubyGems 镜像

  • 由于天朝网络管制的原因，正常安装的话会神慢，所以安装前需要先替换RubyGems 镜像，这里提供两个RubyGems 镜像供选择
    • 淘宝的源：https://ruby.taobao.org/
    • Ruby China：https://gems.ruby-china.org/

• 替换为其中一个就行了

  // 移除原镜像
  gem sources --remove https://rubygems.org/
  // 替换成淘宝镜像
  gem sources -a https://ruby.taobao.org/
  // 查看当前镜像
  gem sources -l
  

• 升级gem，如果gem版本过低也可能导致CocoaPods安装失败，在终端输入以下命令

  • OS X EI Capitan之前

    sudo gem update --system
    

• OS X EI Capitan之后

  sudo gem update -n /usr/local/bin --system
  

• 升级后通过gem -v命令检查下版本

安装CocoaPods

• OS X EI Capitan之前

  sudo gem install cocoapods
  

• OS X EI Capitan之后

  sudo gem install -n /usr/local/bin cocoapods
  

• 检查版本

  pod --version
  

• 至此CocoaPods的壳已经安装完毕，下面需要初始化CocoaPods

初始化CocoaPods

• 不使用镜像（你看看就行了）

  • 安装完CocoaPods后如果直接在终端输入pod setup，接着出现Setting up CocoaPods master repo，之后就是一个很漫长的等待...
  • 会将数据下载到~/.cocoapods/repo/master目录中，可以cd ~/.cocoapods到此目录，用du -sh *每隔一段时间查看下下载下来的文件大小
  • 初始化数据总共有400多兆，要这么下的话，一天也未必能下载下来

• 使用镜像

  • coding镜像：https://git.coding.net/CocoaPods/Specs.git

    • 实际地址：https://coding.net/u/CocoaPods/p/Specs/git

  • oschina镜像：https://git.oschina.net/akuandev/Specs.git

    • https好像有问题，一直是403
    • 可以用ssh的方式，这里需要到官网去配置ssh
    • 貌似这个镜像已经好久没更新了，果断放弃

  • 替换镜像

    // 先移除原specs仓库
    pod repo remove master
    // 国内镜像，每日自动更新
    pod repo add master https://git.coding.net/CocoaPods/Specs.git
    // 在下载完后执行这一句
    pod repo update
    

• 第二步使用国能镜像下载可能出现的问题

  • 问题1

    • 问题描述

      [!] To setup the master specs repo, please run pod setup.
      

    • 解决办法，切记不要执行pod setup命令，执行此命令后会导致安装第三方会很慢

      // 手动下载 
      git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master 
      // 初始化完成后执行一次
      pod repo update
      

  • 问题2

    • 问题描述

      
      img

    • 解决办法，必须关闭Xcode

      // 在终端中执行下面的命令，按照提示一步一步做完
      // 执行完毕后，再次尝试下载，我通过此办法解决我的问题
      sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
      

• 如果还是没有安装成功，可以尝试删除.cocoapods目录，然后重新安装

  --------------删除 .cocoapods 目录--------------
  cd ~/.cocoapods/
  sudo -rm -rf ~/.cocoapods/
  --------------重新安装--------------
  // 国内镜像，每日自动更新
  pod repo add master https://git.coding.net/CocoaPods/Specs.git
  // 在下载完后执行这一句
  pod repo update
  

• 检查是否安装成功

  pod repo list
  

CocoaPods的使用

• 使用Xcode新建一个工程

• 打开终端，cd到工程目录下

• 生成Podfile文件

  // 会产生一个模板文件
  pod init
  

• 直接用文本打开Podfile文件，粘贴下面的内容进行测试，这两个库下载的快慢可以说明你的镜像是否设置成功

  # platform :ios, '8.0'
  
  target '项目名称' do
  
  pod 'React', '0.13.0-rc' 
  pod 'React/RCTText'
  
  end
  

• 在终端中使用vim编辑器编辑Podfile

  • vi podfile在vim编辑器中打开podfile文件
  • 按i键进入编辑模式
  • 编辑完成后，按esc键退出编辑模式
  • 按:wq组合键并回车退出vim编辑器

• 回到终端执行以下命令，仅第一次执行pod install，之后都执行pod update，当然第一次也可以执行pod update，所以建议使用pod update

• pod update/pod install命令有可能执行过慢（我没有遇到），如果遇到了大概原因是当执行以上两个命令的时候会升级CocoaPods的spec仓库，使用以下命令可以省略这一步，然后速度就会提升不少

  pod install --verbose --no-repo-update
  pod update --verbose --no-repo-update
  

• 完成后进入工程目录，会发现多了.xcworkspace这个文件，即：工作区，以后都打开这个文件，而不要打开工程文件，然后Command+B编译一下，如果没有错误就表示成功添加了

• 以后要添加新的库，就编辑Podfile文件，打开终端，cd到工程根目录下，然后执行pod update命令就可以了