首页 > 技术文章 > cocoapods安装及使用

huaixu 2016-09-28 15:25 原文

最近新换了电脑,重新安装cocoapods遇到了很多问题,在这里把问题还有解决方案记录一下

一、安装Cocoapods

在安装CocoaPods之前,首先要在本地安装好Ruby环境,一般Mac下都自带ruby。

用淘宝的Ruby镜像来访问cocoapods。按照下面的顺序在终端中敲入依次敲入命令:

$ gem sources --remove https://rubygems.org/
//等有反应之后再敲入以下命令
$ gem sources -a http://rubygems-china.oss.aliyuncs.com        

 为了验证你的Ruby镜像是并且仅是taobao,可以用以下命令查看:

$ gem sources -l

 只有在终端中出现下面文字才表明你上面的命令是成功的:

*** CURRENT SOURCES ***

http://rubygems-china.oss.aliyuncs.com

 

这时候,你再次在终端中运行:

$ sudo gem install cocoapods

 等上十几秒钟,CocoaPods就可以在你本地下载并且安装好了,不再需要其他设置。

到这里基本就下载并且安装好

--------------------------------------------------------------------------------------------

执行pod install 命令

出现Setting up CocoaPods master repo,说明Cocoapods在将它的信息下载到 ~/.cocoapods里;

cd  到该目录里,用du -sh *命令来查看文件大小

在终端输入:

cd ~/.cocoapods

进入cocoapods文件后在终端输入:du -sh *

如果结果显示0 repos,说明没有安装成功

--------------------------------------------------------------------------------------------

先判断的CocoaPods是否可以使用,可以用CocoaPods的搜索功能验证一下。在终端中输入:

      pod search AFNetworking

如果出现错误,说明CocoaPods还不能正常使用

需要更新pod,下载它的一些依赖包;在终端中输入:

   $ pod setup

过一段时间之后,你会在终端中看到跟上面同样的红色的错误信息。

这说明某些环境原因导致pod更新不了,可能原因有,1)gem版本太低;2)github无法链接;3).cocoapods目录下的配置信息错误。我们可以一个一个来排除,

1、首先更新gem到最新版本,在终端中输入:

$ sudo gem update --system 

 

2、然后检查是否可以ping通github,在终端中输入:

$ ping github.com 

3、然后查看pob repo list:

$ pod repo list

结果显示0 repos,说明没有安装成功;

4、删除.cocoapods目录,重新下载pod更新:

$ cd ~/.cocoapods/
$ sudo -rm -rf ~/.cocoapods/

5、重新执行pod setup,过一段时间后提示setup completed 说明安装成功了

6、如果执行pod setup后一直卡在这里不动或者pod setup失败

解决方案:(来自于贴吧 http://www.cocoachina.com/bbs/read.php?tid-193398-page-1.html)

1).访问 https://github.com/CocoaPods/Specs,然后将Specs项目fork到自己的github账户上

2). 下载GitHub Desktop, 然后clone Specs项目。

3). 将clone的Specs项目的文件夹改名为master,然后拖到/Users/用户名/.cocoapods/repos目录下。

4). 运行pod setup

 解释:pod setup的本质就是将https://github.com/CocoaPods/Specs上的Specs项目clone到/Users/用户名/.cocoapods/repos目录下。若此目录下已有Specs项目,则会将项目更新到最新的状态。由于Specs很大,容易导致pod setup失败。这时就需要我们手动安装Specs。若直接从github上下载zip文件,由于缺少git文件,会导致cocoa pods不使用。若用git clone,由于文件过大,容易导致失败。但是使用GitHub Desktop软件,则会提高clone的成功率,并且会给出clone的进度。

 

二、CocoaPods使用

终端中进入你项目所在目录 (cd+command+拖到目标文件夹)

然后在当前目录下,利用vim创建Podfile,运行:$ vim Podfile

然后按 进入插入模式,进行编辑在Podfile文件中输入以下文字:

platform :ios, '8.0'

target '你的项目名称' do

pod 'AFNetworking', '~> 3.0'

pod ‘SDWebImage’, ‘~> 3.7.2’

end

这文件做了两件事情:
1.告诉Cocoapods你的目标平台与版本,这里的你目标是iOS 8.0。
2.列给Cocoapods一个项目所有需要引入和安装的三方库清单。

然后保存退出(esc)。vim环境下,保存退出命令是::wq(如果进入了Insert模式按esc退出后继续输出:wq)

这时候,你会发现项目目录中,出现一个名字为Podfile的文件,而且文件内容就是刚刚输入的内容。注意,Podfile文件应该和工程文件.xcodeproj在同一个目录下。

这时候,你就可以利用CocoPods下载AFNetworking、SDWebImage了。还是在终端中的当前项目目录下,运行以下命令:

pod install

Cocoapods会在你的项目目录中创建一堆新文件,但是,只有一个需要你关心,Demo.xcworkspace。
 
用Xcode打开Demo.xcworkspace。看看你的项目设置,现在有一个Pods项目在你的项目工作区,以及在Pods文件夹放着每一个你引入的库
 
构建并运行您的App,以确保一切工作正常。

推荐阅读