前言

对于iOS App的开发,几乎都采用了Cocoapods来管理第三方库,那么对于我们开发人员来说,这是必备技能,必须要掌握如何使用。这篇文章就是介绍如何安装和使用CocoaPods的。

这篇文章对哪些人群参考价值?

  • 对未使用过Cocoapods的人群有参考价值
  • 对使用过Cocoapods,但是未深入了解过的用户有参考价值
  • 对有开源精神的,希望将自己的代码贡献到Cocoapods的用户有参考价值

如果您不属于以上人群,您是可以不阅读本篇文章的,当然阅读完也会有很大的帮助。

温馨提示:在篇文章中所使用的Xcode版本为Xcode7.

什么是CocoaPods?

简单来说,就是专门为iOS工程提供对第三方库的依赖的管理工具,通过CocoaPods,我们可以单独管理每个第三方库,可以更方便地管理每个第三方库的版本,而且不需要我们做太多的配置,直接交由提供支持CocoaPods项目的作者来配置了,如此便可直观、集中和自动化地管理我们项目的第三方库。

为什么需要使用CocoaPods?

我们也许有过这样的感受: 每添加一个第三方库、Framework或者SDK,我们都需要手动添加相关依赖库,在工程buildsetting中配置路径,在build phases中添加依赖的系统库。如果所导入的第三方库还依赖其他第三方库,我们也需要手动导入且分别添加工程配置。

当我们需要更新某个第三方库的时候,我们又要手动移除该库,导入新的库,然后再配置,这是相当麻烦且没有意义的工作。当使用CocoaPods管理后,我们只需要修改为某个版本,再执行pod update即可。

当我们需要去掉某个第三方库时,我们是怎么做的呢?是不是将该库移除掉,然后还得把相关配置也移除掉,这样工作才干净。是不是很麻烦呢?当我们使用Cocoapods管理后,我们是怎么做的?只需要在Podfile删除该引入该库的语句,然后执行pod update即可。

当我们开始使用CocoaPods管理第三方库后,我们只需要相当少的配置,其它的一切都交由CocoaPods来管理即可,我们使用起来就更省心了。

如何安装CocoaPods?

CocoaPods is built with Ruby and is installable with the default Ruby available on OS X. We recommend you use the default ruby.

也就是说CocoaPods是通过Ruby来安装的,MAC OSX都有一个默认的Ruby版本,推荐我们通过默认的Ruby来安装CocoaPods。

使用下面的命令安装:

 
1
2
3
 
sudo gem install cocoapods
 

事实上,这样安装未必能安装成功,因为默认的cocoapods网址是国外的,需要VPN才能访问,因此我们可以改一种方式:

  • 1、先输入 gem sources --remove https://rubygems.org/
  • 2、等待有反映后,再输入 gem source -a https://ruby.taobao.org/
  • 3、验证是否成功替换:gem source -l
  • 4、最后就可以通过sudo gem install cocoapods正常安装cocoapods了。

等待安装完成后,就可以开始使用CocoaPods了。

注意:source或者sources都可以.

如何使用CocoaPods?

要使用CocoaPods,就需要一个Podfile文件。我们是如何为所有的工程建立Podfile的,下面的方式是基本的方式。

 
1
2
3
4
5
 
cd Desktop/Demos/KVODEMO
touch Podfile
vi Podfile
 
  • 第一步:进入到我们所建立的工程的目录,这里是KVODEMO
  • 第二步:通过touch命令新建Podfile
  • 第三步:通过vi Podfile进入编辑Podfile
  • 第四步:添加第三方库,如下图,我们添加了AFNetworkingObjectiveSugar库,其中我们添加的AFNetworking版本是2.0版本,ObjectiveSugar版本是0.5.
 
1
2
3
4
 
pod 'AFNetworking', '~> 2.0'  
pod 'ObjectiveSugar', '~> 0.5'
 
  • 按下esc键,然后输入:wq,就可以保存了。然后在终端输入pod install,就可以安装第三方库了。

在安装完成后,我们不再是打开后缀为.xcodeproj的工程,而是打开后缀为.xcworkspace的工作空间了。

关于Podfile更高级的使用,请参考官方文档

或者关注后续文章!

在Objective-C工程中的使用

在工程中,我们只需要通过引入改文件就可以直接使用了,比如我们引入了第三方库Masonry(纯代码自动布局),我们在Objective-C工程中就可以通过import头文件即可。

 
1
2
3
 
#import <Masonry.h>
 

注意,如果这么做提示找不到头文件,那么我们可以尝试这么引入:#import "Masonry.h"或者通过#import "Masonry/Masonry.h"

如果仍然没有效果,那么需要在工程配置一下.在工程的Build Settings搜索Search Paths,然后在User header search paths中添加$(SRCROOT)并选择recursive(也就是递归查找)

