mac 教程 安装cocoapod(100%成功)试过无数次

一直觉得自己写的不是技术，而是情怀，一个个的教程是自己这一路走来的痕迹。靠专业技能的成功是最具可复制性的，希望我的这条路能让你们少走弯路，希望我能帮你们抹去知识的蒙尘，希望我能帮你们理清知识的脉络，希望未来技术之巅上有你们也有我。

手把手教你安装cocoapod视频教程

安装步骤：经过我多次的安装 做完下面的10就能完成。不行网络问题或者电脑问题。

现在开始安装

0.打开电脑的隐藏文件。defaults write com.apple.Finder AppleShowAllFiles YES;KillAll Finder（需要重启文件夹才能看到）

1.首先查看ruby的版本。 ruby -v

2.查看rvm 版本.。 rvm -v

3.查看源。gem sources -l

4.移除源。gem sources --remove https://rubygems.org/

5.更换源。gem sources --add https://gems.ruby-china.com/

6.查看是否更新成功。 gem sources -l

7.安装cocoapod。 sudo gem install -n /usr/local/bin cocoapods

8.安装本地库。 git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/master

第八步常见问题：
第一：

第二：无法连接

第三：没有安装xcode

可以打开下载库的文件路径，叫同事复制他的文件过来，然后自己pod update 一下就可以了。

安装路径地址：/Users/fenghanxu(用户名文件夹名称)/.cocoapods/repos

有空自己备份一下到百度网盘：下次自己下载替换就可以了。

9.搜索一下 pod search AFNetworking

按q退出

安装完成

---

2022.3.30号之后遇到的问题

1.网络问题：有梯子最好，不然看人品

解决办法：网络问题，如果有梯子就很好解决，如果没有梯子就 不停pod install 直到下载完为止。
问题解决

2.[!] CocoaPods was not able to update the master repo. If this is an unexpected issue and persists you can inspect it running pod repo update --verbose

2022.04.01

这个bug的由来：
当时同事说我的 pod ‘RealmSwift’ 本地太低的。
太低的原因是本地的pod库里面的RealmSwift版本是10.24.2，同事的是10.25.0的。所以我需要更新一下本地的pod库，更新到10.25.0，命令是pod repo update。

需要我用 pod repo update 更新一下，结果终端输入命令之后就产生这个问题。
产生这个原因：
1.网络问题
2.cocoapod版本太低。
当时我用 pod update --verbose --no-repo-update 看到pod版本

解决办法：我当时安装的时候由于没有梯子，用的是国内的源，现在有梯子了，把它切换成原本(国外)的源。下面是操作步骤。

gem sources -l

//查看源头，显示的是https://gems.ruby-china.org/

gem sources --remove https://gems.ruby-china.org/ 

//删掉现有的

gem sources -a https://rubygems.org/

//加入原版的

gem sources -l

//查看源头，显示的是https://rubygems.org/

pod --version 

//查看cocoapods版本 返回1.1.1

gem update cocoapods

pod --version 

// 查看cocoapods版本返回1.3.1

cd   到ios的项目里面

pod update --verbose

在项目的 podFile 所在的目录下更新 pod，成功了

获取打开sourceThree就能够看到数据的变化
问题解决

知识：

1.在2022.06.21，北京的同事更新了DOUAudioStreamer的第三方，需要广州那边的我去更新一下库就可以了，记录一下命令

pod update DOUAudioStreamer --verbose --no-repo-update

2.看下面的图片

pod 'DOUAudioStreamer', :git => 'https://github.com/cute/DOUAudioStreamer.git', :branch => 'gapless'

安装第三方的时候发现上面的写法，意思就是安装DOUAudioStreamer的第三方制定git地址下面的gapless分支。

---

关于安装cocoapod的命令

查看当前版本：
xcodeproj —version
1.5.2
终端执行： 
gem update xcodeproj
Updating installed gems
Nothing to update
提示没有没有更新任何东西
应该是pod的版本太低
查看当前pod 版本号：
pod —version
1.3.1

更新pod版本
终端执行：
sudo gem install cocoapods

安装的pod版本还是1.3.1
当前环境
ruby 2.2.4
pod 1.3.1

so，更新ruby
a.查看已知ruby版本
    rvm list known
b.安装 ruby 2.5.1
    rvm install 2.5.1
c.设置默认
    rvm 2.5.1 —default 
d.查看已安装的ruby
    rvm list
