CocoaPods,教程「配置与使用」

CocoaPods

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

Ruby,Gem

  • Gem 的使用,GemRuby 的包管理工具,Ruby 的各种插件是通过 Gem 来安装的, CocoaPods 就是 Ruby 开发的一个插件。

  • 在使用 Gem 来安装 CocoaPods 时, 建议先更新 Gem 的版本,( GemMac OS 自带的我们不需要安装 ,但是需要更新下,防止安装失败)。

  • 查看 Gem 版本:

    1
    2
    # 查看 Gem 版本
    gem –version
  • Gem 升级:

    1
    2
    # Gem 升级, 这个主要是解决 Gem 版本过老导致 Cocoapods 不能安装问题
    sudo gem update –system
  • Gem 更新所有插件:

    1
    2
    # Gem 更新所有插件
    sudo gem update
  • Gem 清除过期插件:

    1
    2
    # 清除过期插件
    sudo gem cleanup
  • 如图:


安装 CocoaPods


  • 注意:
  • 以上操作是建立在 Gem 服务器良好的情况下进行的,如果没翻墙,请切换到国内的 Ruby 软件源。
  • Ruby 的软件源 https://rubygems.org 因为使用的国外的服务器,所以被墙了,需要切换 Ruby 的源,使用如下 :
  • 淘宝的已经不能用了 https://ruby.taobao.org/
  • 终端输入:

    1
    2
    3
    4
    5
    6
    7
    8
    # 查看 Ruby 源
    gem sources –l
    # 删除自带的 Ruby
    gem sources –remove https://rubygems.org/
    # 删除自带的 Ruby
    gem sources -a https://gems.ruby-china.org/
    # 查看 Ruby 源
    gem sources -l
  • 如图:



CocoaPods 命令简单使用

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

  • pod –help


  • pod search SwpCateGory


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

  • 创建 Podfile 文件
  • cd [项目路径]
  • pod init ,或使用 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


  • 编辑完 Podfile 文件,安装三方库
  • 终端安装三方库:
  • cd [项目路径],终端输入:

    1
    2
    # 安装三方库
    pod install
  • 如图:


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


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

  • 项目结构如图:


CocoaPods ,卸载,更新。

  • 卸载 CocoaPods:

    1
    2
    # 卸载 CocoaPods
    sudo gem uninstall cocoapods

  • 更新 CocoaPods:

    1
    2
    # 更新 CocoaPods
    sudo gem update cocoapods

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

  • pod 初始化
    1
    2
    # pod 初始化
    pod setup

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