Xcode10:cocoapods最新安装攻略

• 2018.8.28 https://gems.ruby-china.org域名更新为https://gems.ruby-china.com
• 2017.12.1 更新ruby源

最近安装CocoaPods遇到了很多的问题，导致安装了3天才完成，对！你没有看错，安装了整整3天(当中也有网络的问题)。所以有了这篇文章。

• 当前电脑版本: macOS High Sierra 10.13.1
• xcode版本: Version 9.1 (9B55)

一、CocoaPods简介

CocoaPods负责管理iOS项目中第三方框架。CocoaPods的项目源码在Github上管理。项目从2011年8月12日开始,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。(练习时为了速度一般我都是直接导入工程中，个人比较讨厌写纯代码在Podfile文件中)

二、开始安装

安装需要用到Ruby，虽然Mac自带了Ruby，不过版本有点老了，最好更新一下

sudo gem update --system

接下来输入系统密码就可以安装了，输入密码时不会显示的，输完回车就行了(黑色块是我个人加上去的，遮挡用户名的)

输入密码

因为Ruby的软件源rubygems.org被屏蔽了，所以要更换源

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

添加源成功

接下来查看下源路径是否更换了

gem sources -l

和上图一样的源就成功了

**请确保只有 gems.ruby-china.com **
然后就可以更新Ruby了

---

接下来安装Cocoapods了

sudo gem install cocoapods

不过有可能出错(我就是出错了)，出错的话执行下面的命令

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

install出错

安装时会输出很多文件以及进度条

install成功

安装完后你可以输入下面的命令查看是否成功，当前CocoaPods版本为1.0.0

pod --version

查看是否安装成功

安装完cocoapods后进行最蛋疼的一步，设置仓库，就是把所有上传到cocoapods的第三方框架下载每个版本和网络地址以及一些其他描述信息到本地，因为服务器在国外所以比较蛋疼，网速好的直接无视我的话输完下面命令后跳到下载中说明-。-

仓库里装的东西

pod setup

等待下载完

下载完成图

下载完就大功告成了(没有网络问题就可以跳转到三、开始使用了).

---

网速不好，老是报错的这里！(切换到https://gems.ruby-china.com/源后基本不用担心网速了)

之前我也尝试过使用CocoaPods的镜像索引使用国内的镜像，但是没有效果，oschina的应该是因为人流量访问大，所以设置了验证码，而gitcafe马上要停止服务了，所以没办法了(如果你知道还有其他镜像请联系我，贡献出来让我们这些网速差的小白能愉快的安装)

一直报错，503、argumenterror , syntax error on line 4, col 0: `min:0.29.0` 等等，都是你的网络原因导致的

这就要手动下载配置，可以在上面的oschina和gitcafe链接中下载，也可以在github上下载(不过比较慢)，还可以在我的网盘下载 // Tip:手动下载可以用国内的git服务器拷贝,然后下载下来,并且以后更新也可以直接同步更新.

• 百度网盘 2018.08.20更新

下载完成后你可以输入

pod setup

然后control+c 中断，目的是让他帮你创建文件夹
当然你也可以手动创建文件夹，但是文件夹是隐藏的所以你需要在终端输入下面命令然后command+option+esc 重新启动一下Finder，就可以看到隐藏文件，把下面的true改为false就可以不显示隐藏文件

defaults write com.apple.finder AppleShowAllFiles -bool true

随后在Finder点击 前往>前往文件夹 中前往文件，输入下面指令

~/.cocoapods

前往文件也可以按快捷键shift+command+G

文件结构

对比一下可以发现我们下载的文件和安装后的文件只是改了一下文件名，把最外面的文件改为master，然后扔到~/.cocoapods/repos文件夹下就完成设置了

对比图

---

下载中说明

下载中如果不放心，可以新建一个终端窗口分别输入下面两条命令查看下载了多少，下载完成的文件大小如下(2016.5.25日下载的文件)

cd ~/.cocoapods
du -sh *

完成后的文件大小

三、开始使用

设置完成后就可以开始使用了，先创建一个Project，然后创建一个single View Application到桌面，终端中输入cd+空格，把刚刚创建到桌面的文件夹拖到终端中，回车

接下来创建Podfile文件，并编辑

vim Podfile

进入Podfile后输入i编辑状态(可以查看左下角有个INSERT)，进入输入下面命令

platform :ios, '9.3'
use_frameworks!

target 'Test' do
  pod 'SDWebImage', '~>3.7.6'
  pod 'Masonry', '~>1.0.0'
end

<a name="Podfile" id="Podfile">Podfile格式解析</a>

• platform是平台
• ios, '9.3'是指定所支持系统和最低版本
• Test填写你的target名称(target名见下图),pod 后面的就是你需要的框架,'~>里面就是版本',官网的案例是写了版本号的。

这些就是Target名

官网案例

写完后按Esc 然后:wq 意思是保存并退出

编写并保存退出

接着输入，就会把Podfile文件里写的文件下载到当前文件夹，并且创建.xcworkspace

pod install

安装完成时的文件

接下来就可以打开Test(target名).xcworkspace文件导入头文件编写你的程序了。

作者：BIMiracle
链接：https://www.jianshu.com/p/1bb0ad42cb2e
來源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。