在Swift工程中的使用

我相信大家在Swift工程中使用CocoaPods也遇到了不少问题,尤其是如何import模块问题。 当初我遇到这种问题时,也在网上搜索了很多的资料,但是都不是我希望的方案。在网上有两种方式: 通过Swift工程可以桥接Objectice-C的方式,建立一个Bridge-head.h(名字随便起),然后进入到Build Settings,在搜索框中输入bridg,找到Objective-C Bridging Header,选项,把头文件的路径赋值给该选项。如下所示:

也就是:工程名/桥接文件名.h。在刚才所建立的桥接文件中,通过#import "头文件.h"就可以了。

虽然是Objective-C第三方库,事实上我们也可以使用Swift的方式引入的,也就是通过 import 模块名 的方式来引入。所以对于上面的方式,我是不喜欢的。那么再看看网上的另一种方式:Swift第三方管理

当然,现在swift出了一个Package Manager,专门管理第三方引用的。

这是通过submodule的方式来管理的。 创建submodule,在当前项目的同级目录下执行类似这样的命令,如下:

 
1
2
3
 
git submodule add https://github.com/Masonry.git
 

然后将生成的Masonry.xcodeproj拖入到工程中。 在xcode工程的general中,点击embeded libraries中的+号,然后改我们的第三方库framework,类似下图:

最后就可以直接在工程中需要使用的地方,通过import模块名来使用了。 如果是多人团队开发,我们就需要共享了,那么其他成员就需要通过下面的命令来安装:

 
1
2
3
 
git submodule update --init --recursive
 

这是通过递归来安装或者更新submodule。这是挺麻烦的一件事。然后根据使用的经验,我们下载别人的工程下来后,执行了上面的命令,安装好相关模块了,运行工程经常出现报错的问题,也就是配置问题。因此,个人很不喜欢这种方式。

事实上,在Xcode7是不再需要这么做了,对于其他Xcode版本是否需要,未验证。 我们通过cocoapods安装的第三方库会自动生成为framework,然后我们只需要在使用的地方直接通过import 模块名使用即可。但是有时候可能会出现某个第三方库直接通过import 模块名时,提示找不到,也就是没有智能提示。这时候我们可以通过在xcode工程的general中的embeded libraries点击+,然后导入该framework,就可以正常import了。另外如果导入的第三方库在运行时,报错了,类似于:

 
1
2
3
4
 
dyld: Library not loaded: @rpath/ReactiveCocoa.framework/ReactiveCocoa
Referenced from: /private/var/mobile/Containers/Bundle/Application/31ABC86A-C1BD-40DD-A117-D2C8F79A98FE/SwiftGithubClient.app/SwiftGithubClient Reason: image not found
 

那么我们可以这么解决:

Build Phases->Link Binary With Libraries->找到出错的库的名称->修改requiredoptional即可。

如何升级CocoaPods版本?

升级CocoaPods是非常简单的,只需要一个命令即可。 正常情况下,只需要一个命令就可以升级了:

 
1
2
3
 
sudo gem install cocoapods
 

但是有可能需要更新gem才能升级cocoapods,因此我们可能需要这么做:

 
1
2
3
4
5
6
7
8
9
10
 
$ sudo gem update --system // 先更新gem,国内需要切换源
$ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/
$ gem sources -l
    CURRENT SOURCES
    http://ruby.taobao.org/
$ sudo gem install cocoapods // 安装cocoapods
$ pod setup
 

然后查看版本号:

 
1
2
3
4
 
$ pod --version
0.39.0
 

如何让自己的开源项目支持CocoaPods?

这里就介绍我写的一个三方库HYBMasonryAutoCellHeight让其支持Cocoapods的步骤。

  • 1、第一步:打开终端并进入到工程的目录。这里是我所开源的一个HYBMasonryAutoCellHeight开源库,用于自动计算cell的高度。
 
1
2
3
 
cd HYBMasonryAutoCellHeight
 
  • 2、第二步:创建一个Podspec文件。通过命令pod spec create创建,
 
1
2
3
 
pod spec create HYBMasonryAutoCellHeight
 
  • 3、第三步:编辑该podspec文件:
 
1
2
3
 
VI HYBMasonryAutoCellHeight.podspec
 

大家会看到,这自动生成的已经是一个模板了,我们需要做的就是修改相关内容,补充内容就可以满足我们的需求了。对于更高级的使用,就需要参考官方文档,一步步地学习使用了。 看看我所提供的第三方库的podspec文件的配置,去掉注释后看一看最关键的配置:

 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
 
Pod::Spec.new do |s|
 
