前言
- 自制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" => "mccree@mc.com" }
# 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
