Cocoapods的安装和使用

Note Tools

Word count: 890Reading time: 3 min

 2021/03/15 

Cocoapods的安装、使用及换源

Cocoapods是什么

Cocoapods是一个为你的项目管理第三方库以及建立和管理lib依赖的工具，可以让你优雅地使用第三方框架。

1.安装

我们用macos自带的gem来安装Cocoapods，在安装前建议将gem更新至最新的版本。如果ruby版本过老，也建议同时更新ruby版本
在这之前，我建议你先将gem的源更换为国内镜像源
首先打开终端。Command+空格输入terminal后回车

//更换源
$ sudo gem sources -a https://ruby.taobao.org/ 
//检查是否成功更换
$ gem sources –l
//更新gem
$ sudo gem update --system

在处理好gem的相关事宜后，我们开始来安装cocoapods

1	$ sudo gem install cocoapods

如果出现类似于权限不够无法读写的报错，尝试执行下面这条命令

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

在看到成功安装的提示后，执行下面这条命令。由于是第一次初始化cocoapods，请耐心等待。

1	$ pod setup

至此，安装部分完成。

2.使用

我们可以用$ pod search xxx命令来搜索源库中是否有我们需要的框架
接着我们cd到项目文件夹下，并初始化Podfile文件

1
2
3

$ cd [项目路径]
//直接将项目文件夹拖入终端即可
$ pod init

至此你会发现在项目文件夹中多出了一个名称为Podfile的文件。熟悉vim的同学可以直接在终端内使用vim打开此文件。我个人更喜欢用macos的文字编辑器打开。
打开后我们需要编辑以下信息

     platform :ios, '12.0'
//需要将ios版本修改至与自己的项目对于的版本号
 #  MyApp 就是 TARGET NAME 会自动生成
     target 'MyApp' do
# `在target '项目名' do`下一行指定库 和 库的版本
     pod 'AFNetworking', '~> 4.0' //例子，此处安装AFNetworking框架
//其他的信息如非需要，无需更改

回到终端

//安装在Podfile文件中指定好的库
$ pod install
//安装成功后
$ pod update
//如果一直卡在pod install，请往下翻查看换源操作

至此，框架便用Cocoapods安装完成，用在项目文件夹中新生成的xxx.xcworkplace文件打开项目，在项目中只需Command+B编译后就可以只用第三方框架了。

3.换源

在上面的操作中，Cocoapods是默认使用官方源的。但如果遇到一直卡在pod update或者pod install的情况，建议更换Cocoapods的repo。

//此命令可以查看Cocoapods的repo有哪些
$ pod repo
//删除官方源
$ pod repo remove master //master为源的name，如remove失败，用上方的命令查看目前源的name
//添加新源
$ pod repo add master https://cdn.cocoapods.org/
$ pod update

目前国内有好几个Cocoapods的repo源，个人常用这个，你可以根据使用体验自行更换其他源。
cdn源
https://cdn.cocoapods.org/
清华镜像源
https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git

4.结语

Cocoapods的安装与使用会遇到的问题大概就是这些。其他的一些命令，如$ pod list可以自行查看使用。如遇到其他问题，可以根据终端抛出的fatal提示自己查找解决方案。
当过久没有使用时，建议先用$ pod update命令更新框架。

以上

Tino Wu

Next Post

一种常见的循环引用
Previous Post

初探iOS14-Widget小组件

CATALOG

1. Cocoapods是什么
2. 1.安装
3. 2.使用
4. 3.换源
5. 4.结语

以上