Cocoapods安装及其使用详解

<span style="font-size:14px;">一、什么是CocoaPodsCocoaPods是iOS项目的依赖管理工具，该项目源码在Github上管理。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省设置和第三方开源库的时间。在使用CocoaPods之前，开发项目需要用到第三方开源库的时候，我们需要1.把开源库的源代码复制到项目中2.添加一些依赖框架和动态库3.设置-ObjC，-fno-objc-arc等参数4.管理他们的更新在使用CocoaPods后，我们只需要把用到的开源库放到一个名为Podfile的文件中，然后执行pod install.Cocoapods就会自动将这些第三方开源库的源码下载下来，并且为我们的工程设置好响应的系统依赖和编译参数。二、CocoaPods的原理CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中，然后让主项目依赖Pods项目，这样，源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件，主项目只需要依赖这个.a文件即可。三、CocoaPods的安装gem --version 先查看下gem版本号，mac默认安装好的CocoaPods可以方便地通过Mac自带的RubyGems安装。①打开Terminal，然后键入以下命令： $ sudo gem install cocoapods<span style="color:#FF6666;"></span><span style="color:#FF0000;">注：题外话如果出现 一个错误： ERROR:  Could not find a valid gem 'cocoapods' (>= 0) in any repository 排除错误 1.安装command line tools （xcode6不能直接下载用一下方法） 打开终端，输入命令：xcode-select --install 点击安装即可2. 权限的问题，没有在root下面 。 sudo -i  或者 sudo su 进入到root之后由①</span></span><span style="font-size:14px;">$ sudo gem install cocoapods</span><span style="font-size:14px;"> 重新操作</span><pre name="code" class="objc"><span style="font-size:14px;">执行完这句如果报告以下错误：<span style="color:#FF6666;">ERROR: Could not find a valid gem 'cocoapods' (>= 0), here is why:Unable to download data from https://rubygems.org/ - Errno::ETIMEDOUT: Operation timed out - connect(2) (https://rubygems.org/latest_specs.4.8.gz)ERROR: Possible alternatives: cocoapods</span></span>

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

<span style="font-size:14px;">②查看当前ruby的源</span>

$ gem sources -l
③移除rubygem镜像
 $ gem sources --remove https://rubygems.org/
④替换淘宝镜像
 $ gem sources -a https://ruby.taobao.org/
⑤查看当前ruby的源
 $ gem sources -l
注：如果gem太老，可以尝试用如下命令升级gem$ sudo gem update --system升级成功后会提示: RubyGems system software updated然后重新执行安装下载命令$ sudo gem install cocoapods这时候应该没什么问题了⑥接下来进行安装，执行：$ pod setupTerminal会停留在 Setting up CocoaPods master repo 这个状态一段时间,是因为要进行下载安装,而且目录比较大,需要耐心等待一下.如果想加快速度,可使用cocoapods的镜像索引.安装成功后,你会看到:Setup completed

⑦在执行$ gem list ，Terminal会出现以下字样 （cocoapods-core (0.39.0)）就表示可以正常使用了
*** LOCAL GEMS ***

activesupport (4.2.4)
bigdecimal (1.2.0)
CFPropertyList (2.2.8)
claide (0.9.1)
cocoapods (0.39.0)
cocoapods-core (0.39.0)
cocoapods-downloader (0.9.3)
cocoapods-plugins (0.4.2)
cocoapods-search (0.1.0)
cocoapods-stats (0.6.2)
cocoapods-trunk (0.6.4)
cocoapods-try (0.5.1)
colored (1.2)
escape (0.0.4)
fuzzy_match (2.0.4)
i18n (0.7.0)
io-console (0.4.2)
json (1.7.7)
libxml-ruby (2.6.0)
minitest (5.8.2, 4.3.2)
molinillo (0.4.0)
nap (1.0.0)
netrc (0.7.8)
nokogiri (1.5.6)
psych (2.0.0)
rake (0.9.6)
rdoc (4.0.0)
sqlite3 (1.3.7)
test-unit (2.0.0.0)
thread_safe (0.3.5)
tzinfo (1.2.2)
xcodeproj (0.28.2)
四、Cocoapods的使用①搜索第三方 $ pod search 'SDWebimage' （以SDWebimage为例

<span style="font-size:14px;"></span><pre name="code" class="objc"><pre name="code" class="objc">回车之后就可以看到和你搜索的关键字相关的一些库类，如：其中第一个就是我们需要的，把pod ‘<span style="font-size:14px;">SDWebimage</span>’， ‘~> 3.7.2’那一行复制到我们的Podfile文件中，保存修改。

进入工程所在的目录（工程根目录）执行命令 touch Podfile 或者vim Podfile 创建Podfile的文件
 这句是说新建一个名为Podfile的文件（不能写成别的名字，也可以自己在工程根目录里面直接新建）

<span style="font-size:14px;"></span><pre name="code" class="objc"><pre name="code" class="objc"><pre name="code" class="objc">第一次执行这个命令,会有一个空白文件打开

两种打开方式

<span style="font-size:14px;"></span><pre name="code" class="objc"><span style="font-size:14px;">②  cd  把工程目录拖到这里    1.点击回车进入</span><span style="font-size:14px;">Podfile的文件</span><span style="font-size:14px;"></span>

