草庐IT

iOS Cocoapods高级使用 -by:nixs

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

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

相信大家都使用过Cocoapods了吧？想起未使用pod的时代，每次想更新库的版本的时候，都不知道当前是哪个版本，而且库的代码还被修改过，这该如何替换、升级版本呢？有了pod之后，大家都可以控制版本，也很容易去升级版本，大家都不能修改第三方库！

适合人群

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

  1. 对未使用过Cocoapods的人群有参考价值
  2. 对使用过Cocoapods，但是未深入了解过的用户有参考价值
  3. 对有开源精神的，希望将自己的代码贡献到Cocoapods的用户有参考价值
如果您不属于以上人群，您是可以不阅读本篇文章的，当然阅读完也会有很大的帮助。

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

为何使用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。

使用下面的命令安装：

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的，下面的方式是基本的方式。

cd Desktop/Demos/KVODEMO
touch Podfile
vi Podfile

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

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

笔者还针对Podfile写了一篇​​玩转Podfile​​文章，对于英文不太好或者不想花太多时间去研究官方文档的，可以直接阅读此篇文章，即可达到您想要的目的了。关于Podfile更高级的使用说明，请参考​​官方文档​​或者关注后续文章！

ObjC工程中使用

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

#import

注意，如果这么做提示找不到头文件，那么我们可以尝试这么引入：​​#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​​,在当前项目的同级目录下执行类似这样的命令，如下：

git submodule add https://github.com/Masonry.git

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

 

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

git submodule update --init --recursive

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

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

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->找到出错的库的名称->修改required为optional即可。

升级CocoaPods

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

sudo gem install cocoapods

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

$ 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

然后查看版本号：

$ pod --version
0.39.0

使开源库支持pod

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

  • 第一步：打开终端并进入到工程的目录。这里是我所开源的一个HYBMasonryAutoCellHeight开源库，用于自动计算cell的高度。
cd HYBMasonryAutoCellHeight

  • 第二步：创建一个Podspec文件。通过命令pod spec create创建,
pod spec create HYBMasonryAutoCellHeight

  • 第三步：编辑该podspec文件:
vi HYBMasonryAutoCellHeight.podspec

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

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​​文件。

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

# 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自动处理了。

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

s.dependency 'JSONKit', '~> 1.4'//设置我们的开源库依赖哪些第三方库和依赖的版本号。

  • 第四步：这里呢，我们设置的版本号为0.0.1，那么tag号为0.0.1，因此我们还需要新建一个tag,名为0.0.1，然后推到git：
$ git commit -m "如果当前有变化，先提交到git上，再创建tag"
$ git tag 0.0.1
$ git push --tags
$ git push origin master

第四步可以不用。

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

  • 第五步：当然我们还可以直接使用:pod lib lint来验证所有，最后一个是设置允许警告:
pod lib lint HYBMasonryAutoCellHeight.podspec --allow-warnings

如果验证通过，会出现这样的提示：

-> HYBMasonryAutoCellHeight (0.0.1)

HYBMasonryAutoCellHeight passed validation.

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

git push origin :refs/tags/0.0.1

  • 第六步：在验证通过后，提交到cocoapods。也就是通过命令pod trunk push 库名.podspec来推送到远程的cocoapods：
pod trunk push HYBMasonryAutoCellHeight.podspec --allow-warnings

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

$ 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​​

注意事项

现在发布到podspec时，需要注意添加上​​--use-libraries​​，并且在验证时也需要添加这个参数，不然会一直报错！

当你遇到下面的错误：

include of non-modular header inside framework module

时，一定要注意了，这样发布：

pod trunk push HYBHelperKit.podspec --use-libraries

OK，成功发布了！

生成pod私有库

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

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

pod打包静态库

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

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

参考

参考​​官方文档​​而写下本篇文章，若有雷同，纯属意外！文章中所提供了站外链接，是一些笔者推荐的觉得不错的文章。

 

转载自标哥的笔记

CocoapodsnixsinheritsectioncodeiOS开发iOS教程iOS移动开发

