cocoapods安装和使用

场景一：cocoapods安装步骤

配置 cocoapods需要 ruby, 更新 ruby 需要 rbenv, 下载 rbenv 就需要 homebrew, 所以安装顺序就是 homebrew -> rbenv -> 更新ruby -> cocoapods

安装 Xcode

Xcode：CocoaPods是用于iOS开发的依赖管理工具，因此你需要先安装Xcode。

安装Homebrew

Homebrew：Homebrew是一款Mac OS平台下的软件包管理工具，拥有安装、卸载、更新、查看、搜索等很多实用的功能。它简化了安装和管理软件的过程。

    // 安装Homebrew
    /bin/bash -c "\$(curl -fsSL <https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh>)"

    //验证是否安装brew成功
    brew -v
    
    //更新 Homebrew
    brew update

安装Ruby

Ruby：CocoaPods是用Ruby编写的，因此你需要安装Ruby。虽然macOS自带了Ruby，但你可能需要更新到较新的版本。你可以使用Homebrew来安装或更新Ruby。

brew search ruby   #来查看所有可用的Ruby版本。
brew install ruby@NEW_VERSION  # 替换NEW_VERSION为你想要安装的具体版本号

安装 rbenv（或者rvm）

rbenv（可选）：rbenv和rvm都是 Ruby 版本管理器，允许开发者在同一台机器上轻松安装、切换和管理多个 Ruby 版本。

brew install rbenv  # 安装rbenv

将rbenv初始化脚本添加到你的shell配置文件中

echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.zshrc

使更改生效 & 验证rbenv

source ~/.zshrc  #使更改生效

rbenv --version   #验证rbenv

安装CocoaPods

CocoaPods：最后，当然就是安装CocoaPods本身了。在确认已经安装了Ruby之后，你可以通过运行sudo gem install cocoapods命令来安装CocoaPods。

 sudo gem install cocoapods #安装
 pod --version  # 验证

场景二、cocoapods 卸载->重装

1、如果之前装过cocoapods，最好先卸载掉，卸载命令：

$ sudo gem uninstall -n /usr/local/bin cocoapods

2、查看本地安装过的cocoapods相关东西

$ gem list --local | grep cocoapods

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

会显示如下：然后逐个删除吧：

cocoapods-core (0.39.0)

cocoapods-downloader (0.9.3)

cocoapods-plugins (0.4.2)

cocoapods-search (0.1.0)

cocoapods-stats (0.6.2)

cocoapods-trunk (0.6.4)

cocoapods-try (0.5.1)

$ sudo gem uninstall -n /usr/local/bin cocoapods-core

二、安装

1、 查看下当前ruby版本，如果用这个版本接下来工作失败了，就更新下ruby

 ruby -v

2、更换cocoapods镜像：

$gem sources --remove https://rubygems.org/ 
$ gem sources --add https://gems.ruby-china.com 
$gem sources -l  （用来检查使用替换镜像位置成功）

3、下载安装CocoaPods

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

三、错误处理：

1、ERROR: Could not find a valid gem 'cocoapod' (>= 0) in any repository
说明你还没有安装命令行工具，执行下这个命令:

　Xcode-select --install

就会发现 弹出一个窗问我们是否要安装命令行工具 。 安装完了后 再次sudo gem install cocoapods 发现还是会报同样的错误,可能是权限的问题,使用sudo -i或者sudo su进入到root之后再 执行sudo gem install -n /usr/local/bin cocoapods 。
command+q退出一下 再重新进入Shell里面 执行sudo gem install -n /usr/local/bin cocoapods 会发现出来一大段。
2、本地多个Ruby环境导致pod执行失败
如果执行任意pod指令都失败，失败信息像下面这样：

Ignoring ffi-1.13.1 because its extensions are not built. try: gem pristine ffi —version 1.13.1
Ignoring gem-wrappers-1.4.0 because its extensions are not builts. Try: gem pristine gem-wrappers —version 1.4.0
Traceback (most recent call last):
    23: from /USR/LOCAL/BIN/pod:23:in `<main>`
    22: from /USR/LOCAL/BIN/pod:23:in `load`
    21: from /Users/username/.rvm/rubies/ruby-2.6.0/lib/ruby/gems/2.6.0/gems/cocoapods-1.9.3/bin/pod:36:in `<top (required)>`
    20: from /System/Library/Frameworks/Ruby.frameworks/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/core_ext/kernel_require.rb:54:in `require`

如果是这样子的话，根据错误提示说明是本地有多个Ruby环境导致的，看看根目录下是否多了 rvm 目录，或者.rvm目录下多了个Ruby，删除多余的rvm目录或目录下的Ruby即可。

四、下载指定pod的版本