d.删除ruby 2.2.4
    rvm remove 2.2.4
f.查看ruby版本号
    ruby -v

更换镜像源安装cocoapods
查询：
gem sources -l
查看当前是什么连接， 然后替换方式如下：
gem source -r http://rubygems-china.oss.aliyuncs.com
gem source -a https://gems.ruby-china.org/
查看是否验证成功
gem sources -l
成功显示
*** CURRENT SOURCES ***

https://gems.ruby-china.org/

安装cocoapods

$ sudo gem install cocoapods
这样安装的cocoapods仍然为1.3.1

删除cocoapods
$ sudo gem uninstall cocoapods
查看本地安装过的与cocoapods的相关的东西
$ gem list --local | grep cocoapods
cocoapods-deintegrate (1.0.1)
cocoapods-downloader (1.1.3)
cocoapods-plugins (1.0.0)
cocoapods-search (1.0.0)
cocoapods-stats (1.0.0)
cocoapods-trunk (1.3.0)
cocoapods-try (1.1.0)

逐个删除
$ sudo gem uninstall cocoapods-core
$ sudo gem uninstall cocoapods-deintegrate
...

安装cocoapods 1.5.2
$ sudo gem install cocoapods --version 1.5.2
提示安装成功

cd到SwiftRnApp中查看xcodeproj 的版本号
xcodeproj —version
1.5.9
执行： 
pod install
提示成功

---

下面是从我自己印象笔记里面拿过来的，关于安装cocoapod积累的经验和遇到的问题和解决办法

命令行方式：
显示隐藏文件：
defaults write com.apple.Finder AppleShowAllFiles YES;KillAll Finder

不显示隐藏文件：
defaults write com.apple.Finder AppleShowAllFiles NO;KillAll Finder

pod 使用的时候指定路径 pod ‘Spring’, :git => 'https://github.com/MengTo/Spring.git’
pod 使用的时候指定版本 pod ‘SVProgressHUD’, ‘~> 1.1.3’
注意：在终端输入命令时，取$后面部分输入

2018年1月4日，我在小波视频上面看到了关于cocoa pod的安装说明。
http://www.xiaoboswift.com/course/43/task/372/show

2018年10月15日，发现安装pod的第三方失败。所以决定要重新安装。出现这个问题的原因是。ruby的源地址被更改了，所以需要重新指定源。我当时不知道安装了一次，觉得下面的教程大概是没有问题的。下面说明一下这次安装遇到的问题。

下面截图是整个安装过程：其实下面的截图之前是遇到很多坑的，问题大概总结在下面，再次说明，下面的文字流程是可以走通的，不过比今次的截图步骤省了一点。两者总结参考吧。
总结这次安装的问题是；ruby的源问题2018.10.16 用的是https://gems.ruby-china.org 第二个是ruby的版本问题 目前是ruby 2.4.1
第三思想：安装cocoapod之前要安装ruby 安装ruby之前要安装Rvm
1.我觉得ruby除了利用rvm安装之外，应该可以用homeBrow安装。有待证实
2.如果删除rvm的话连ruby也会一起删除，因为rvm是管理ruby的。有待证实


上面的安装一齐顺利

报错1.指定了多个源的地址
*** CURRENT SOURCES ***

http://gems.ruby-china.org
https://gems.ruby-china.org/
https://gems.ruby-china.com/

删除前面两个
gem sources --remove http://gems.ruby-china.org
gem sources --remove https://gems.ruby-china.org/
检测目前的源(其实是检测是否成功删除原)
gem sources -l
打印下面的信息说明已经成功了
*** CURRENT SOURCES ***

https://gems.ruby-china.com/

https://rubygems.org/. 2020.11.5 新装系统打印出来的结果

报错2.源地址被更改了，下面的地址官方网站已经公报了。还有更改的说明方法。

