cocoapods 配置

时间:2023-12-15 15:14:38

二、CocoaPods 安装

CocoaPods可以方便地通过Mac自带的RubyGems安装。

打开Terminal(Mac电脑自带的终端):

(1).设置ruby的软件源

这是因为ruby的软件源rubygems.org因为使用亚马逊的云服务,被我天朝屏蔽了,需要更新一下ruby的源,过程如下:

1
2
3
4
5
6
7
gem sources -l   #(查看当前ruby的源)
gem sources --remove https://rubygems.org/   #(移除当前ruby的源)
gem sources -a https://ruby.taobao.org/   #(设置当前ruby的源为我天朝的)
gem sources -l   #(再次查看当前ruby的源)

如果Terminal输出以下样式,就证明ruby的软件源已经设置OK了。

1
2
3
*** CURRENT SOURCES ***
https://ruby.taobao.org/

(2).设置gem为最新版本

1
2
3
4
5
6
7
如果gem太老,可以尝试用如下命令升级gem:
在Terminal输入以下命令:
sudo gem update --system
升级成功后会提示: Latest version currently installed. Aborting.

(3).执行安装CocoaPods命令

1
sudo gem install  cocoapods

如果报以下错误:

1
2
3
ERROR:  While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj

解决方案1(建议):

1
2
3
sudo gem install -n /usr/local/bin cocoapods
pod setup

注意:pod setup在执行时,会输出Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下,如果你等太久,可以试着 cd 到那个目录,用du -sh *来查看下载进度。

安装成功后,你会看到:Setup completed

解决方案2(不建议,没试过):

1
2
3
4
5
6
7
8
9
执行下面的命令并重启
sudo nvram boot-args="rootless=0"
sudo reboot
重启之后, 执行这个命令检查
sudo gem install cocoapods -V

解决完成后,重新执行安装CocoaPods命令

1
sudo gem install  cocoapods

  

(3)、安装完成后,搜索下试试看

1
2
执行 (不分大小写)
pod search AFNetworking

cocoapods 配置

显示如上图就是ok了,是不是装好了呢?

注:一些常见的安装问题:

问题1

pod search afnetworking 的时候出现:

[!] Unable to find a pod with name, author, summary, or description matching `afnetworking`

解决办法:

第一步移除index:rm ~/Library/Caches/CocoaPods/search_index.json

第二步再次查找:  pod search afnetworking

问题2

sudo gem install cocoapods 的时候出现:

1
2
ERROR:  While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj

解决办法:

第一步:

1
2
3
sudo gem install -n /usr/local/bin cocoapods
pod setup

第二步:

1
sudo gem install  cocoapods

  

 

三、Cocoapods的使用

1.新建Podfile文件(用过的都知道,不知道可以百度怎么建)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Podfile文件内容的格式应该如下:
platform :ios, '8.0' #(注明你的开发平台以及版本,'8.0'忽略不写即为最新版本)
pod 'AFNetworking''~> 2.5.3' #('~> 2.5.3'为版本号,忽略不写即为最新版本)
pod 'SDWebImage''~> 3.7.2'
然后在Terminal进入工程所在的根目录(工程根目录)中执行 :
pod install
这样,AFNetworking和SDWebImage就已经下载完成并且设置好了编译参数和依赖,以后使用的时候切记如下两点:
1.从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件
2.每次更改了Podfile文件,都需要重新执行一次pod update命令

查找第三方库:

你如果不知道 cocoaPods 管理的库中,是否有你想要的库,那么你可以通过 pod search 命令进行查找,以下是我用 pod search json 查找到的所有可用的库:

可以在Terminal中输入:

pod search AFNetworking

回车之后就可以看到和你搜索的关键字相关的一些库类,如图:

关于 Podfile.lock

当你执行pod install之后,除了 Podfile 外,CocoaPods 还会生成一个名为Podfile.lock的文件,Podfile.lock 应该加入到版本控制里面,不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本,之后如果多次执行pod install 不会更改版本,要pod update才会改Podfile.lock了。这样多人协作的时候,可以防止第三方库升级时造成大家各自的第三方库版本不一致