CocoaPods,『 安装 & 使用 』

发表于 更新于 分类于 阅读次数：

CocoaPods

  • 在 iOS 项目的开发中，开发者必然会用到一些三方的库，需要导入一堆相关依赖库，更新的时候也要删掉重新导入然后再配置，当我们需要更新某个第三方库的时候，我们又要手动移除该库，导入新的库，然后再配置，这些是很麻烦且没有意义的工作。
  • 这时我们需要一个三方库文件管理的工具，来方便管理库文件：CocoaPods，就是帮助开发者解决三方库文件，导入，更新的。
  • 说白了 CocoaPods 就是三方库的管理工具。
  • 使用 CocoaPods 更方便管理我们的三方库文件。

Ruby，Gem

  • Gem 的使用，Gem 是 Ruby 的包管理工具，Ruby 的各种插件是通过 Gem 来安装的， CocoaPods 就是 Ruby 开发的一个插件。
  • 在使用 Gem 来安装 CocoaPods 时， 建议先更新 Gem 的版本，（ Gem 是 Mac OS 自带的我们不需要安装 ，但是需要更新下，防止安装失败）。

查看 Gem 版本

1
2
gem --versio 
gem -v

Gem 升级

  • Gem 升级：
  • Gem 升级， 这个主要是解决 Gem 版本过老导致 Cocoapods 不能安装问题
1
sudo gem update --system

Gem 更新所有插件

  • Gem 更新所有插件:
1
sudo gem update

Gem 更新所有插件

  • Gem 清除过期插件：
1
sudo gem cleanup

安装 CocoaPods

安装

1
sudo gem install -n /usr/local/bin cocoapods
  • 等待安装成功。

更换 Ruby 源

  • 以上操作是建立在 Gem 服务器良好的情况下进行的，如果没翻墙，请切换到国内的 Ruby 软件源
  • Ruby 的软件源 https://rubygems.org 因为使用的国外的服务器，所以被墙了，需要切换 Ruby 的源，使用如下 ：
  • 淘宝的已经不能用了 https://ruby.taobao.org/
  • 终端输入：
1
2
3
# 更换 Ruby 源, 确保只有 gems.ruby-china.com
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
gem sources -l

Tips

  • 替换完成在输入安装命令即可：
1
sudo gem install -n /usr/local/bin cocoapods
1
2
gem sources --add https://rubygems.org/ --remove https://gems.ruby-china.com/
gem sources -l

CocoaPods 命令简单使用

  • 命令如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 查看帮助，查看 pod 命令
pod --help 

# 查看 pod 版本
pod --version
        
# 创建 Podfile 文件        
pod init

# 搜索库，根据库的名称
pod search SwpCateGory

# 安装三方库
pod install
   
# 更新三方库
pod update

  • search 
1
pod search SwpCateGory

CocoaPods ，Podfile 文件编写，三方库的安装

创建 Podfile 文件

  • 创建 Podfile 文件
  • 终端输入:
1
2
cd <project>
pod init

编写 Podfile 文件

  • 创建完 Podfile 之后使用 CocoaPods App，常用编辑器，或 Vim 编辑 Podfile 文件，读者任选其一。
  • 编辑如下：
1
2
3
4
5
6
7
8
9
10
11
# Uncomment the next line to define a global platform for your project
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '11.0'
target 'Demo' do
    # Comment the next line if you don't want to use dynamic frameworks
    use_frameworks!
    
    # Pods for Demo
    pod 'SwpCateGory'
    pod 'SwpRequest'
end

编写 pod install

  • 编辑完 Podfile 文件，安装三方库
  • 终端安装三方库：
  • 终端输入：
1
2
3
4
# 进入项目
cd <project>
# 安装三方库
pod install

Tips

  • 进入项目目录，请打开：（重要的事情说说三遍！！！）

  • xxx.xcworkspace！！！

  • xxx.xcworkspace！！！

  • xxx.xcworkspace！！！

  • 而不是 xxx.xcodeproj

  • 项目结构:

    项目结构

CocoaPods 操作

CocoaPods 卸载

1
2
# 卸载 CocoaPods
sudo gem uninstall cocoapods

CocoaPods更新 ：

1
2
# 更新 CocoaPods
sudo gem update cocoapods

CocoaPods 更新测试版 ：

1
2
# 安装测试版 CocoaPods
sudo gem install -n /usr/local/bin cocoapods --pre

CocoaPods 初始化 ：

1
2
# pod 初始化
pod setup

Tips

  • CocoaPods 初始化操作可能等待的时间过于长久，就是将 podspec 索引文件 下载到 ~/.cocoapods 目录下。
  • 如果你等太久，可以终端输入:
1
2
cd ~/.cocoapods
du -sh