CocoaPods的使用和安装

更新时间：2020.6.28

安装方式有两种，第一种使用普通的终端命令行去安装，第二种使用工具Homebrew去安装，homebrew是一个安装包工具，可以安装node、git、Cocoapods等工具，相当好用，如何安装Homebrew移驾我的另一篇文章。Homebrew是什么？以及使用

特别更新 + 特别重要（如果你遇到pod install、pod update无法更新下载）

下面我要说的是卡了我一周的一个问题～
因为换了一台新设备，于是我满心欢心的安装Homebrew、RVM、Ruby，接下来就是安装Cocoapods，安装时候怎么都下载不下来cocoapods所需要spec，一周后终于在一个博客上看到，Cocoapods源改变了，以前依据master索引，现在是CDN的Trunk下的索引。Cocoapods 从1.8版本开始CocoaPods将默认源切换到了CDN服务，也就是不再将整个的repo master先下载下来才能正常使用pods而是用按需下载。pod install 和 pod update 速度都很快。怎么做呢？跟我来～

  • 1.删除原来的master索引，使用最新的trunk下的索引
  • 2.查看远程源列表: pod repo list
    master
          Type: git (master)
          URL: https://github.com/CocoaPods/Specs.git
          Path: /Users/iroot/.cocoapods/repos/master
    trunk
          Type: CDN
          URL: https://cdn.cocoapods.org/
  • 3.手动删除master，前往路径：~/.cocoapods/repos/
  • 4.使用 "ping https://raw.githubusercontent.com"命令，ping通后将显示的ip地址与域名追加到hosts文件最后一行，ip地址根据实际显示地址添加即可
  • 5.先cd到etc文件夹，然后执行open . 指令，注意有个点哦。
      $ cd /etc
      $ /etc open .
      找到host文件，拷贝分到桌面，将
      151.101.228.133 raw.githubusercontent.com追加到最后一行，保存。然后替换原有的host文件

      sudo vi /etc/hosts
      添加 199.232.4.133 raw.githubusercontent.com，这样我们不需要master这个文件，我们也能正常通过cdn的方式使用cocoapods了

正文

一、CocoaPods简介

CocoaPods是IOS项目上负责管理依赖的工具，即对第三方库的依赖。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。

二、使用Homebrew工具安装 Ruby + CocoaPods

安装ruby（这里使用Homeview来安装ruby，安装Homebrew的方法在文章开头有链接）

  • 1.brew install ruby（安装最新版的ruby）
  • 2.ruby --version（ruby版本）
  • 3.curl -sSL https://get.rvm.io | bash -s stable（RVM 是一个便捷的多版本 Ruby 环境的管理和切换工具.安装它，官网：https://rvm.io/）
  • 4.rvm get stable（rvm更新）
  • 5.rvm --version（rvm版本）
  • 6.sudo gem update --system（gem更新）
  • 7.gem sources --remove https://rubygems.org/（移除之前的源）
  • 8.gem sources --add https://gems.ruby-china.com/（设置新的源）
  • 9.gem sources -l（查看当前源）
  • 10.gem --version（gem版本）
    注意：如果你第一次安装ruby你可以忽略345的命令，还有就是遇到You can try adding it manually in `/Users/XXX/.cocoapods/repos` 这种问题直接去github下载然后放到路径下就好了，是因为文件太大网不好。

安装cocoapods

  • 1.sudo gem install -n /usr/local/bin cocoapods（安装cocoapods）
  • 2.pod setup（安装本地库）
  • 3.pod repo update（更新本地库）
  • 4.pod --version（pod版本）

卸载cocoapods

  • 1.sudo gem uninstall -n /user/local/bin cocoapods
三、使用终端命令安装 Ruby + CocoaPods

安装ruby

  • 1.ruby -v（查看当前ruby版本）
  • 2.gem sources -l（查看当前镜像地址）
  • 3.gem sources --remove https://rubygems.org/（移除原本镜像地址）
  • 4.gem sources -a https://gems.ruby-china.com（替换镜像，防止被翻）
  • 5.gem sources -l（检查替换镜像是否成功）