ERROR: While executing gem … (Gem::RemoteFetcher::FetchError)
bad response Not Found 404 (https://gems.ruby-china.org/specs.4.8.gz)

原因：源被更改了
【链接】RubyGems镜像域名更换为https://gems.ruby-china.com
https://gems.ruby-china.org
下面是更改fa

$ gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
$ gem sources -l
*** CURRENT SOURCES ***

https://gems.ruby-china.com/

注意打印确保只有 https://gems.ruby-china.com/ 不能出现多个

问题3. 网络慢老是断线，搞到下载repo(cococapod库失败)
git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master命令应该就可以了。

问题4.
cocoapods报这个错误

env: ruby_executable_hooks: No such file or directory

解决方法如下，在终端中输入

sudo gem install --user-install executable-hooks

问题5
Unable to add a source with url https://github.com/CocoaPods/Specs.git named master-1.

在pod install或pod update时出现如题的错误提示：
错误的原因可能有很多种，其中有可能是升级了Xcode或是安装了新的Xcode，首先要让系统指定一个Xcode
xcode-select -p
输出：/Applications/Xcode.app/Contents/Developer
sudo xcode-select -switch /Applications/Xcode.app/
上面命令重新指定Xcode
—如果Xcode检查没有问题，上面命令可以不做，下面进入正题—
解决办法是：
1、进入/users/用户名/.cocoapods/repos，删除master文件夹
2、重新下载CocoaPods仓库
git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
当然你可以用下面方法（备用）
pod repo add master https://github.com/CocoaPods/Specs.git
下载仓库后如有必要pod setup一下
接下来就正常了

问题6error: command line tools are already installed, use “Software Update” to install updates
解决方案：写在rvm重新安装
$ sudo xcode-select --switch /Library/Developer/CommandLineTools/
Password: （输入电脑权限密码）
删除rvm
rm -rf /Library/Developer/CommandLineTools

问题7 网络不好，需要去安装

卸载 CocoaPod

查看cocoapod的版本
pod --version

如果有安装cocoapod会显示当前版本

如果没有安装cocoapod会显示

大步骤1：
步骤0：
卸载cocoapod
sudo gem uninstall -n /usr/local/bin cocoapods

大步骤2：
步骤1 把cocoapod之前的依赖库都删掉：
#罗列依赖库
$ gem list --local | grep cocoapods

步骤2：(复制粘贴$ 号后面所有的一共四行)
#遍历删除依赖库
$ for i in $( gem list --local --no-version | grep cocoapods );
do
sudo gem uninstall $i;
done

步骤3：
输入密码：fhx
步骤4：删除所有

键盘输入3

步骤5：键盘输入y 回车
问你是否删除红宝石 in addition to the gem? [Yn]

步骤6：再次输入密码按回车

步骤7：又重复出现上面的界面(这里我觉得不一定每次都出现的) 输入3 删除全部
删除全部成功
大步骤3：
步骤8.连文件夹也删除它
#进一步彻底删除文件夹 下面这个是命令来的
$ rm -rf ~/.cocoapods/
验证结果
检查是否删掉cocoapod
真正删掉cocoapod

卸载 RVM

终端中键入：
$ rvm implode
输入 yes
成功删除RVM会显示

为了保险起见还需要执行(自己的Users目录中删除)下面的命令
$ cd ~ ; sudo rm -rf .rvm .rvmrc /etc/rvmrc ;gem uninstall rvm
(同样在自己的Users目录中删除)
最后不要忘记了注释 .bashrc 或者 .bash_profile 或者 .profile 中的相关语句
#[[ -s “KaTeX parse error: Expected 'EOF', got '&' at position 27: …cripts/rvm" ]] &̲& . "HOME/.rvm/scripts/rvm” # Load RVM function
到此成功删除了rvm。
好吧，以后再讲解如何安装RVM吧----很少有人是先讲解卸载，再讲解安装的，就当本末倒置吧！！

    卸载   Ruby(我的Ruby是安装在RVM里面的,删除RVM就连Ruby都删掉了)

现在还知道使用RVM安装Ruby之外，还可以用HomerBrow安装
查看ruby当前的版本
$。ruby -v
获取ruby已安装列表,
$ rvm list
然后卸载ruby
$ rvm remove 2.4.1
重装 RVM 2.4
$ rvm reinstall ruby-2.4.1
升级 Ruby
升级Ruby环境 终端输入：
$ gem update --system

安装RVM

步骤1 － 安装 RVM
输入路径安装
$ curl -L https://get.rvm.io | bash -s stable
成功后显示如下：

执行下面的命令 有点多余 没有反应
$ source ~/.rvm/scripts/rvm
检查一下是否安装正确
$。rvm -v
选择其中的一个版本安装

输入
$ rvm reload


输入
$ rvm -v

步骤2 － 用 RVM 安装 Ruby 环境

列出已知的ruby版本
输入
$ rvm list known

4>、安装ruby2.4
$ rvm install 2.4.1 亲测没有问题(安装完之后如果有问题就升级一下gem update --system）
出现下面的错误(这个好像没有解决，暂时不管，但最后安装cocoa pod成功了，不知道是不是下面的这句代码解决了)

type new path if you wish custom Homebrew installation (the path needs to be writable for user) 提示安装路径
直接回车就可以啦

再回车

输入密码

执行下面的命令
$ xcode-select --install

继续下面的安装步骤

如果ruby的源是正确的就没有必要去执行下面的蓝色部分，先看完蓝色部分的内容，然后查看自己的Ruby源是否正确再执行
查看当前ruby的源
$ gem sources -l
#(移除当前ruby的源)
$ gem sources --removehttps://rubygems.com/ （移除）
#(设置当前ruby的源,淘宝镜像已经不能用了,可以用https://gems.ruby-china.org)
$ gem sources -ahttps://gems.ruby-china.com/ （添加）
#(再次查看当前ruby的源)
$ gem sources -l (查看)
如果Terminal输出：
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
表示切换成功

设置gem为最新版本
$ gem update --system
升级成功后会提示

ruby的源有被提替换的吗

如果没有上面的提示，证明切换源失败，会报下面的错误需要重复执行切换源的步骤。
如果出现
ERROR: While executing gem … (OpenSSL::SSL::SSLError)
hostname “upyun.gems.ruby-china.org” does not match the server certificate
原因是之前用的ruby镜像源是淘宝的,需要切换成https://gems.ruby-china.org/,在终端输入
$ gem sources —remove https://ruby.taobao.org/
$ gem sources -a https://gems.ruby-china.org/

安装CoCoa Pods
安装cocoaPods的命令1 如果这个命令不成功可能没有权限，可以使用下面的命令2.
终端输入：$ sudo gem install cocoapods

我这次很顺利没有提示错误，一次性就成功了。
如果出现这个

说明没有权限，需要输入
安装cocoaPods的命令2
终端输入：$ sudo gem install -n /usr/local/bin cocoapods

安装如下：

到这之后再执行pod setup（PS：这个过程是漫长的，要有耐心）
安装本地库的命令
终端输入：$ pod setup

当出现 下面的提示证明安装完成

尝试搜索AFN
终端输入：$。pod search AFNetworking
第一次安装会出现

稍等一会就可以啦

搜索完成

如果搜索到的版本不是最新的，请查看iOS解决CocoaPods搜索不到最新版SDK的问题

键盘q 退出

自己尝试创建一个文件，试一下

安装成功之后会出现这个图标

2018.11.6安装cocoaPod安装了一个下午失败的总结。

我的苹果电脑跟公司的苹果电脑一起安装cocoapod都是出现上面的这个问题。我查了很多资料，资料上面所不就是下面的3中情况
1.ruby版本太低
首先更新宝石到最新版本，在终端中输入： sudo gem update —system
Latest version already installed. Done. 现在已经是最新版本
2.我们的源有问题，很久以前是 淘宝源的，显示是https://gems.ruby-china.com/
我觉得没有问题是因为2018.10.16的时候用这个源一次过没有报错安装成功了。如果你觉得有问题可以查看源，上面有教程查看源和修改源
3.github上无法链接
然后检查是否可以ping通github上，在终端中输入：ping github.com
4…cocoapods目录下的配置信息错误我们可以一个一个来排除
然后查看pob repo list：
pod repo list
结果显示0 repos，说明没有安装成功;
如果输出下面的信息。说明安装cocoapods没有问题。
appleapple:~ fenghanxu$ pod repo list

master

• Type: git (master)
• URL: https://github.com/CocoaPods/Specs.git
• Path: /Users/fenghanxu/.cocoapods/repos/master

modulizationdemo

• Type: git (master)
• URL: https://github.com/ModulizationDemo/PrivatePods.git
• Path: /Users/fenghanxu/.cocoapods/repos/modulizationdemo

myrepo

• Type: git (master)
• URL: https://gitee.com/lphaitao/myrepo.git
• Path: /Users/fenghanxu/.cocoapods/repos/myrepo

PublicModule

• Type: git (master)
• URL: https://gitee.com/lmt_development_team/LMTPublieModule
• Path: /Users/fenghanxu/.cocoapods/repos/PublicModule

summertian4

• Type: git (master)
• URL: https://github.com/summertian4/ZLYSpec.git
• Path: /Users/fenghanxu/.cocoapods/repos/summertian4

taobao-baichuansdk-alibcspecs

• Type: git (master)
• URL: http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBCSpecs.git
• Path: /Users/fenghanxu/.cocoapods/repos/taobao-baichuansdk-alibcspecs

6 repos

我把上面的4个可能都排除了。没有我的问题，结果我自己归纳了下面的问题。就是卡(确实是网络的问题。下载库太慢)。
5.卡的问题原因
1.rvm安装成功了
2.ruby安装成功了
3.cocoapod安装成功了
4.剩下cocoapod的库未安装。所以每次安装cococapod的库就失败，因为太大。
后来直接从别人的库直接拉过来。结果ok了。不用安装库，然后直接pod install安装自己想要的第三方。但是在公司就算把库拖进去安装第三方都失败。但是回到宿舍。用自己的手机下载就成功了。

今天是2020年6月2日
昨天安装一个新的股票SDK的时候安装失败。然后把RVM Ruby CocoaPod 以及它的库删除了打算重新安装。

首先先说明一下：RVM是红宝石的管理工具 Ruby是红宝石的意思 Cocoapod是红宝石写的。
所以安装cocoaPod要先安装Ruby 安装红宝石要安装RVM 但是Ruby买电脑的时候里面就已经有的。不需要安装。

不知道的问题1：
当初我根据上面的只是把RVM Ruby CocoaPod都删除了。但是发现Ruby还在知道什么问题。
ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin19]

不知道的问题2：
rvm官网 https://rvm.io/
如是我不管就直接去安装rvm 这个是RVM的安装命令 \curl -sSL https://get.rvm.io | bash -s stable
结果老是报错 curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused
一直卡在这里好久 最终都没有解决。
它的意思就是所github的网站链接不了 网上解析 由于某些你懂的因素，导致GitHub的raw.githubusercontent.com域名解析被污染了。

解决办法 在这个地址 https://my.oschina.net/matrixchan/blog/3160812
跟这里的解决办法一样的。
在https://www.ipaddress.com/查询raw.githubusercontent.com的真实IP。

修改hosts
sudo vim /etc/hosts (这里可以不用命令的)自己根据下面的图片赋值一个hosts出来进行修改 覆盖进去就可以
添加如下内容：
199.232.28.133 raw.githubusercontent.com

重新执行
重新执行sudo docker-compose up -d nginx mysql 即可。
不知道的问题3：
执行后出现：
docker-compose: command not found
意思就是没有docker-compose 的指令，查资料安装docker就知道有docker-compose，如是我用homeBrow安装了，结果还是使用不了。有可能是下面的原因:没有读入路径 不过不知道docker的安装路径在哪.
搞着搞着 我发觉越搞越多问题….
然后回想当初。安装cocoaPod的时候。因为ruby自带的，直接就安装cocoaPod就可以了，所以我就不管 试试直接安装cocoaPod。下面的命令

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

然后就是安装本地库

pod setup

以前是一个漫长的等待下载库的。结果一秒左右就下载完了 进去看看什么东西都没有，没有下载过。我也是醉了.

查看一下文件夹俩面什么都没有

如是我直接安装AFN 没想到成功了……

反正都是知道什么鬼….不管了 直接用就算了

网上最新的安装cocoaPod方法 https://www.jianshu.com/p/f43b5964f582

2020.11.11 新系统安装cocoaPod

问题1:（我安装的时候存在这个问题）
现在10.15的系统不能用pod setup命令去安装本地库了 解决办法的地址https://www.jianshu.com/p/340cbbb894fd
具体内容在下面：
在Mac10.15.5上很快就结束了显示set completed 但实际上Cocoapods的目录下并没有master文件，所以执行git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/master。

问题二:安装不存在这个问题
如果发现cocoapod更新不了可能存在两个相同的文件，手动删除一个就可以了
但是使用pod命令更新SDK版本时报错“CocoaPods was not able to update the cocoapods repo. If this is an unexpected issue and persists you can inspect it running pod repo update --verbose”，使用pod repo list查看repo选项，

问题三:安装不存在这个问题
旧的项目在新版本上执行pod update提示 CocoaPods could not find compatible versions for pod “XXX”:
In snapshot (Podfile.lock):
又上网找啊找，终于找到了解决方案：删除Xcworkspace和podfile.lock,重新执行pod isstall。OK！