iOS 使用CocoaPods
使用CocoaPods(一)为项目配置第三方类库
未知原稿人, 笔者2016/5/20大幅修改.
更新:
2016.05.20 大量修改
2018.05.23 ruby环境改为使用https://gems.ruby-china.org/ <最新更新>
前言
在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
上面已经提到,CocoaPods是用Ruby写的,所以运行需要安装Ruby环境。Mac中已经自带Ruby环境,这个不用我们担心,如果认为Ruby环境不够新,我们可以先更新.
打开终端,输入以下命令:
gem update –system
接下来我们可以安装CocoaPods了,在安装前,我们先做点小动作。
由于安装CocoaPods时我们要访问cocoapods.org,该网站可能被我们大天朝墙了,这样下载安装可能会是龟速,幸好我们可以用淘宝的Ruby镜像来访问该网站,方法如下:(其中$后面的才是要输入的东西!!!)
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
最近貌似淘宝的也不管用了, 改用ruby-china的网站
$ gem sources -a https://gems.ruby-china.org/
成功后,使用以下命令查看:
$ gem sources -l
可以看到替换镜像成功:
1. *** CURRENT SOURCES ***
2.
3. https://gems.ruby-china.org/
接下来是真正的安装,在终端输入以下命令:
sudo gem install cocoapods
安装输出非常长, 如果安装过程出现错误提示:
ERROR: While executing gem ... (Errno::EPERM)Operation not permitted - /usr/bin/fuzzy_match
就在终端中输入:
sudo gem install -n /usr/local/bin cocoapods
回车, 即可解决问题, 之后会出现一长串的信息, 信息最后有一行提示:
17 gems installed
然后输入:
pod setup
回车, 会提示:
Setting up CocoaPods master repo
然后使用setup命令配置CocoaPods(这个命令也可以不运行,但是第一次使用pod命令时这个setup过程也会自动执行)
1. AppledeMacBook-Pro:~ apple$ pod setup
2. Setting up CocoaPods master repo
3. Setup completed (read-only access)
使用CocoaPods为工程配置第三方类库
首先打开Xcode新建一个工程,假设为Desktop/CocoaPodsDemo,并且我们要往该工程中导入AFNetworking这个类库。
AFNetworking在Github中的地址为:https://github.com/AFNetworking/AFNetworking
这里也说明了如何使用CocoaPods配置该类库:
以上说明是我们应该如何书写Podfile文件。一般非常流行和成熟的类库都得到了CocoaPods的支持,并且有这个说明。
如何确定CocoaPods是否支持我们想要加入的目标类库?使用Search命令搜索类库名:
$ pod search afnetworking (注意深入小写的字符)
如果CocoaPods支持,将会输出搜索到的所有类库版本和信息,以及在Podfile中配置的写法,例如:
1. -> AFNetworking (2.1.0)
2. A delightful iOS and OS X networking framework.
3. pod 'AFNetworking', '~> 2.1.0'
4. - Homepage: https://github.com/AFNetworking/AFNetworking
5. - Source: https://github.com/AFNetworking/AFNetworking.git
6. - Versions: 2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1,
7. 2.0.0, 1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0RC3, 1.0RC2,
8. 1.0RC1, 1.0.1, 1.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1, 0.10.1, 0.10.0 [master
9. repo]
10. - Sub specs:
11. - AFNetworking/Serialization (2.1.0)
12. - AFNetworking/Security (2.1.0)
13. - AFNetworking/Reachability (2.1.0)
14. - AFNetworking/NSURLConnection (2.1.0)
15. - AFNetworking/NSURLSession (2.1.0)
16. - AFNetworking/UIKit (2.1.0)
17.
18.
19. -> AFNetworking+AutoRetry (0.0.2)
20. Auto Retries for AFNetworking requests
21. pod 'AFNetworking+AutoRetry', '~> 0.0.2'
22. - Homepage: https://github.com/shaioz/AFNetworking-AutoRetry
23. - Source: https://github.com/shaioz/AFNetworking-AutoRetry.git
24. - Versions: 0.0.2, 0.0.1 [master repo]
25.
26.
27. -> AFNetworking-RACExtensions (0.1.2)
28. AFNetworking-RACExtensions is a delightful extension to the AFNetworking
29. classes for iOS and Mac OS X.
30. pod 'AFNetworking-RACExtensions', '~> 0.1.2'
31. - Homepage: https://github.com/CodaFi/AFNetworking-RACExtensions
32. - Source: https://github.com/CodaFi/AFNetworking-RACExtensions.git
33. - Versions: 0.1.2, 0.1.1, 0.0.1 [master repo]
34.
35.
36. -> AFNetworking-ReactiveCocoa (0.0.2)
37. Make AFNetworking reactive.
38. pod 'AFNetworking-ReactiveCocoa', '~> 0.0.2'
39. - Homepage: https://github.com/uasi/AFNetworking-ReactiveCocoa
40. - Source: https://github.com/uasi/AFNetworking-ReactiveCocoa.git
41. - Versions: 0.0.2, 0.0.1 [master repo]
42.
43.
44. -> AFNetworking-Synchronous (0.2.0)
45. Synchronous requests for AFNetworking
46. pod 'AFNetworking-Synchronous', '~> 0.2.0'
47. - Homepage: https://github.com/paulmelnikow/AFNetworking-Synchronous
48. - Source: https://github.com/paulmelnikow/AFNetworking-Synchronous.git
49. - Versions: 0.2.0, 0.1.0 [master repo]
先看看普通的工程目录:
进入主题,首先在我们的工程目录下创建Podfile文件,该文件用来控制CocoaPods的下载内容,该文件是没有后缀的,每个项目只需要一个Podfile文件,如果需要导入多个类库那么统一在该文件中书写下载内容。
创建过程:
1>首先cd到工程目录(command+n在新的终端中输入cd空格然后直接拖工程文件夹到终端中即可得到工程目录);
2>然后创建Podfile
$ touch Podfile
并且使用vim编写: <在终端输入vim Podfile>然后回车,然后在出现的vim编辑器里面点击字母i(即insert的意思),就可以进行编辑。
1. platform:ios, '9.2'
2. pod "AFNetworking", "~>3.1"
3. ~
4. ~
5.
6. ~
7. ~
8. :wq
注意: 由于我的安装过程出现了
ERROR: While executing gem ... (Errno::EPERM)Operation not permitted - /usr/bin/fuzzy_match
因此在Podfile中的设置跟以上有些不同:
platform :ios, ‘9.2’
use_frameworks!target 'UISenior-0520CocoaPods' dopod 'AFNetworking', '~> 3.1.0’pod 'JSONKit-NoWarning', '~> 1.2'
end
在编辑完成后先按esc,再按“:”,输入wq保存并退出。
:wq
Podfile中的两句文字的意思是, 当前AFNetworking支持的iOS最高版本是iOS 9.2, 要下载的AFNetworking版本是3.1。
PS: 也可以用文本编辑工具打开该文件进行编辑, 终端命令如下:
1. open -e Podfile
这里我同时为Demo安装AFNetworking,JSONKit两个类库,Podfile文件内容如下:
platform :ios, ‘9.2’
use_frameworks!target 'UISenior-0520CocoaPods' dopod 'AFNetworking', '~> 3.1.0’pod 'JSONKit-NoWarning', '~> 1.2'
end
在有了Podfile后,在终端中输入以下命令安装类库:
1. $ pod install
安装完成后,输出信息如下:
1. $ pod install
2. Analyzing dependencies
3. Downloading dependencies
4. Installing AFNetworking (3.1.0)
5. Installing JSONKit-NoWarning (1.2)
6. Generating Pods project
7. Integrating client project
8.
9. [!] From now on use `CocoaPodsDemo.xcworkspace`.
最后一句表明,如果要正确打开工程我们应该打开最新生成的.xcworkspace文件。
可以看到工程目录发生变化了, 两个类库都安装上了:
打开Build Phases,可以看到CocoaPods已经自动为我们完成了所有设置:
之后我们可以在工程中导入AFNetworking、JSONKit的任意头文件并使用其所有接口了:
1. #import "ViewController.h"
2. #import "AFNetworking.h"
3. #import "JSONKit.h"
上面说的内容略多! 但是总的来说我们就做了两件事:新建Podfile文件并编写要导入的类库信息,打开终端输入pod install命令安装,完成。一切都是如此的方便。
Damn, it is so awesome.
正确编译运行一个包含CocoaPods类库的项目
如果一个项目中已经包含了CocoaPods的配置文件,但是编译却出现错误,那么我们仅需要一行命令就可以配置好所有的第三方类库了:
1. $ pod update
参考Demo的项目地址:https://github.com/UrbanApps/UAAppReviewManager
打开Demo的UAAppReviewManagerExample目录,可以发现少了一个xcworkspace文件,另外还有几个CocoaPods的配置文件在这里:
打开Podfile文件看看:
1. target 'UAAppReviewManagerExampleiOS' do
2. platform :ios, '5.1'
3. pod 'UAAppReviewManager', :path => '..'
4. end
5.
6. target 'UAAppReviewManagerExampleMac' do
7. platform :osx, '10.7'
8. pod 'UAAppReviewManager', :path => '..'
9. end
platform表示类库支持的最高版本,该类库的target包括了iOS和Mac。而path指定了到上级目录去查找该类库的安装信息。
编译工程,将会出错,原因是我们没有将类库链接到工程中:
因此我们要用pod命令进行安装。cd到Example目录下执行pod install命令,将会报错:
1. $ pod install
2. Analyzing dependencies
3. Fetching podspec for `UAAppReviewManager` from `..`
4. [!] Unable to satisfy the following requirements:
5. - `UAAppReviewManager (from `..`)` required by `Podfile`
原因是要添加的类库已经有最新版本推出,而Podfile文件并没有更改其下载版本(Podfile文件过期),于是获取安装数据失败。
因此我们要用update命令获取最新版本的类库:
1. $ pod update
2. Analyzing dependencies
3. Fetching podspec for `UAAppReviewManager` from `..`
4. Downloading dependencies
5. Installing UAAppReviewManager (0.2.1)
6. Generating Pods project
7. Integrating client project
8.
9. [!] From now on use `UAAppReviewManagerExample.xcworkspace`.
同样地我们成功生成了xcworkspace文件:
再编译运行就没问题了。
补充
当Cocoapods向项目中增加了一个第三方库的时候,不仅仅只是添加代码,由于每个第三方类库有不同的target,所以每次添加第三方库时,都会有几个文件被写入磁盘,包括Podfile.lock和Manifest.lock文件等。
其中Podfile.lock记录了需要被安装的pod的每个已安装的版本。如果你想知道已安装的pod是哪个版本,可以查看这个文件。
Manifest.lock是每次运行pod install时创建的Podfile.lock文件的副本。
iOS 使用CocoaPods相关推荐
- iOS架构-cocoaPods之自制私有库及管理(17)
CocoaPods是iOS,Mac下优秀的第三方包管理工具,类似于java的maven,给我们项目管理带来了极大的方便. 个人或公司在开发过程中,会积累很多可以复用的代码包,有些我们不想开源,又想像开 ...
- iOS开展-CocoaPods安装和使用教程
原文链接: iOS开展-CocoaPods安装和使用教程 修正已经增加了自己的理解. CocoaPods安装和使用教程 Code4App 原创文章.转载请注明出处:http://code4app.c ...
- iOS开发CocoaPods使用
一.为什么用CocoaPods iOS开发时,项目中会引用许多第三方库,CocoaPods(https://github.com/CocoaPods/CocoaPods)可以用来方便的统一管理这些第三 ...
- iOS架构-cocoapods之公共库的发布与集成(16)
描述:我们开发iOS 项目时,几乎每个工程都会集成用cocoapods 管理第三方库,于是就有这样的需求–我分装了一个独立的SDK模块,想让其他人通过pod search 到,并能使用这个开源的SDK ...
- iOS架构-cocoapods之本地git库的管理(15)
需求是:在工程中用cocoapods管理一个本地的一个抽离SDK库.和cocoapods管理远程的github的公开的库AFNetworking 一样管理自己的本地的一个库. 怎么实现:参看Cocoa ...
- iOS架构-cocoapods打包静态库(依赖私有库、开源库、私有库又包含静态库)(14)
前言: iOS工程架构少不了cocoapods 对第三方库的管理,它有着很好的操作性和集中管理的特性.之前的写了不少Xcode 建静态库工程打包.a 和 .framework 的文章,但是我们要先建静 ...
- IOS安装CocoaPods完整流程
作为一个底层系统大菜鸟,又搞过几年ios来说,安装一个CocoaPods是一件蛋痛的事~ 说懂又懂,说不懂又不懂. 因为安装过程比较复杂,步骤较多,而网上教程又比较零散,而且有一些是扯蛋的,所 ...
- iOS之CocoaPods二进制化的实现方案
背景 随着公司业务规模的增长,iOS 客户端的代码量也越来越大,编译一次项目的时间也越来越长.那么减少编译时间成了一个不得不面对的问题: 随着越来越多方便的第三方组件,现在开发App基本十多个第三方依 ...
- iOS开发-CocoaPods使用详细说明
一.概要 iOS开发时,项目中会引用许多第三方库,CocoaPods(https://github.com/CocoaPods/CocoaPods)可以用来方便的统一管理这些第三方库. 二.安装 说实 ...
- iOS之Cocoapods安装
网上关于cocoapods的教程很多,关于它的优点我不赘述:但是我根据多次安装的经验,把我遇到的问题写一下,希望对新手有所帮助. 1. 设置输入源(由于默认的gem资源是国外的,由于历史原因,访问比较 ...
最新文章
- spark(3) - scala独立编程
- 【转】如何编译一个内核 - Ubuntu方式
- 一天一种设计模式(一)------观察者模式
- 基于FPGA的FFT变换实现
- java线程之InheritableThreadLocal
- #6073. 「2017 山东一轮集训 Day5」距离(树链剖分 + 永久标记主席树)
- Spring 官宣,干掉原生 JVM!
- Rust :CC编译
- csgo准星设置代码_csgo准星参数代码
- WPS Linux 2019领先的背后
- Windows XP 黑屏补丁
- IFM分量包络解调分析MATLAB,[原创]数据包络分析(DEA)简介
- 【超快捷】Windows系统自带的快捷键合集
- 实现原理讲解!最全SpringBoot学习教程,你值得拥有!
- andoird 设置锁屏上不显示通知
- Win10清理C盘方法
- Linux/ubuntu深度学习,查看cuda、cudnn、显卡、驱动的版本的命令
- Python--paramiko
- 金蝶系统服务器链接设置,金蝶如何设置连接服务器
- 没有观众没有新片:美国电影院的悲情寒冬