s.name         = "HYBMasonryAutoCellHeight"
s.version      = "0.0.1"
s.summary      = "基于Masonry的自动计算cell的行高的扩展库"
s.homepage     = "http://hybios.lianliankeji.com/cocoapods-support/"
s.license      = "MIT"
s.author       = { "huangyibiao" => "huangyibiao520@163.com" }
s.platform     = :ios, "6.0"
s.source       = { :git => "https://github.com/632840804、HYBMasonryAutoCellHeight.git", :tag => "0.0.1" }
s.source_files  = "HYBMasonryAutoCellHeight", "*.{h,m}"
s.requires_arc = true
s.dependency "Masonry", "~> 0.6"
 

这一步很关键,需要配置的东西比较多。主要是s.source这里必须提供我们的git路径、指定tag号和s.source_files这里必须指定库的源代码文件。通常我们会把我们的库放到与Demo工程的.xcodeproj同级,比较这里的HYBMasonryAutoCellHeight目录是与.xcodeproj是同级的父级目录,然后我们就可以更简单的设置了。如下图:

然后我们在设置s.source_files时,第一个就设置为HYBMansonryAutoCellHeight,第二个就是设置为所有的.{h,m}类型的文件。对于比较复杂的设置,可以参考AFNetworking中的podspec文件。

如果我们的开源库依赖系统库怎么办?

 
1
2
3
4
5
6
7
8
9
 
# s.framework = 'SomeFramework'// 去掉#,设置依赖的系统库名称
# s.frameworks = 'SomeFramework', 'AnotherFramework'//设置多个系统库名称
 
# s.library = 'iconv'// 设置只依赖一个系统的library
# s.libraries = 'iconv', 'xml2' // 设置依赖多个系统的library
 
# s.xcconfig = { 'HEADER_SEARCH_PATHS' => '$(SDKROOT)/usr/include/libxml2' }// 这里是工程配置,这样使用者就不需要手动处理,由pod自动处理了。
 

如果的开源库依赖其他第三方库,怎么办:

 
1
2
3
 
s.dependency 'JSONKit', '~> 1.4'//设置我们的开源库依赖哪些第三方库和依赖的版本号。
 
  • 4、第四步:这里呢,我们设置的版本号为0.0.1,那么tag号为0.0.1,因此我们还需要新建一个tag,名为0.0.1,然后推到git
 
1
2
3
4
5
6
 
$ git commit -m "如果当前有变化,先提交到git上,再创建tag"
$ git tag 0.0.1
$ git push --tags
$ git push origin master
 

第四步可以不用。

接下来,我们需要验证我们的配置是否正确:

  • 5、当然我们还可以直接使用:pod lib lint来验证所有,最后一个是设置允许警告:
 
1
2
3
 
pod lib lint HYBMasonryAutoCellHeight.podspec --allow-warnings
 

如果验证通过,会出现这样的提示:

 
1
2
3
4
5
 
-> HYBMasonryAutoCellHeight (0.0.1)
 
HYBMasonryAutoCellHeight passed validation.
 

如果刚才我们的配置出错,或者需要修改一些内容,重新再推,则可以先删除远程的tag 0.0.1,然后在修改后,重复上面的第四步。下面是删除远程tag命令:

 
1
2
3
 
git push origin :refs/tags/0.0.1
 

6、第五步:在验证通过后,提交到cocoapods。也就是通过命令pod trunk push库名.podspec来推送到远程的cocoapods

 
1
2
3
 
pod trunk push HYBMasonryAutoCellHeight.podspec --allow-warnings
 

如果出现警告,需要修改相关内容以去掉警告。当操作成功后,我们就可以通过pod search命令来搜索我们的库了。

 
1
2
3
4
5
6
7
8
9
10
 
$ pod search HYBMasonryAutoCellHeight
 
-> HYBMasonryAutoCellHeight (0.0.1)
   基于Masonry的自动计算cell的行高的扩展库
   pod 'HYBMasonryAutoCellHeight', '~> 0.0.1'
   - Homepage: http://hybios.lianliankeji.com/cocoapods-support/
   - Source:   https://github.com/632840804/HYBMasonryAutoCellHeight.git
   - Versions: 0.0.1 [master repo]
 

更详细地使用,请参考官方文档

这里有一篇文章,写得相当不错:支持pod

如何生成Cocoapods私有库?

要让自己的库变成私有库,那么我们的代码也是需要通过git来管理的。 这里假设我们新建了一个工程,名叫BookEffect,然后已经pushgit远程服务器。

  • 第一步:按照第六节一样,创建好podspec文件,并将整个工程推送到git服务器这边。
  • 第二步:这才是引入私有库的方式。pod 'DemoLib',:git=>"http://xxxxx.git"(替换为真实的git地址)

具体不细说,请参考:生成私有pod

使用Cocoapods打包静态库

