CocoaPods环境配置、安装和使用教程

最新推荐文章于 2023-03-31 23:59:56 发布

April2144

最新推荐文章于 2023-03-31 23:59:56 发布

阅读量814

点赞数

分类专栏： ios小知识文章标签： ruby mac os x 开发人员

ios小知识专栏收录该内容

16 篇文章 0 订阅

订阅专栏

如何在Mac OS X上安装 Ruby运行环境

　对于新入门的开发者，如何安装 Ruby和Ruby Gems 的运行环境可能会是个问题，本页主要介绍如何用一条靠谱的路子快速安装 Ruby 开发环境。 此安装方法同样适用于产品环境！
系统需求
首先确定操作系统环境，不建议在 Windows 上面搞，所以你需要用:
• Mac OS X
• 任意 Linux 发行版本(Ubuntu,CentOS, Redhat, ArchLinux ...)
强烈新手使用 Ubuntu 省掉不必要的麻烦！
以下代码区域，带有 $ 打头的表示需要在控制台（终端）下面执行（不包括 $ 符号）

步骤0 －安装系统需要的包

　　# For Mac
　　# 先安装 [Xcode](http://developer.apple.com/xcode/) 开发工具，它将帮你安装好 Unix 环境需要的开发包

步骤1 －安装 RVM

RVM 是干什么的这里就不解释了，后面你将会慢慢搞明白。
　　　　$ curl -L https://get.rvm.io | bash -s stable
期间可能会问你sudo管理员密码，以及自动通过homebrew安装依赖包，等待一段时间后就可以成功安装好 RVM。
然后，载入 RVM 环境（新开 Termal 就不用这么做了，会自动重新载入的）
　　　　$ source ~/.rvm/scripts/rvm
检查一下是否安装正确
　　　 $ rvm -v
　　　　rvm 1.22.17 (stable) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]

步骤2 －用 RVM 安装 Ruby 环境

列出已知的ruby版本
　　　$ rvm list known

可以选择现有的rvm版本来进行安装（下面以rvm 2.0.0版本的安装为例）

　　　　$ rvm install 2.0.0
同样继续等待漫长的下载，编译过程，完成以后，Ruby, Ruby Gems 就安装好了。
另附：
查询已经安装的ruby
　　$ rvm list
卸载一个已安装版本
$ rvm remove 1.9.2
步骤3 －设置 Ruby 版本

RVM 装好以后，需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本
　　　　$ rvm 2.0.0 --default
同样，也可以用其他版本号，前提是你有用 rvm install 安装过那个版本
这个时候你可以测试是否正确
　　　　$ ruby -v
　　　　ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-darwin13.0.0]

　　　　$ gem -v
　　　　2.1.6

这有可能是因为Ruby的默认源使用的是cocoapods.org，国内访问这个网址有时候会有问题，网上的一种解决方案是将远替换成淘宝的，替换方式如下：
　　 $gem source -r https://rubygems.org/
　　　　$ gem source -a https://ruby.taobao.org
要想验证是否替换成功了，可以执行：
　　　　$ gem sources -l
正常的输出结果：
　　　　　　CURRENT SOURCES　　　　　　　　　　　　
　　　　　　http://ruby.taobao.org/　　　　　　　　　　　　
到这里就已经把Ruby环境成功的安装到了Mac OS X上，接下来就可以进行相应的开发使用了

史上最详细的CocoaPods安装教程

虽然网上关于CocoaPods安装教程多不胜数,但是我在安装的过程中还是出现了很多错误,所以大家可以照下来步骤装一下,我相信会很好用.

前言
在iOS项目中使用第三方类库可以说是非常常见的事，但是要正确地配置他们有时候是非常繁琐的事情，幸运的是CocoaPods是一个很好的解决方案。
什么是CocoaPods
CocoaPods是OS X和iOS下的一个第三类库管理工具，通过CocoaPods工具我们可以为项目添加被称为“Pods”的依赖库（这些类库必须是CocoaPods本身所支持的），并且可以轻松管理其版本。
Cocoapods意义体现在两个方面。第一，在引入第三方库时它可以自动为我们完成各种各样的配置，包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。第二，使用CocoaPods可以很方便地查找新的第三方库，这些类库是比较“标准的”，而不是网上随便找到的，这样可以让我们找到真正好用的类库。
接下来我们将介绍CocoaPods的使用。
CocoaPods的核心组件
CocoaPods是用Ruby写的，并划分成了若干个Gem包。
CocoaPods在解析执行过程中最重要的几个包的路径分别是：CocoaPods/CocoaPods、 CocoaPods/Core和 CocoaPods/Xcodeproj。
CocoaPods / CocoaPod：这是面向用户的组件，每当执行一个pod命令时，这个组件将被激活。它包括了所有实用CocoaPods的功能，并且还能调用其他gem包来执行任务。
CocoaPods / Core：Core gem提供了与CocoaPods相关的文件（主要是podfile和podspecs）的处理。
 