<pre name="code" class="objc">   2.然后对改文件进行编辑，执行命令 open -e Podfile③Podfile文件的格式应该如下： 点击s进入编辑模式，下角会出现insert字样platform :ios, '7.0'pod 'AMap2DMap'pod 'AFNetworking', '~> 2.5.3'pod 'SDWebImage', '~> 3.7.2'点击esc 退出编辑模式 ，点击:wq保存需要注意的几点：platform那一行，ios三个字母都要小写，而且与前面的冒号之间不能有间隔，后面的版本号也可以不写，但是有些开源库对版本是有要求的，比如要在6.0以上才能运行，遇到这样的开源库就需要写上版本号。platform下面就是Cocoapods需要集成的开源库，根据你的需要确定集成那些库，后面跟的是第三方版本号，也可以不写然后在Terminal中执行 ：④pod install 开始下载。出现如下字样Updating local specs repositoriesAnalyzing dependenciesDownloading dependenciesInstalling SDWebImage (3.7.3)Generating Pods projectIntegrating client project这样，<span style="color:#66FF99;">SDWebImage</span>就已经下载完成并且设置好了编译参数和依赖，以后使用的时候切记如下两点：1.从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程，而不是使用以前的.xcodeproj文件2.每次更改了Podfile文件，都需要重新执行一次pod update命令ps:当执行pod install之后，除了Podfile，还会生成一个名为Podfile.lock的文件，它会锁定当前各依赖库的版本，之后即使多次执行pod install也不会更改版本，只有执行pod update才会改变Podfile.lock.在多人协作的时候，这样可以防止第三方库升级时候造成大家各自的第三方库版本不一致。所以在提交版本的时候不能把它落下，也不要添加到.gitignore中.五、常见问题1.[!] Invalid Podfile file: undefined local variable or method `en_US' for #<Pod::Podfile:0x00000102a5d8b0>. Updating CocoaPods might fix the issue.原因：单引号格式，可能是手动输入导致解决办法：系统偏好设置-键盘-文本-将“使用智能引号和破折号”一项取消勾选-再将podfile里面的单（双）引号修改一下2.ArgumentError - invalid byte sequence in US-ASCII原因：字符集错误解决办法：使用locale命令查看当前的字符集，如果都是zh，需要执行以下命令：export LC_ALL=en_US.UTF-8export LANG=en_US.UTF-8然后再使用locale命令查看，已经改过来了    [!] The YMTea [Debug] target overrides the OTHER_LDFLAGS build setting defined in `Pods/Target Support Files/Pods/Pods.debug.xcconfig'. This can lead to problems with the CocoaPods installation        Use the $(inherited) flag, or        Remove the build settings from the target.[!] The YMTea [Release] target overrides the OTHER_LDFLAGS build setting defined in `Pods/Target Support Files/Pods/Pods.release.xcconfig'. This can lead to problems with the CocoaPods installation- Use the `$(inherited)` flag, or- Remove the build settings from the target.原因：我是在已有项目中集成Cocoapods的时候遇到这个问题，原因是项目 Target 中做了一些设置，CocoaPods 也做了默认的设置，如果两个设置结果不一致，就会造成问题。解决方法：我想要使用 CocoaPods 中的设置，分别在我的项目中定义PODS_ROOT 和 Other Linker Flags的地方（build settings），把他们的值用$(inherited)替换掉，进入终端，执行 pod update警告没了，回到 Xcode，build通过。网上还流行另外一种简单粗暴的方法:点击项目文件 project.xcodeproj，右键显示包内容，用文本编辑器打开project.pbxproj，删除OTHER_LDFLAGS的地方，保存(这种我没试过)4.[!] Oh no, an error occurred.It appears to have originated from your Podfile at line 2.Search for existing GitHub issues similar to yours:https://github.com/CocoaPods/CocoaPods/search?q=%2FUsers%2Fxiao6%2FMusic%2FGI06%E5%AE%9E%E8%AE%AD%E8%8A%B8%E8%8C%97%E8%8C%B6%E5%8F%B6%2FYMTea%2FPodfile%3A2%3A+syntax+error%2C+unexpected+%27%3A%27%2C+expecting+end-of-input%0Aplatform+%3A+ios%2C+%277.0%27%0A++++++++++%5E&type=IssuesIf none exists, create a ticket, with the template displayed above, on:https://github.com/CocoaPods/CocoaPods/issues/newBe sure to first read the contributing guide for details on how to properly submit a ticket:https://github.com/CocoaPods/CocoaPods/blob/master/CONTRIBUTING.mdDon't forget to anonymize any private data!原因：这个问题比较蛋疼，弄了好久，仔细看发现就是因为Podfile文件里面 platform 那一行 冒号和ios之间多了一个空格。。。。其实这个错误在报错的时候ruby已经给出了，只是一开始没有好好看：附：如何使用CocoaPods的镜像索引:所有项目的Podspec文件都托管在https://github.com/CocoaPods/Specs,第一次执行pod setup时,CocoaPods会将这些podspec索引文件更新到本地的~/.cocoapods目录下,这个索引文件比较大,所以第一次更新时非常慢.友好人士在国内的服务器建立了Cocoapods索引库的镜像,所以执行索引跟新操作时候会快很多.具体操作方法如下:$ pod repo remove master$ pod repo add master https://gitcafe.com/akuandev/Specs.git$ pod repo update这是使用gitcafe上的镜像,将以上代码中的 https://gitcafe.com/akuandev/Specs.git 替换成 http://git.oschina.net/akuandev/Specs.git 即可使用oschina上的镜像。