IOS安装CocoaPods详细教程

时间:2022-04-23 08:01:00

一、简介

什么是cocoapods

cocoapods是os x和ios下的一个第三类库管理工具,通过cocoapods工具我们可以为项目添加被称为“pods”的依赖库(这些类库必须是cocoapods本身所支持的),并且可以轻松管理其版本。

cocoapods的好处

1、在引入第三方库时它可以自动为我们完成各种各样的配置,包括配置编译阶段、连接器选项、甚至是arc环境下的-fno-objc-arc配置等。

2、使用cocoapods可以很方便地查找新的第三方库,这些类库是比较“标准的”,而不是网上随便找到的,这样可以让我们找到真正好用的类库。

IOS安装CocoaPods详细教程

二、cocoapods安装步骤

注意:在终端输入命令时,取$后面部分输入

1、升级ruby环境

终端输入:$ gem update --system

此时会出现

IOS安装CocoaPods详细教程

没权限升级ruby的提示
这是因为你没有权限去升级ruby

这时应该输入:$ sudo gem update --system
此时会出现

IOS安装CocoaPods详细教程

输入密码

接下来输入密码,注意:输入密码的时候没有任何反应,光标也不会移动,你尽管输入就是了,输完了直接回车。
等一会如果出现

IOS安装CocoaPods详细教程

升级ruby成功

恭喜你,升级ruby成功了。

2、更换ruby镜像

首先移除现有的ruby镜像

终端输入:$ gem sources --remove https://rubygems.org/
然后添加国内最新镜像源(淘宝的ruby镜像已经不更新了)

终端输入:$ gem source -a https://gems.ruby-china.org/
执行完毕之后输入gem sources -l来查看当前镜像

终端输入:$ gem sources -l
如果结果是
*** current sources ***
https://gems.ruby-china.org/
说明添加成功,否则继续执行$ gem source -a https://gems.ruby-china.org/来添加

3、安装cocoapods

接下来开始安装

终端输入:$ sudo gem install cocoapods
如果出现这个

IOS安装CocoaPods详细教程

安装错误提示

说明没有权限,需要输入

终端输入:$ sudo gem install -n /usr/local/bin cocoapods

安装成功如下:

IOS安装CocoaPods详细教程

安装成功

到这之后再执行pod setup(ps:这个过程是漫长的,要有耐心)

终端输入:$ pod setup
然后你会看到出现了setting up cocoapods master repo,卡住不动了,说明cocoapods在将它的信息下载到 ~/.cocoapods里。
你可以command+n新建一个终端窗口,执行cd ~/.cocoapods/进入到该文件夹下,然后执行du -sh *来查看文件大小,每隔几分钟查看一次,这个目录最终大小是900多m(我的是930m)
当出现setup completed的时候说明已经完成了。

哈哈,太不容易了,终于走到这一步了,终于安装完成了,那么到底能不能用呢?咱们接着往下看!
注意:以上所有的步骤都是为这台电脑配置cocoapods环境,以下才是真正的把cocoapods安装到你的工程里面。

4、cocoapods的使用

1、首先我们来搜索一下三方库

终端输入:$ pod search afnetworking
这时有可能出现

IOS安装CocoaPods详细教程

搜索不到的提示

这是因为之前pod search的时候生成了缓存文件search_index.json
执行rm ~/library/caches/cocoapods/search_index.json来删除该文件
然后再次输入pod search afnetworking进行搜索
这时会提示creating search index for spec repo 'master'..
等待一会将会出现搜索结果如下:

IOS安装CocoaPods详细教程

afnetworking搜索结果

出现这个了就说明搜索成功了,看一下上图中的这一句:
pod 'afnetworking', '~> 3.1.0'
这句话一会我们要用到,这是cocoapods添加三方库的关键字段

2、在工程中创建一个podfile文件

要想在你的工程中创建podfile文件,必须先要进到该工程目录下

终端输入:$ cd /users/liyang/desktop/cocoapodstest
进来之后就创建

终端输入:$ touch podfile
然后你在你的工程目录下可以看到多了一个podfile文件

3、编辑你想导入的第三方库的名称及版本

使用vim编辑podfile文件

终端输入:$ vim podfile
进入如下界面:

IOS安装CocoaPods详细教程

编辑podfile文件
进来之后紧接着按键盘上的英文'i'键
下面的"podsfile" 0l, 0c将变成-- insert --
然后就可以编辑文字了,输入以下文字

?
1
2
3
4
platform :ios, '7.0'
target 'myapp' do
pod "afnetworking", "~> 3.1.0"
end

解释一下,'myapp'就是你自己的工程名字,platform :ios, '7.0'代表当前afnetworking支持的ios最低版本是ios 7.0, '~> 3.1.0'代表要下载的afnetworking版本是3.1.0及以上版本

编辑完之后成如下样子:

IOS安装CocoaPods详细教程

编辑完成

此时该退出去了,怎么退出去呢?跟着我做,先按左上角的esc键,再按:键,再输入wq,点击回车,就保存并退出去了。

这时候,你会发现你的项目目录中名字为podfile的文件的内容就是你刚刚输入的内容。

4、把该库下载到xcode中

终端输入:$ pod install
这就开始下载了,需要一段时间,出现如下界面就说明安装好了

IOS安装CocoaPods详细教程

安装成功

这个时候关闭所有的xcode窗口,再次打开工程目录会看到多了一个后缀名为.xcworkspace文件。

IOS安装CocoaPods详细教程

工程目录

以后打开工程就双击这个文件打开了,而不再是打开.xcodeproj文件。
进入工程后引入头文件不再是#import "afnetworking.h",而是#import <afnetworking.h>

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。