CocoaPods - 安装与使用

CocoaPods 是 Swift 和 Objective-C Cocoa 项目的依赖管理器。

CocoaPods 使用 Ruby 构建，可以使用 macOS 上可用的默认 Ruby 进行安装。也可以使用 rvm 和 rbenv 工具安装。

安装 CocoaPods

用 rvm 升级 ruby

1. 安装 rvm：curl -L get.rvm.io | bash -s stable

2. 让配置文件生效：

   source ~/.bashrc
   source ~/.bash_profile
   

3. 查看 rvm 当前版本：rvm -v
4. 查看已知 ruby 版本列表：rvm list known
5. 安装最新 ruby 版本：rvm install 2.4 #注意2.4是我安装时的最新版本，以实际查看的最新版本为准
6. 查看当前 ruby 版本：ruby -v

更换 RubyGems 镜像

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
gem sources -l #查看当前数据源

• 注意：确保只有 gems.ruby-china.org
• 如果要升级 RubyGems 版本，可执行：[sudo] gem update --system # 或许需要 sudo 权限

安装/升级 CocoaPods

gem install cocoapods # 升级 CocoaPods，只需要重新 install 即可

• 使用默认的 Ruby 安装可能需要使用 sudo 权限。E.g.: gem install cocoapods
• 如果还是失败可以尝试指定安装位置。E.g.: sudo gem install -n /usr/local/bin cocoapods
• 如果想安装预发布版本可以使用 --pre 参数：E.g.: [sudo] gem install cocoapods --pre
• 详细的安装和升级教程可查看：Getting Started

设置 pod 仓库

[sudo] pod setup

注意：如果 install 时有使用 sudo，这里也需要加上 sudo

这一步时间比较长，耐心等待。如果想查看执行进度，请再打开一个终端，输入命令：

cd ~/.cocoapods
du -sh *

查看当前 CocoaPods 版本

pod --version

使用 CocoaPods

创建 Podfile

touch Podfile && open Podfile # 创建并打开 Podfile 文件

编辑 Podfile

# source 'https://github.com/CocoaPods/Specs.git'
source 'https://cdn.cocoapods.org/' # 推荐使用 CDN 源站

platform :ios, '12.0'
use_frameworks!

target '<Your Target Name>'  do
    pod 'FlyHUD', '~> 1.0.1'
end

• 详细的使用说明：The Podfile
• 详细的语法参考：Podfile Syntax Reference

安装/更新 Pods 库

pod install   # 安装 Pods 库，会更新 CocoaPods的spec 仓库
pod update    # 更新 Pods 库，会更新 CocoaPods的spec 仓库
pod install --verbose --no-repo-update  # 安装 Pods 库，不更新本地仓储，直接更新源
pod update --verbose --no-repo-update   # 更新 Pods 库，不更新本地仓储，直接更新源

解释 install 和 update 之间的区别，以及何时使用的文档：pod install vs. pod update