这里就不细说,不过推荐一篇文章:打包表态库,写得很不错,如果需要,可以参考。

最后,感谢各位认真阅读本篇文章,感谢您的支持。

参考

Cocoapods的使用教程的更多相关文章

  1. iOS:最详细的创建CocoaPods私有库教程

    一.感慨 说实话,创建这个CocoaPods私有库,我愣是搞了两个星期,创建的过程中,自己的感情波动是这样的:激情四射---->有点困惑----->极度困惑----->有点失望--- ...

  2. 【转】CocoaPods的使用教程

    转载自:https://www.jianshu.com/p/dfe970588f95 前言 前几天发布我的开源库<最简单方便的iOS轮播开源库:JYCarousel>到CocoaPods的 ...

  3. 【CocoaPods】CocoaPods基本安装教程

    CocoaPods是什么,有什么用,怎么来等等我就不说了.反正就是一个管理第三方开源框架的~ 1. 配置前 - 本地安装好Ruby环境 2. 安装命令 -> sudo gem install c ...

  4. CocoaPods 安装使用教程

    CocoaPods 是比较好的第三方类库管理工具.可通过 terminal 命令进行第三方类库的安装,非常方便. 安装: Mac terminal 输入:gem install cocoapods 若 ...

  5. Cocoapods最新安装教程

    一.CocoaPods简介 每种语言发展到一个阶段,就会出现相应的依赖管理工具,例如 Java 语言的 Maven,nodejs 的 npm.随着 iOS 开发者的增多,业界也出现了为 iOS 程序提 ...

  6. 最新的 CocoaPods 的使用教程(一)

    发布开源库到CocoaPods的时候.对CocoaPods重新学习了一下. 1.CocoaPods的日常使用 2.创建CocoaPods的私有库 3.创建CocoaPods的开源库 一. CocoaP ...

  7. iOS之创建CocoaPods公有库教程

    简介 在开发过程中,经常会使用到第三框架,我们通过一个pod install命令,很方便的就将第三方框架加到我们自己的项目中. 如果我们也想将自己写的组件或库开源出去,让别人也可以通过pod inst ...

  8. 【转】小白级的CocoaPods安装和使用教程

    原文网址:http://www.jianshu.com/p/e2f65848dddc 百度有很多CocoaPods的安装教程.第一次看的时候,确实有点摸不透的感觉.经过思考,一步一步来实践,前后花了三 ...

  9. Reveal CocoaPods的使用

    Reveal是配合开发者编辑各种用户界面参数一款工具,运行界面如下,模拟器和真机都支持. Reveal使用时中不需要添加其他代码,只需要ios工程加载Reveal.framework,如果是真机需要确 ...

随机推荐

  1. _beginThreadex创建多线程解读【转】

    _beginThreadex创建多线程解读 一.需要的头文件支持 #include <process.h>         // for _beginthread() 需要的设置:Proj ...

  2. 如何在 CentOS 7 用 cPanel 配置 Nginx 反向代理

    导读 Nginx 是最快和最强大的 Web 服务器之一,以其高性能和低资源占用率而闻名.它既可以被安装为一个独立的 Web 服务器,也可以安装成反向代理 Web 服务器.在这篇文章,我将讨论在安装了 ...

  3. ios 异常捕获

    @try { @autoreleasepool { return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate c ...

  4. python 深入模块和包

    模块可以包含可执行语句以及函数的定义. 这些语句通常用于初始化模块. 它们只在 第一次 导入时执行.只在第一次导入的时候执行,第一次.妈蛋的第一次...后面再次导入就不执行了. [1](如果文件以脚本 ...

  5. Raspberry Pi 学习笔记之一

    记录几个搭建服务器教程: [教程] 将树莓派变成网络打印机服务器(更新PC和手机端设置)!http://www.eeboard.com/bbs/thread-8818-1-1.html[心得] [分享 ...

  6. 5.8---像素设定(CC150)

    注意:仔细注意位置. public static int[] renderPixel(int[] screen, int x, int y){ int[] ans = new int[screen.l ...

  7. django ATOMIC_REQUESTS

    在数据库配置中,如果配置了此属性为True,如下: DATABASES = { 'default': { 'ENGINE': 'django.db.backends.xxx', 'NAME': '', ...

  8. 在sublime-text中设置浏览器预览

    配置在Chrome,Firefox中打开 安装 SideBarEnhancements 然后通过ctrl + k, ctrl + b打开侧边栏,在侧边栏的文件中右击,找到 open width -&g ...

  9. 【leetcode】Scramble String

    Scramble String Given a string s1, we may represent it as a binary tree by partitioning it to two no ...

  10. CSS中的float与clear

    参考: http://www.cnblogs.com/iyangyuan/archive/2013/03/27/2983813.html http://www.cnblogs.com/iloveyou ...