步骤总览
- 创建一个
git
仓库用来做内部私有库的Spec Repo
- 创建私有
Pod
组件库 - 将
podspec
文件加入私有Sepc Repo
中 - 查找和使用内部组件库
创建一个git
仓库用来做内部私有库的Spec Repo
创建私有Pod
组件库
- 了解原理
- 用
pod install
命令的时候,为什么可以直接把代码或者资源直接导入到我们的工程的?其实在我们的本地有目前支持cocoapods
所有项目的信息,我们可以打开~/.cocoapods/repos/Specs
目录,目录里面有很多的文件夹,在这些文件夹中我们项目中所使用的第三库NIMSDK
,进入目录下,我们搜索NIMSDK
,会发现有很多NIMSDK.podspec.json
文件,这是一个json格式的文件,打开后看到下面的代码,对比这些同名字的,主要是版本号的不同
- 上图可以清楚看到有关
NIMSDK
的信息,比如git地址,开源协议,简介等。有了这些数据cocoapods
就可以找到需要同步的资源的位置。在Specs
文件夹下的所有索引信息其实都是从cocoapods
的官方git
主分支https://github.com/CocoaPods/Specs上同步下来的。整个cocoapods的运作过程可以参照下图
- 通过上述简介,其实制作
cocoapods
仓库的步骤无非就两步:- 制作podspec索引文件,文件中放入需要同步的资源的
git
或者svn
地址 - 把制作的podspec索引文件推到官方的git远程主分支上
- 制作podspec索引文件,文件中放入需要同步的资源的
- 用
- 如果我们的库是新建的,那么别的使用者的本地分支上是没有对应的
.podspec.json
文件的,也就相应获取不到。这个时候使用者需要使用pod repo update
命令去远程重新获取更新本地分支~/.cocoapods/repos
文件是一个隐藏目录,默认是看不到隐藏目录的,但是我们可以通过Terminal
执行以下命令控制隐藏文件的显示与否
defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder
显示
defaults write com.apple.finder AppleShowAllFiles -boolean false ; killall Finder
隐藏- pod install 和 pod update 的区别
使用install 会优先安装Podfile.lock文件中的内容,而不会主动更新Podfile.lock文件.而执行pod update方法会主动获取最新的库,并更新Podfile.lock文件,这两个命令都会升级CocoaPods的spec
仓库
- 创建私有
Spec Repo
-
Terminal
执行以下命令
# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
pod repo add YTDevice https://github.com/Yakov1012/YTDevice.git
- 前后可以看到
~/.cocoapods/repos/Specs
的变化,多出来我们自己新建的YTDeviceRepo
-
- 创建私有
Pod
组件库- 在
Terminal
中cd
进入要创建项目的目录
- 然后执行以下命令
#pod lib create [项目名]
pod lib create YTDevice
- 之后他会问你四个问题
- 是否需要一个例子工程
- 选择一个测试框架
- 是否基于View测试
- 类的前缀
- 在
- 回答完以上问题,会自动在桌面创建一个
YTDevice
项目
├── Example
demo APP
│ ├── YTDevice.xcodeproj
│ ├── YTDevice.xcworkspace
│ ├── Podfile
demo APP 的依赖描述文件
│ ├── Podfile.lock
│ └── Tests
demo APP 的依赖文件
│ ├── Pods
demo APP组件的目录
├── LICENSE
开源协议 默认MIT
│ ├── Assets
资源文件
│ └── Classes
│ │ └── ReplaceMe.m 此处用于存放自己实现库的相关代码!!!
类文件
├── YTDevice.podspec
第三步要创建的podspec文件
└── README.md
MarkDown格式的README
- 添加实现代码
- 在
YTDevice
项目中,添加我们的实现代码,注意把实现代码加入到ReplaceMe.m
所在目录
- 开发模式下测试pod库的代码
- 打开Example工程目录Podfile文件
pod 'MyLib', :path => '../' # 指定路径
- 然后在Example工程目录下执行
pod update
命令安装依赖,打开项目工程,可以看到库文件都被加载到Pods子项目中了,不过它们并没有在Pods目录下,而是跟测试项目一样存在于Development Pods/YTDevcie
中,这是因为我们是在本地测试,而没有把podspec
文件添加到Spec Repo
中的缘故
- 在
- 本地
pod
组件库,与远程git
库链接
在Terminal
中cd
进入YTDevice项目的根目录,并执行以下命令
git add . # 添加文件
git commit -s -m "初始化YTDeviece库"
git remote add origin https://github.com/Yakov1012/YTDevice.git #与远端仓库链接
git push origin master #提交到远端仓库
git tag -m "first release" '1.0.1' #打上标签,这个很重要
git push --tags #推送tag到远端仓库
将podspec
文件加入私有Sepc Repo
中
- 配置YTDevice库的
podspec
文件
#
# Be sure to run `pod lib lint YTDevice.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html
#
Pod::Spec.new do |s|
s.name = 'YTDevice'
s.version = '1.0.1'
s.summary = 'YTDevice.'
# This description is used to generate tags and improve search results.
# * Think: What does it do? Why did you write it? What is the focus?
# * Try to keep it short, snappy and to the point.
# * Write the description between the DESC delimiters below.
# * Finally, don't worry about the indent, CocoaPods strips it!
s.description = <<-DESC
设备工具类,可查询当前设备名称,版本号等
DESC
s.homepage = 'https://github.com/Yakov1012/YTDevice'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'Yakov1012' => '1446486761@qq.com' }
s.source = { :git => 'https://github.com/Yakov1012/YTDevice.git', :tag => s.version.to_s }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '8.0'
s.source_files = 'YTDevice/Classes/**/*'
# s.resource_bundles = {
# 'YTDevice' => ['YTDevice/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
- 编辑完
YTDevice.podspec
文件后,需要验证一下这个YTDevice.podspec文件是否可用- 在
Terminal
中执行cd进入YTDevice项目根目录然后,执行命令pod lib lint
-
看到以下输出代表验证成功
- 在
- Example工程目录下执行
pod update
命令安装依赖,打开项目工程,现在可以看到库文件都被加载到Pods子项目中了
#pod 'YTDevice', :path => '../' # 指定路径
pod 'YTDevice', :podspec => '../YTDevice.podspec' # 指定podspec文件
-
pod search
可能出现以下问题,根据提示解决即可
删除Assets
和Classes
出现以上界面代表搜索成功
CocoaPods 在主干上发布pods
CocoaPods Trunk 是一个基于授权的CocoaPodsAPI服务。 要在主干上发布或者更新库,需要注册。
- 注册CocoaPods账户信息
使用trunk方式, 在终端执行如下代码
使用github邮箱和用户名
pod trunk register 邮箱地址 '用户名' --verbose
上图会提示你打开你的邮箱,打开确认链接,即可注册成功
成功之后可以终端执行如下代码:
pod trunk me
查看自己的注册信息, 以后当你有了自己的开源Pod库, 也可以用此方式随时查看自己发布过的Pods
然后去邮箱验证,验证后,可以通过命令 pod trunk me来查看账号所有Session
然后通过命令pod trunk push来发布pod。