自建cocoaPods库

前言

• 自制Pod库的流程顺序有很多种,这里根据我们项目的实际情况,来选择了一下的制作流程:

本地新建FrameWork工程
在工程根目录下创建并填写podSpec文件
在宿主工程(或测试工程)中使用development pod方式导入自制pod库
调整pod库,使其可以正常使用
将FrameWork工程上传至git
更新podSpec文件中homepage、source、version等与git相关的参数
检查pod库合法性
上传podSpec文件至Spec Repo并检查是否上传成功
公开podSpec文件(如果需要)

一、安装/更新CocoaPods

• 开始前,我们先检查当前使用的CocoaPods是否为最新版本,如果不是,则需要升级成为最新版本的CocoaPods

sudo gem install cocoapods -n /usr/local/bin

二、创建FrameWork工程

• 创建FrameWork工程只是为了承载Pod库所需文件
• 实际上FrameWork工程文件并不需要进行任何配置,因为最终CocoaPods为我们生成product时所需的配置全部都是在podSpec文件中填写的(这里下一步会讲到)

• 创建好工程后我们把需要打成pod库的文件丢入工程文件夹内

  
  
  image.png

三、创建PodSpec文件

• 在与工程文件同级的路径下创建与pod库同名的.podspec文件
  

  image.png

• 填写podSpec文件,这里图中标红的位置暂时忽略

  
  
  image.png

注:文末有podSpec文件中所有参数的解释

四、在调试工程中导入pod库

• 这里我们使用development pod方式导入自制pod库,在podFile中填写方式如下:

pod 'pod库名',:path=>'.podspec文件所在的文件夹路径'

例:

image.png

五、调试pod库

• podFile填写完成后执行pod install

• 成功后,可以在工程下看到我们自制的pod库了,调试它,让它的功能可以正常运行

  
  
  image.png

六、上传FrameWork工程至Git

• pod库可以正常使用后,我们将pod所在的FrameWork工程上传至Git

  
  
  image.png

七、更新podSpec文件

• FrameWork工程上传至Git后,我们需要更新Spec文件中此前被我们忽略掉的几个参数

  
  
  image.png

八、检查pod库合法性

• 进入podSpec文件所在路径执行pod spec lint --allow-warnings
  
  image.png

九、上传podSpec文件至Spec Repo

• 进入podSpec文件所在路径执行pod repo push [本地repo源] [.podspec文件] --allow-warning

十、公开podSpec文件(如果需要)

• 进入podSpec文件所在路径执行pod repo push [本地repo源] [.podspec文件] --allow-warning
  

  image.png

• 上传成功后,其他有git权限的用户在pod update后,都可以成功导入我们创建的pod库了

文末 -- podSpec详解

  # podspec 中文注释,注释掉的字段为可选,未注释掉的为必填
  
Pod::Spec.new do |s|  
  
  # ―――Spec基本信息――――――――――――――――――――――――――――――――――――――――――――――#  
  # SDK名字
  s.name         = "TestPodSpec"  
  # SDK版本
  s.version      = "0.0.1"  
  # SDK说明,在搜索SDK时会显示
  s.summary      = "A short description of TestPodSpec."  
  # SDK的描述,DESC是分隔符,写在DESC之间
  s.description  = <<-DESC  
                  描述写在这里
                   DESC  
  # SDK主页,必须是一个能通过网络访问的页面,可以放作者个人页面,公司页面,哪怕放个www.baidu.com也行,只要能访问就可以.
  s.homepage     = "http://EXAMPLE/TestPodSpec"  
  #SDK截图,可以放gif
  # s.screenshots  = "www.example.com/screenshots_1.gif", "www.example.com/screenshots_2.gif"  

  # ―――License信息――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
  #license说明
  s.license      = "MIT (example)"  
  # s.license      = { :type => "MIT", :file => "FILE_LICENSE" }  
  
  # ―――作者信息――――――――――――――――――――――――――――――――――――――――――――――#
  # 作者信息,作者名字与邮箱
  s.author             = { "mccree" => "[email protected]" }  
  # Or just: s.author    = "" 
  # 有多个作者的话写这里 
  # s.authors            = { "" => "" }  
  # 社交链接地址
  # s.social_media_url   = "http://twitter.com/"  
  
  # ――― 支持iOS版本信息 ――――――――――――――――――――――――――――――――――――――――――――――――――――――― #  
  # 平台,可以写ios, osx
  # s.platform     = :ios  
  # 支持最低版本
  # s.platform     = :ios, "5.0"  
  #  支持混合平台  
  # s.ios.deployment_target = "5.0"  
  # s.osx.deployment_target = "10.7"  
  # s.watchos.deployment_target = "2.0"  
  # s.tvos.deployment_target = "9.0"  
  
  # ――― 代码仓库支持 git, hg, bzr, svn and HTTP ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #  
  # 代码仓库路径,SDK是根据tag号来取代码的,通常会把tag号设成和版本一样  
  s.source = { :git => "http://EXAMPLE/TestPodSpec.git", :tag => "#{s.version}" }  
  
  # ――― 代码文件 ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #  
  # 代码文件匹配,**指匹配任意文件夹,*.{h,m}指匹配任意.h和.m文件
  s.source_files  = "Classes", "Classes/**/*.{h,m}"  
  s.exclude_files = "Classes/Exclude"  
  # SDK需要暴露的.h文件,默认暴露所有
  # s.public_header_files = "Classes/**/*.h"  
  
  # ――― 资源路径 ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #    
  # 指定资源,比如xib,图片等资源都是
  # s.resource_bundles = {
    'XXXKit' => ['XXXKit/Classes/**/*.{storyboard,xib,cer,json,plist}','XXXKit/Assets/*.{bundle,xcassets,imageset,png}']
  }
  
  # ――― 系统库依赖以及静态库―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #  
  # s.framework  = "UIKit"  
  # s.frameworks = "UIKit", "AnotherFramework"  
  # s.library   = "iconv"  
  # s.libraries = "iconv", "xml2"  
  
  
  # ――― 其他三方库依赖 ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #  
  # 比如你的SDK依赖AFNetworking,注意这里和podfile中的语法不同在于,这里无法指定其他依赖的具体路径
  # 比如这种写法就不支持 s.dependency 'XMPPFramework', :git => "https://github.com/robbiehanson/XMPPFramework.git", :branch => 'master'
  # s.dependency "AFNetworking", "~> 3.0"  
  
end