CocoaPods 是一个 Cocoa 和 Cocoa Touch 框架的依赖管理器,具体原理和 Homebrew 有点类似,都是从 GitHub 下载索引,然后根据索引下载依赖的源代码。所有指令操作均在teminal终端中完成
1.更新Gem源 安装cocoaPods之前所做操作
- Gem是一个管理Ruby库(Mac自带)和程序的标准包,他通过Ruby gem 源来查找,安装,升级和卸载软件包(如cocoapods)
// 该源是国外服务器,所以查找安装cocoapods的时候特别慢
// 建议移除该国外源,更改为国内的服务器(https://ruby.taobao.org/)
gem source --remove https://rubygems.org/
gem source -a https://ruby.taobao.org/
// 查找当前源指令
gem source -l
------------------------
最近淘宝镜像好像无效了,如果淘宝镜像不能使用的话,可以尝试下面的镜像源
gem sources -a https://gems.ruby-china.com/ #添加源
------------------------
2.安装 cocoaPods 指令安装的时候所需密码为本机开机密码
安装cocoapods要求Ruby版本为2.2.2以上,点击进入Ruby更新教程
// 安装CocoaPods(OS X 10.11以前)(废弃,不使用)
sudo gem install cocoapods
// 安装CocoaPods(10.11后苹果升级了安全策略)
sudo gem install -n /usr/local/bin cocoapods
版本2.2.2以下的会报以下错误
Error installing cocoapods:
activesupport requires Ruby version >= 2.2.2.
3.更新升级gem如果安装过程中有问题,可以尝试该指令,升级gem(建议安装前升级)
sudo gem update - system
4.初始化第三方库信息第一次安装所有初始化第三方库的信息(以后出现问题,尝试使用该指令)
pod setup
由于是国外服务器,初始化第三方库信息比较慢,建议更改repo镜像为国内服务器
5.更换repo镜像为国内服务器 建议使用gitcafe镜像,第二个貌似不行
pod repo remove master
//建议使用以下清华大学国内源
pod repo add master https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
//下列为其他国内镜像源,亲测,已无效,仅做记录。coding 上每日更新,下面这句语句可忽略
https://git.coding.net/CocoaPods/Specs.git
如果出现Error,使用以下方法:
[!] To setup the master specs repo, please run pod setup
手动将代码clone下来 【该方法比较有效】
git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/master
pod setup//务必在手动下载代码后执行一次,执行后 Setup completed
//在执行
pod install --verbose --no-repo-update //避免去更新了
最后进入自己的工程,在自己工程的podfile第一行加上:
source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
6.以后更新第三方库信息
pod repo update
添加第三方库步骤
// 搜索第三方框架` 例: 搜索afnetwork ,复制搜索结果中 pod `AFNetWorking`,` ~>2.5.4` `
pod search +(指令后面 + 框架关键字)
cd + 工程目录
// 创建pod文件
vim podfile
- 按键盘 i 进入编辑状态后
- 输入 platform:ios,'8.0' 说明开发环境
- use_frameworks! // 这一句是个别第三方需要,如下面的ReactiveCocoa
- target ‘ReactiveCocoaDemo’ do
- pod 'ReactiveCocoa', '~> 4.1.0'
- end
- 复制粘贴搜索到的第三方框架(如pod `ReactiveCocoa`,` ~>2.5.4` `)
- 复制完毕按下 esc 键,然后按键盘键 :wq
安装第三方库pod install
1.将pod的版本写入Podfile.lock文件中.
2.对于已经在Podfile.lock中有记录的Pod下载对应的版本,即便有新的版本,也不会去更新.
3.对于没有记录的,根据Podfile中的约定,下载版本,并把版本信息写入Podfile.lock中.
升级第三方框架pod update
查询当前所用库的最新版本信息pod outdated
常见问题
- 安装过程中如果停留在Analyzing dependencies不动了。原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库,加一个参数可以省略这一步,然后速度就会提升不少。参数的命令如下:
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update