CocoaPods,「 配置与使用 」

CocoaPods

  • 在 iOS 项目的开发中,开发者必然会用到一些三方的库,需要导入一堆相关依赖库,更新的时候也要删掉重新导入然后再配置,当我们需要更新某个第三方库的时候,我们又要手动移除该库,导入新的库,然后再配置,这些是很麻烦且没有意义的工作。
  • 这时我们需要一个三方库文件管理的工具,来方便管理库文件:CocoaPods,就是帮助开发者解决三方库文件,导入,更新的。
  • 说白了 CocoaPods 就是三方库的管理工具。
  • 使用 CocoaPods 更方便管理我们的三方库文件。

Ruby,Gem

  • Gem 的使用,GemRuby 的包管理工具,Ruby 的各种插件是通过 Gem 来安装的, CocoaPods 就是 Ruby 开发的一个插件。
  • 在使用 Gem 来安装 CocoaPods 时, 建议先更新 Gem 的版本,( GemMac OS 自带的我们不需要安装 ,但是需要更新下,防止安装失败)。
  • 查看 Gem 版本:

查看 Gem 版本

1
2
3
gem --versio 
gem -v


Gem 升级

  • Gem 升级:
    1
    2
    3
    # Gem 升级, 这个主要是解决 Gem 版本过老导致 Cocoapods 不能安装问题
    sudo gem update --system


Gem 更新所有插件

  • Gem 更新所有插件:
    1
    2
    3
    # Gem 更新所有插件
    sudo gem update


Gem 更新所有插件

  • Gem 清除过期插件:
    1
    2
    3
    # 清除过期插件
    sudo gem cleanup



安装 CocoaPods

安装


更换 Ruby 源

  • 以上操作是建立在 Gem 服务器良好的情况下进行的,如果没翻墙,请切换到国内的 Ruby 软件源
  • Ruby 的软件源 https://rubygems.org 因为使用的国外的服务器,所以被墙了,需要切换 Ruby 的源,使用如下 :
  • 淘宝的已经不能用了 https://ruby.taobao.org/
  • 终端输入:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    # 查看 Ruby 源
    gem sources –l
    # 删除自带的 Ruby
    gem sources –remove https://rubygems.org/
    # 删除自带的 Ruby
    gem sources -a https://gems.ruby-china.com
    # 查看 Ruby 源
    gem sources -l

  • 如图:

Tips


CocoaPods 命令简单使用

  • 命令如下:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    # 查看帮助,查看 pod 命令
    pod --help
    # 查看 pod 版本
    pod --version
    # 创建 Podfile 文件
    pod init
    # 搜索库,根据库的名称
    pod search SwpCateGory
    # 安装三方库
    pod install
    # 更新三方库
    pod update


  • pod –help

  • pod search SwpCateGory

CocoaPods ,Podfile 文件编写,三方库的安装

创建 Podfile 文件

使用 pod init 创建
  • 创建 Podfile 文件
  • cd [项目路径]
  • pod init ,或使用 CocoaPods App,创建 Podfile 文件。
  • 如图:

CocoaPods App
  • CocoaPods App 安装三方库:
  • 使用 CocoaPods App 打开,项目中的 Podfile 文件。
  • CocoaPods App 直接点击 Install 进行下载安装 ,等待安装完成。
  • 如图:
  • CocoaPods App下载页面

编写 Podfile 文件

  • 创建完 Podfile 之后使用 CocoaPods App常用编辑器,或 Vim 编辑 Podfile 文件,读者任选其一。
  • 编辑如下:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    # Uncomment the next line to define a global platform for your project
    source https://github.com/CocoaPods/Specs.git'# 镜像位置,可以不用填写。
    platform :ios, ‘8.0’
    target ‘PodDemo’ do
    # Uncomment the next line if you’re using Swift or would like to use dynamic frameworks
    # use_frameworks!
    # Pods for PodDemo
    # 需要安装的三方库文件
    pod ‘SwpCateGory’
    pod ‘SwpRequest’
    end


编写 pod install

  • 编辑完 Podfile 文件,安装三方库
  • 终端安装三方库:
  • cd [项目路径],终端输入:
    1
    2
    # 安装三方库
    pod install
  • 如图:

Tips

  • 进入项目目录,请打开:(重要的事情说说三遍!!!)
  • xxx.xcworkspace!!!
  • xxx.xcworkspace!!!
  • xxx.xcworkspace!!!
  • 而不是 xxx.xcodeproj
  • 如图:
  • 项目结构如图:

CocoaPods 操作

CocoaPods 卸载

1
2
3
# 卸载 CocoaPods
sudo gem uninstall cocoapods


CocoaPods更新 :

1
2
3
# 更新 CocoaPods
sudo gem update cocoapods


CocoaPods 更新测试版 :

1
2
3
# 安装测试版 CocoaPods
sudo gem install cocoapods –pre


CocoaPods 初始化 :

1
2
3
# pod 初始化
pod setup


Tips

  • CocoaPods 初始化操作可能等待的时间过于长久,就是将 podspec 索引文件 下载到 ~/.cocoapods 目录下。
  • 如果你等太久,可以试着 cd ~/.cocoapods 到那个目录,用 du -sh * 来查看下载进度。