//Analyzing dependencies
[!] The version of CocoaPods used to generate the lockfile (1.9.2) is higher than the version of the current executable (1.9.1). Incompatibility issues may arise.
Downloading dependencies/
同事的pod版本不一致，git就会一直提示到有这个修改，很烦人。

查看当前pod版本：

pod --version

直接下载想要的pod版本：

sudo gem install cocoapods --version 1.9.1

删除不想要的版本：

sudo gem uninstall cocoapods

Select gem to uninstall:
 1. cocoapods-1.9.1
 2. cocoapods-1.9.2
 3. All versions
> 2
//Successfully uninstalled cocoapods-1.2.1

再次查看当前pod版本：执行一次当前pod的install命令

pod --version
pod install

五、 spec资源所有库的配置信息

  • 在cocoapods安装完成以后,在用户根目录下有个隐藏文件夹，/Users/<user>/.cocoapods.

    image

  • 而/Users/<user>/.cocoapods/repos/master/Specs/里面是cocoapods收录的所有库的配置信息.Specs目录下，并不是直接是以库的名称命名的文件夹，而是分了3层目录，分别以0-f来命名,比如SDWebImage的配置文件位置就是/Users/<user>/.cocoapods/repos/master/Specs/1/1/7/SDWebImage，

    image

  • 这里为什么会分为三层目录,是根据什么划分的呢?其实这里是把某个库的名称做了md5，md5前三位是其所对应的三层目录,比如SDWebImage的md5是1173B6117A2CF4A6756F761AEDAE9D2C，那么其目录结构就是1/1/7.

  • Spec内的框架每一个版本内并不是具体的代码,而是一个json文件,里面记录这该框架当前选中的版本的详细信息,包括作者、github位置....等等.

    image

六、podfile文件 ——关于版本指定约束

  • 一般我们在使用cocoapods导入第三方库前都会生成一个podfile文件,文件中记录着我们要导入的第三方库以及对应的版本信息,比如:

pod 'SDWebImage', '~> 4.3.2'
这里的意思是指:让cocoapods导入SDWbImage框架,版本号4.3.2和版本号处于4.3.2-4.4之间的,不包括4.4和更高版本.

所以要想cocoapods导入的框架是我们想要的,必须了解一下版本制定的约束

  • pod ‘ SDWebImage’ --- 不指定版本，表示希望使用最新版本
  • pod 'SDWebImage', '4.3.2' --- 指定明确版本，表示只想要这个版本
  • 逻辑关系
    '> 0.1' --- 版本号大于0.1的
    ‘>= 0.1’ --- 版本0.1和版本号大于0.1的
    '< 0.1' --- 版本号小于0.1的
    ‘<= 0.1' --- 版本号0.1和版本号小于0.1的
  • 最优匹配
    ‘~> 0.1.2' --- 版本0.1.2和版本号处于0.1.2-0.2之间的,不包括0.2和更高版本
    ‘~> 0.1' --- 版本0.1和版本号处于0.1-1.0之间的,不包括1.0和更高版本
    ‘~> 0' --- 版本0和更高，和没设没啥区别

七、常用命令 pod install、pod update、.pod repo update 、 pod install --no-repo-update

pod install:执行该命令时，如果Podfile.lock文件存在, 则直接从此文件中读取框架信息并且它会只下载Podfile.lock文件中指定的版本安装。对于不在Podfile.lock文件中的pod库，pod install命令会搜索这个pod库在Podfile文件中指定的版本来安装,安装完毕更新Podfile.lock文件；
如果Podfile.lock不存在, 则会读取Podfile文件内的框架信息，然后执行下载并且根据下载好的框架信息, 生成Podfile.lock文件.

pod update:只有当你想要更新pod库的版本时才使用pod update；它不管Podfile.lock是否存在, 都会读取Podfile文件的的框架信息去下载安装，下载好之后, 再根据下载好的框架信息, 生成Podfile.lock文件.

pod repo update: 更新整个.cocoapods下的所有库的配置文件,挨个检查对应的框架有没有新版本发布,有的话更新本地的资源配置文件.

--no-repo-update:跳过检查框架有没有新版本发布的环节,一般配合pod install使用.
pod install --no-repo-update:根据podfile文件或者podfile.lock下载并导入对应的第三方库,跳过检查资源配置文件是否需要更新的环节.

八、 pod 常用命令

$ pod --version  #查看cocoapod 版本
$ gem install cocoapods -n /usr/local/bin  #更新cocoapods
$ cd ~/.cocoapods/repos  #进入 repos目录
$ open ~/.cocoapods/repos  #进入 repos目录
$ pod repo   #查看当前源
$ pod repo add master https://xxx.git  #添加源
$ pod repo remove trunk #移除指定源
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

推荐阅读更多精彩内容