有关iOS Cocoapods高级使用 -by:nixs的更多相关文章

  1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

    我正在学习如何使用Nokogiri，根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

  2. ruby - 使用 RubyZip 生成 ZIP 文件时设置压缩级别 - 2

    我有一个Ruby程序，它使用rubyzip压缩XML文件的目录树。gem。我的问题是文件开始变得很重，我想提高压缩级别，因为压缩时间不是问题。我在rubyzipdocumentation中找不到一种为创建的ZIP文件指定压缩级别的方法。有人知道如何更改此设置吗？是否有另一个允许指定压缩级别的Ruby库？ 最佳答案 这是我通过查看ruby​​zip内部创建的代码。level=Zlib::BEST_COMPRESSIONZip::ZipOutputStream.open(zip_file)do|zip|Dir.glob("**/*")d

  3. ruby - 为什么我可以在 Ruby 中使用 Object#send 访问私有(private)/ protected 方法？ - 2

    类classAprivatedeffooputs:fooendpublicdefbarputs:barendprivatedefzimputs:zimendprotecteddefdibputs:dibendendA的实例a=A.new测试a.foorescueputs:faila.barrescueputs:faila.zimrescueputs:faila.dibrescueputs:faila.gazrescueputs:fail测试输出failbarfailfailfail.发送测试[:foo,:bar,:zim,:dib,:gaz].each{|m|a.send(m)resc

  4. ruby-on-rails - 使用 Ruby on Rails 进行自动化测试 - 最佳实践 - 2

    很好奇，就使用ruby​​onrails自动化单元测试而言，你们正在做什么？您是否创建了一个脚本来在cron中运行rake作业并将结果邮寄给您？git中的预提交Hook？只是手动调用？我完全理解测试，但想知道在错误发生之前捕获错误的最佳实践是什么。让我们理所当然地认为测试本身是完美无缺的，并且可以正常工作。下一步是什么以确保他们在正确的时间将可能有害的结果传达给您？ 最佳答案 不确定您到底想听什么，但是有几个级别的自动代码库控制:在处理某项功能时，您可以使用类似autotest的内容获得关于哪些有效，哪些无效的即时反馈。要确保您的提

  5. ruby - 在 Ruby 中使用匿名模块 - 2

    假设我做了一个模块如下:m=Module.newdoclassCendend三个问题:除了对m的引用之外，还有什么方法可以访问C和m中的其他内容？我可以在创建匿名模块后为其命名吗(就像我输入“module...”一样)？如何在使用完匿名模块后将其删除，使其定义的常量不再存在？ 最佳答案 三个答案:是的，使用ObjectSpace.此代码使c引用你的类(class)C不引用m:c=nilObjectSpace.each_object{|obj|c=objif(Class===objandobj.name=~/::C$/)}当然这取决于

  6. ruby - 使用 ruby​​ 和 savon 的 SOAP 服务 - 2

    我正在尝试使用ruby​​和Savon来使用网络服务。测试服务为http://www.webservicex.net/WS/WSDetails.aspx?WSID=9&CATID=2require'rubygems'require'savon'client=Savon::Client.new"http://www.webservicex.net/stockquote.asmx?WSDL"client.get_quotedo|soap|soap.body={:symbol=>"AAPL"}end返回SOAP异常。检查soap信封，在我看来soap请求没有正确的命名空间。任何人都可以建议我

  7. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声？ - 2

    关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题？更新问题，以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点？我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等)，但我确实想创建一个输出文件。

  8. ruby-on-rails - 'compass watch' 是如何工作的/它是如何与 rails 一起使用的 - 2

    我在我的项目目录中完成了compasscreate.和compassinitrails。几个问题:我已将我的.sass文件放在public/stylesheets中。这是放置它们的正确位置吗？当我运行compasswatch时，它不会自动编译这些.sass文件。我必须手动指定文件:compasswatchpublic/stylesheets/myfile.sass等。如何让它自动运行？文件ie.css、print.css和screen.css已放在stylesheets/compiled。如何在编译后不让它们重新出现的情况下删除它们？我自己编译的.sass文件编译成compiled/t

  9. ruby - 使用 ruby​​ 将 HTML 转换为纯文本并维护结构/格式 - 2

    我想将html转换为纯文本。不过，我不想只删除标签，我想智能地保留尽可能多的格式。为插入换行符标签，检测段落并格式化它们等。输入非常简单，通常是格式良好的html(不是整个文档，只是一堆内容，通常没有anchor或图像)。我可以将几个正则表达式放在一起，让我达到80%，但我认为可能有一些现有的解决方案更智能。 最佳答案 首先，不要尝试为此使用正则表达式。很有可能你会想出一个脆弱/脆弱的解决方案，它会随着HTML的变化而崩溃，或者很难管理和维护。您可以使用Nokogiri快速解析HTML并提取文本:require'nokogiri'h

  10. ruby - 在 64 位 Snow Leopard 上使用 rvm、postgres 9.0、ruby 1.9.2-p136 安装 pg gem 时出现问题 - 2

    我想为Heroku构建一个Rails3应用程序。他们使用Postgres作为他们的数据库，所以我通过MacPorts安装了postgres9.0。现在我需要一个postgresgem并且共识是出于性能原因你想要pggem。但是我对我得到的错误感到非常困惑当我尝试在rvm下通过geminstall安装pg时。我已经非常明确地指定了所有postgres目录的位置可以找到但仍然无法完成安装:$envARCHFLAGS='-archx86_64'geminstallpg--\--with-pg-config=/opt/local/var/db/postgresql90/defaultdb/po

随机推荐