iOS开发中CocoaPods使用及常见问题

1、安装过程

1、更新系统 Ruby 环境

# 这一步骤需要科学上网
$ sudo gem update --system

# 查看已安装的 Ruby 版本（最新版本：3.0.6，截止20200430）
$ gem -v

2、 安装 CocoPods 前先替换镜像源

默认的镜像资源服务器被天朝给墙了。所以需要先更换源地址，然后再安装。

移除原先的 Ruby 源：

$ gem sources --remove https://rubygems.org/

指定为 Ruby China 的镜像源：

$ gem sources --add https://gems.ruby-china.com/

验证新源是否替换成功：

$ gem sources -l
*** CURRENT SOURCES ***

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

3、安装 CocoaPods

使用 ruby 的 gem 命令下载并安装 CocoaPods。

$sudo gem install cocoapods
备注：以上命令在 Mac OS 系统升级到 OS X EL Capitan 版本后需要改为 : $ sudo gem install -n /usr/local/bin cocoapods

$ pod setup

使用 CocoaPods 的镜像索引

所有项目的 Podspec 文件都托管在 https://github.com/CocoaPods/Specs 中。第一次执行 pod setup 时，CocoaPods 会将这些 Podspec 索引文件更新到本地的 ~/.cocoapods/目录下，该索引文件较大且更新非常缓慢。

将 CocoaPods 设置成 gitcafe 或者 occhina 镜像，执行索引更新时会快很多。

pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update

4、pod的使用

在项目中创建一个Podfile(名字可以随便起)文件

pod init

依赖安装

pod install

2、填坑记录

1、gem sources -a https://ruby.taobao.org/报错如下:

Error fetching https://ruby.taobao.org/:
	SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (certificate rejected) (https://ruby.taobao.org/specs.4.8.gz)
	

执行gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/命令替换

2、pod install报错如下

[!] CDN: trunk Repo update failed - 21 error(s):

原因：CocoaPods 1.8将CDN切换为默认的spec repo源，并附带了一些增强功能！CDN支持首先在1.7版本中引入，并在1.7.2中最终确定。它旨在显著加快初始设置和依赖性分析。使用1.8，CocoaPods不再需要克隆现在庞大的master specs repo才能正常工作，用户几乎可以立即将他们的项目与CocoaPods集成。
解决方案：
查看cocoapods官网（http://blog.cocoapods.org/CocoaPods-1.8.0-beta/）有介绍：在Podfile加上source ‘https://github.com/CocoaPods/Specs.git, 就是不用新版本的 CDN

3、pod install报错如下

[!] Invalid `Podfile` file: syntax error, unexpected tIDENTIFIER, expecting end-of-input
target 'bitech' do
        ^~~~~~.
        

经排查,source后面‘没有打全

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '9.0'

target 'bitech' do
  # Comment the next line if you don't want to use dynamic frameworks
  # use_frameworks!

  # Pods for bitech
    pod 'xxx'
end

4、卡在

Cloning spec repo `cocoapods` from `[email protected]:CocoaPods/Specs.git`

打开或者等一等或者参考https://www.jianshu.com/p/2f72345581e0