Podfile：该文件用于配置项目所需要的第三方库，它可以被高度定制。本文中我们主要在这里做动作。
Podspec：该文件描述了一个库将怎样被添加进工程中。.podspec文件可以标识该第三方库所需要的源码文件、依赖库、编译选项，以及其他第三方库需要的配置。
CocoaPods / Xcodeproj：这个包负责处理工程文件，它能创建以及修改.xcodeproj文件和.xcworkspace文件。它也可以作为一个独立的包使用，当你要编写修改项目文件的脚本时，可以考虑使用CocoaPods/Xcodeproj。

Cocoapods安装步骤

1、升级Ruby环境

终端输入：$gem update --system
此时会出现
ERROR: While executing gem ... (Gem::FilePermissionError)
You don‘t have write permissions for the /Library/Ruby/Gems/2.0.0 directory.
zijingMacBook-Pro:~ shiyunlei$ sudo gem update —system
这个是因为你没有权限去更新Ruby
这个时候你可以在终端使用：$sudo gem update —system来进行升级

这个时候表示Ruby升级完成。
 

2、安装CocoaPods时我们要访问cocoapods.org，该网站可能被我们大天朝墙了，这样下载安装可能会是龟速，幸好我们可以用淘宝的Ruby镜像来访问该网站，方法如下：

1、gem sources --removehttps://rubygems.org/
2、gem sources -ahttp://ruby.taobao.org/
可以使用下面的命令(红色部分)查看是否更换镜像成功（如下图所示）： $ gem sources -l

 

3、安装Cocoapods，在终端输入命令

$sudo gem install cocoapods
这个时候会提示你输入密码，注：在终端输入密码不会有提示，光标也不会移动，一定要注意
开始安装，如下图：PS:这个过程可能花费时间比较长 

安装成功如下：

4、使用search命令搜索类库名：

$pod search AFNetworking
如果CocoaPods支持，将会输出搜索到的所有类库版本和信息，以及在Podfile中配置的写法，终端返回信息如下：
-> AFNetworking (2.3.1)
   A delightful iOS and OS X networking framework.
  pod ‘AFNetworking‘, ‘~> 2.3.1’（这个语句是需要在编辑Podfile的时候输入的命令，即是如何安装下载相关类库的指令）
   - Homepage: https://github.com/AFNetworking/AFNetworking
   - Source: https://github.com/AFNetworking/AFNetworking.git
   - Versions: 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0,
   2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4, 1.3.3,
   1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2, 1.0RC1,
   0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]
   - Sub specs: - AFNetworking/Serialization (2.3.1) -
   AFNetworking/Security (2.3.1) - AFNetworking/Reachability (2.3.1) -
   AFNetworking/NSURLConnection (2.3.1) - AFNetworking/NSURLSession (2.3.1)
   - AFNetworking/UIKit (2.3.1)
-> AFNetworking+AutoRetry (0.0.5)
   Auto Retries for AFNetworking requests
   pod ‘AFNetworking+AutoRetry‘, ‘~> 0.0.5‘
   - Homepage: https://github.com/shaioz/AFNetworking-AutoRetry
   - Source: https://github.com/shaioz/AFNetworking-AutoRetry.git
   - Versions: 0.0.5, 0.0.4, 0.0.3, 0.0.2, 0.0.1 [master repo]

5、需要在工程中创建一个Podfile文件，

使用命令：
$cd /Users/shiyunlei/Desktop/CocoapodsSample(进入工程目录，cd后面的是工程的路径)
$ touch Podfile（创建Podfile文件）

然后使用vim编辑Podfile文件，使用命令：
$ vim Podfile 进入如下界面

然后紧接着按键盘上的“i”键，变成如下状态，这个时候可以对Podfile文件进行编辑：
$platform:ios, ‘7.0‘
$ pod ‘AFNetworking‘, ‘~> 2.3.1‘
在编辑完成后按“esc”，

在按“:”,这个时候输入wq,点击回车，保存并退出。

这个时候打开Podfile文件就会看到里面添加了刚才在终端输入的一行语句，如下图

然后在终端输入命令安装相应的第三方类库
$pod install

因为这个过程需要下载相应的类库，所以时间和网速有关。
安装成功之后截图如下：

这个时候会看到之后打开工程都需要从类型为工程名.xcworkspace文件打开。

CocoaPods specs的镜像索引

在使用cocoapods进行update或者install的时候，会去更新获取pod specs。
所有的项目的podspec文件都托管在https://github.com/CocoaPods/Specs上。
第一次执行pod setup时，cocoapods会将这些podspec索引文件更新到本地的～／。cocoapods／目录下，
这个索引文件比较大，国内网络的问题，更新非常慢。

网上一个博主http://akinliu.github.io/2014/05/03/cocoapods-specs-/ ，对github上的specs仓库进行了镜像，
是每10分钟进行同步一次，基本和主仓库保持一致。
gitcafe和oschina都是国内服务器，在执行索引更新操作时，快很多。

使用方法：
pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update

如果想用oschina的镜像，可以把第二条命令的地址换成oschina的即可。
pod repo add master http://git.oschina.net/akuandev/Specs.git

如果在pod install、或者pod update时，不想升级specs库，可以增加忽略参数
pod install --no-repo-update
pod update --no-repo-update