安装Cocoapods

  • 1.sudo gem install cocoapods
四、安装好Cocoapods的使用
  • 1.新建一个项目，假设项目名称为HelloWord
  • 2.终端输入：cd HelloWord文件路径
  • 3.创建Podfile配置文件，终端输入：vim Podfile
  • 4.接着键盘输入i进入编辑模式，继续输入以下内容：
platform:ios, '8.0'
target 'HelloWord'
pod 'Masonry', '~> 1.1.0'
  • 5.键盘按下ESC键，然后输入“:wq”进入vim命令模式，回车
  • 6.终端继续输入pod install，到此恭喜你，你安装好了CocoaPods，并且导入了一个第三方库Masonry，以后打开该项目只需找到HelloWord文件夹下后缀名为.xcworkspace打开即可。
五、CocoaPods命令集合

1.pod init ：初始化
2.pod install ：安装库
3.pod update ：更新库
4.pod search XXX ：查找所需三方库
5.gem install cocoapods --pre ：更新Cocoapods
6.pod env ：查看已经安装的cocoapods版本
7.pod outdated ：查看Podfile文件中的依赖库的最新版本

六、Cocoapods使用过程中遇到的问题以及错误ERROR（持续更新）

1.[!] Invalid `Podfile` file: syntax error, unexpected end, expecting end-of-input
解决方案：这是因为你Podfile文件内容输入错误，好好检查一下吧～
2.Specs satisfying the `Kingfisher (~> 5.13.3)` dependency were found, but they required a higher minimum deployment target.
解决方案：原因是因为三方库本身支持最低版本是10.0，而我设置了8.0因此报错
3.[!] Unable to find a specification for `XXX`You have either: * out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.* mistyped the name or version.* not added the source repo that hosts the Podspec to your Podfile.
解决方案：由于本地repo中没有该库或者该版本导致的，执行pod repo update即可，你会发现pod repo update真的很慢，加快速的就是更新某个库pod repo update后拼接库的路径即可XXX.podspec.json(例如：repo update ~/.cocoapods/repos//master/Specs)

七、Cocoapods相关知识点（持续更新）
  • 1.pod install 和 pod update的区别以及使用场景:
pod install：会去检查podfile.lock是否已经包含该库，如果包含则继续判断是否指定版本，如果指定版本就去检查podfile.lock中保存的版本是否与新指定的相同，相同则跳过，不相同则更新，如果没有指定版本则不检查更新直接跳过，如果不包含该库则去下载该库并将版本保存在podfile.lock文件中。每次当pod install 命令运行，并下载安装新的pods的时候，他会在Podfile.lock中为每个pod写入它安装的版本。此文件跟踪每一个已安装的版本，并且锁定这些版本。当运行pod install 的时候它仅仅解析那些Podfile.lock中位列出的依赖关系。对于Podfile.lock中列出的pods，它仅仅会下载指明的版本，不会去检查是否有新版本可用。对于Podfile.lock中未列出的pods，他会搜索与Podfile中内容相匹配的版本 (例如 pod 'MyPod', '~>1.2')。
pod update：这个命令会忽略Podfile.lock中的记录，直接去找符合Podfile文件中的该依赖库的约束版本（无约束的话就是最新版本）。一般在你想要更新pods到一个新的版本的时候使用。当运行pod update PODNAME时，CocoaPods将尝试查找PODNAME的更新版本，而不考虑Podfile.lock中列出的版本。 它会将pod更新为可能的最新版本（只要它与Podfile中的版本限制相匹配）。如果运行pod更新没有pod名称，CocoaPods将更新您Podfile中列出的每个pod到最新的版本。

pod install使用场景：
  a.新创建工程，第一次引入pod库时
  b.修改了Podfile文件，添加或删除了所依赖的pod库时。
  c.团队中新人拉取工程后获取pod库时。
  d.团队中，不同开发者要同步对pod库的依赖时(有人改变了依赖关系，删除或增加pod时。还有就是有人执行了pod update,此时他的Podfile.lock文件中的跟踪版本就已经变更，此时，其他人只要pod install就能更新为和Podfile.lock文件中的版本。还有就是如果Podfile和Podfile.lock的记录相冲突，Podfile文件中指定了低于Podfile.lock中记录的版本。会以Podfile文件为准，并在获取成功后更新Podfile.lock文件。)

pod update使用场景：
  a.一般在你想要更新pods到一个新的版本的时候使用。
  • 2.podfile指定版本号时的逻辑运算符
    Besides no version, or a specific one, it is also possible touse logical operators:
    '> 0.1'    Any version higher than 0.1         0.1以上
    '>= 0.1'   Version 0.1 and any higher version  0.1以上，包括0.1
    '< 0.1'    Any version lower than 0.1          0.1以下
    '<= 0.1'   Version 0.1 and any lower version   0.1以下，包括0.1
    In addition to the logic operators CocoaPods has an optimisicoperator ~>:
    '~> 0.1.2' Version 0.1.2 and the versions up to 0.2, not including 0.2 and higher  0.2以下(不含0.2)，0.1.2以上（含0.1.2）
    '~> 0.1' Version 0.1 and the versions up to 1.0, not including 1.0 and higher      1.0以下(不含1.0)，0.1以上（含0.1）
    '~> 0' Version 0 and higher, this is basically the same as not having it.          0和以上，等于没有此约束
  • 3.Podfile.lock
    a.Podfile.lock这个文件是我们新建Podfile文件后会自动生成的一个文件，里面存储了我们已经安装的依赖库的版本。
    b.当我们第一次运行Podfile时，如果对依赖库不指定版本的话，cocoapods会安装最新的版本，同时将pods的版本记录在Podfile.lock文件中。这个文件会保持对每个pod已安装版本的跟踪，并且锁定这些版本。再执行pod install的话，只会处理没有记录在Podfile.lock中的依赖库，会查找匹配Podfile中描述的版本。对于已经记录在Podfile.lock的依赖库，会下载Podfile.lock文件中记录的版本，而不会检查是否有更新。当然，如果你约束了pods的版本的话，会按照你指定的版本进行安装，同时也会更新Podfile.lock记录的信息。
    c.Podfile.lock内部
PODS:
  - Masonry (1.1.0)
DEPENDENCIES:
  - Masonry (~> 1.1.0)
SPEC REPOS:
  trunk:
    - Masonry
  SPEC CHECKSUMS:
    Masonry: 678fab65091a9290e40e2832a55e7ab731aad201
    PODFILE CHECKSUM: 7a5a6c829f4d2252e3e3d116ab9757a3b270ed8a
    COCOAPODS: 1.9.3

  • 4.Cocoapods原理
    是将所有的依赖库都放到另一个名为Pods的项目中, 然而让主项目依赖Pods项目,这样,源码管理工作任务从主项目移到了Pods项目中.
    a.Pods项目最终会编译成一个名为libPods.a的文件, 主项目只要依赖这个.a文件即可.
    b.对于资源文件, CocoaPods提供了一个名为Pods-resources.sh的bash脚步, 该脚本在每次项目, 编译的时候都会执行,将第三方库的各种资源文件复制到目标目录中.
    c.CocoaPods通过一个名为Pods.xcconfig的文件在编译设置所有的依赖和参数

  • 5.Cocoapods下载原理
    s.source = { :git => 'git@gitlab.xxx.net:ios-thirdpartservice/xxxreact.git', :tag => '1.0.0' }
    当使用Cocoapods导入私有库时，Cocoapods先是根据:git => ‘git@gitlab.xxx.net:ios-thirdpartservice/xxxreact.git’找到对应的git仓库，然后根据:tag => ‘1.0.0’定位到对应tag的提交（如果没有注明Pod依赖库版本则定位到最后一次的提交），然后在这次提交中检索缀为.podspec的文件（文件可以随便命名）。找到podspec文件后先要验证s.name是否与Podfile中的一致，如果不一致则install时会报错：[!]Unable to find a specification for ‘React’.验证成功后，就会根据Podspec中的s.source_files找到需要导入的代码文件，并通过其他的的数据找到对应的配置文件或资源文件等。最后，将其下载到本地项目中。如果是共有库，这些原理也相同。只是共有库要将podspec文件上传到cocoapods。在导入的时候通过名字React去cocoapods匹配对应的podspec，然后根据s.source去找到对应的仓库和对应的版本，然后会再去匹配新的podspec，后边的步骤就完全相同了。

  • 6.Cocoapods集成原理
    当所有的依赖库都下载完后，Cocoapods会将所有的依赖库都放到另一个名为Pods的项目中，然后让主项目依赖Pods项目。这样，源码管理工作都从主目录移到了Pods项目中。Pods项目最终会编译成为一个名为libPods.a的文件，主项目只要依赖这个.a文件即可。对于资源文件，Cocoapods提供了一个名为Pods-resource.sh的bash脚本，该脚本在每次项目编译的时候都会执行，将Pods依赖库的各种资源文件复制到目标目录中。Cocoapods还通过一个名为Pods.xcconfig的文件来在编译时设置所有的依赖和参数。

  • 7.Cocoapods版本控制原理
    当执行完pod install之后，cocoapods会生成一个podfile.lock的文件。podfile.lock文件最大的用处在于多人开发。如果你没有在podfile中指定pods版本pod ‘React’，那么默认为获取当前React依赖库的最新版本。当团队中的某个人执行完pod install命令后，生产的podfile.lock文件就记录下了当时最新pods依赖库的版本，这时团队中的其他人check下来这份包含podfile.lock文件的工程以后，再去执行pod install命令时，获取下来的pods依赖库的版本和最开始用户获取到的版本一致。如果没有podfile.lock文件，后续所有用户执行pod install命令都会获取最新版本的React,这就可能造成一个团队使用的依赖库版本不一致，这对团队协作来说绝对是个灾难。在这种情况下，如果团队想使用当前最新版本的React依赖库，有两种方案：1、更改podfile，使其指向最新版本的React依赖库 2、执行pod update命令；鉴于podfile.lock文件对团队协作如此重要，所以应该加入到版本控制里面。

  • 8.pod 管理的第三方库有 MJExtension.Framework 和 SDWebImage.Framework, 如何在MJExtension的某个类中使用来自SDWebImage库的类
    a.在pod中 找到MJExtension, 在Build Phases 中 导入SDWebImage.Framework
    b.在pod的MJExtension.Framework 中, 找到Build Settings 配置Framework Search Paths 的 Debug 和 Release, 添加 (inherited) 和 "PODS_CONFIGURATION_BUILD_DIR/SDWebImage"
    c.在pod的MJExtension.xcconfig中 添加 ： FRAMEWORK_SEARCH_PATHS = (inherited) "PODS_CONFIGURATION_BUILD_DIR/SDWebImage"

  • 9.指定repo镜像
    pod repo remove master
    pod repo add master https://gitee.com/mirrors/CocoaPods-Specs （gitee镜像）
    pod repo update
    pod repo remove master
    pod repo add master https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git （清华镜像）
    pod repo update
    source 'https://gitee.com/mirrors/CocoaPods-Specs.git'
    source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'

参考文章：
IOS基础知识-CocoaPods原理篇

好文章：
CocoaPods

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 159,835评论 4赞 364
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 67,598评论 1赞 295
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 109,569评论 0赞 244
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 44,159评论 0赞 213
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 52,533评论 3赞 287
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 40,710评论 1赞 222
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 31,923评论 2赞 313
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 30,674评论 0赞 203
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 34,421评论 1赞 246
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2赞 245
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1赞 260
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 28,428评论 2赞 254
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 33,114评论 3赞 238
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0赞 8
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0赞 197
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2赞 276
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2赞 271