CocoaPods理论篇

cocoapods.png

一、CocoaPods简介

CocoaPods是一个库管理工具,支持SwiftObjective-C编写的工程,CocoaPods有丰富的开发库,可以帮助开发者快速集成并使用这些开源库,从而提高开发效率。

二、CocoaPods安装

安装部分就不介绍的特别细了,介绍一些相关的工具和大体流程,帮助大家可以全面的了解。
CocoaPods是通过ruby语言编写。需要使用ruby的库管理软件gem来安装,ruby本来是macOS自带的,但我在使用过程中遇到了一些问题,所以我又自己用homebrew装了一个ruby(也可以用rvm安装rubyrvmruby的版本管理器,全称Ruby Version Manager)。

由于天朝网络限制,gem默认的软件源地址是不能访问的,所以需要切换到国内的镜像,最早是淘宝镜像,现在是ruby-china。切换源地址后可以正常用gem install了【切换源的方式-官网介绍】。

一切OK后,运行CocoaPods安装命令sudo gem install cocoapods就可以了。如下图,我安装的版本是1.3.1,帮助可以通过`--help查看

pod命令

ps:几个工具的官网地址,啥博客都不如官网准确!

三、CocoaPods使用之——App集成

CocoaPods最常用的方式就是在App开发中,通过快速集成一些常用的第三方库,来提高开发效率。这个过程一共分为三步:

  1. 创建App工程
  2. 创建并编写Podfile
  3. 执行pod install

其中,编写Podfile是一个很重要的过程,我们一起来认识一下这个东东。

  • Podfile是what?

PodfileCocoaPods的配置文件,用来描述Xcode工程和第三方库之间的关系。通过编写Podfile,可以配置Xcode工程中的哪个target需要哪些第三方库。然后通过pod install命令一键安装,就可以在Xcode工程中使用这些第三方库了。

  • Podfile的创建

Podfile可以自己手动新建一个命名为Podfile的文件,也可以通过命令行pod init创建。
使用命令行时,如果目录中存在多个工程文件.xcodeproj,则需要指定.xcodeproj的名字,如:pod init MyApp.xcodeproj。如果当前目录中只存在一个工程文件.xcodeproj,那么可以不指定.xcodeproj。执行pod init后会自动在当前目录中创建Podfile,并且会根据.xcodeproj中定义的target初始化Podfile
使用命令行自动创建的Podfile内容如下:

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'MyApp' do
  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
  # use_frameworks!

  # Pods for MyApp

  target 'MyAppTests' do
    inherit! :search_paths
    # Pods for testing
  end

  target 'MyAppUITests' do
    inherit! :search_paths
    # Pods for testing
  end

end

乍看之下, 好像东西挺多,那么我们来精简一下:

target 'MyApp'  #标识目标target
pod 'AFNetworking'  #引入要引用的第三方库,这里以AFNetworking为例

艾玛,就剩两行了,so easy~!

  • Podfile编辑

如果只有一个target,需要不断的引用一些开源的第三方库来帮助开发,可以很简单,就像上面精简后的Podfile一样,只需要不断的添加库就可以。但 随着业务的开展,可能上面这么精简的方式已经不能满足需求,需要对Podfile进行更加复杂的编写。

#可以设置工程支持的平台信息和最低版本
platform :ios, '7.0'  #表示指定将下面的库编译为iOS平台,7.0及以上版本

#默认pod install后会自动生成与project同名的workspace,但也可以指定自己想要生成的workspace的名字
workspace 'MyAppWorkspace'

#设置pod使用framework而不是static libraries。但是这种情况下pod编译出来的framework是动态库形式的。对于使用影响不确定
use_frameworks!

target 'MyApp' do
  #当目录中有多个工程文件时,需要指定工程的名字,'xcodeproj'选项已经废弃,修改为project
  project 'MyApp'

  #可以指定引用库的版本
  # pod 'AFNetworking'  #如果不加版本标识,则以最新版本为准
  pod 'AFNetworking', '~> 3.0'  #~>3.0表示[3.0, 3.x);另外还有'=','>','<'等标识

  #可以指定引用库的仓库地址
  #pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :tag => '0.7.0'

  #可以指定一个podspec文件,通过podspec文件中设置的内容进行下载
  pod 'JSONKit', :podspec => 'https://example.com/JSONKit.podspec'

  #可以使用本地路径,通常用于开发模式,即当需要开发pod库时,创建一个工程作为库的demo,这种方式下pod库是可编辑的
  #pod 'AFNetworking', :path => '~/Documents/AFNetworking'

  #可以指定一个子库,即一个subspec
  pod 'QueryKit/Attribute'

  #可以指定库的路径

  #可以在target块内部继续添加target,默认会继承外部的引用。如下MyAppTests会自动引入上面的AFNetworking和QueryKit/Attribute库
  target 'MyAppTests' do

    #如果不需要继承则可以设置标识inherit!,如下标识不继承MyApp的search_paths设置
    inherit! :search_paths
  end

end

  • 根据Podfile下载并配置第三方库

命令行模式cd到工程目录下,执行pod install即可。下载完成后打开目录下的workspace即可开始开发了。

  • Pod卸载

pod install之后,CocoaPods会自动产生一个pod的工程,且会对主工程添加一些设置,所以,直接打开主工程会编译失败。当不想依赖pod或想删除pod时,需要执行pod deintegrate,执行后会删除主工程对pod的依赖,但并不会删除pod文件。如果想彻底删除pod,只需要执行完命令后手动删除pod相关文件即可。

四、总结

目前几乎所有做App开发的都会用到CocoaPods,对CocoaPods的基本用法也是轻车熟路,而且对于CocoaPods的搭建和修改主要在项目的初步开发阶段,了解一些简单的用法就够了。
但是,CocoaPods本身是很强大的,它还可以创建lib库,支持lib库的开发和打包,这些内容将在下篇文章讲解。

推荐阅读更多精彩内容

  • CocoaPods 是什么? CocoaPods 是一个负责管理 iOS 项目中第三方开源库的工具。CocoaPo...
    朝洋阅读 9,202评论 4 34
  • Ruby 安装 要安装cocospods 首先需要安装ruby,可以先安装xcode,再安装macport ,最后...
    山天大畜阅读 706评论 0 1
  • 大家每天的工作大都是在说服他人。说服他人买你推荐的商品;说服领导采用你的方案;说服同事同意你的想法。 那我们要怎样...
    史诺比馨蔚阅读 20评论 1 1
  • 好啦!到此为止把之前的读后感都搬来啦,接下来就是新的篇章啦~
    想要一杯果西汁阅读 27评论 0 0
  • 要么选择死要么就选择顺从,没有别的选择,要活着就的天天每时每刻经历惊悚生活,这是我对消失的爱人的感受。 整部片子很...
    秦家炎阅读 20评论 0 2