目的
不知道小伙伴们会在什么样的情况下用到私有库。我最初是在组件化拆分项目,接触到这个概念。项目解耦拆分成功之后,需要通过cocoapods创建和管理私有库。再次建立私有库,是因为项目需要一个公共的基础模块。
建立cocoapods私有库步骤
1.在gitlabel或者coding.net上创建一个仓库,用来管理代码和版本控制。
2.创建LICENSE文件,这个文件一定要创建,不然无法提交到cocoapods。
3.在文件所在位置,创建podspec文件,并且配置相关信息。
Pod::Spec.new do |s|
#名字
s.name = "Text"
#版本号
s.version = "0.0.1"
#摘要
s.summary = "测试私有库创建"
#描述
s.description = <<-DESC
This is a base component library that can be used for all project base files.
DESC
#仓库地址
s.homepage = "仓库地址"
#写死即可
s.license = "MIT"
#创建者邮箱
s.author = { "linxia" => "xxxxxx@xxx.com" }
#支持系统
s.platform = :ios, "8.0"
#源地址和版本
s.source = { :git => "仓库地址", :tag => "#{s.version}" }
s.requires_arc = true
#私有库文件
s.source_files = 'Text/**/*.{h,m}'
#私有库资源文件这里不仅仅是bundle文件,例如xib等
s.resources = 'Text/**/*.{bundle}'
#依赖库,如果你要导入这个私有库,一下库如果在你的工程里面没有导入,就会一起导入。如果已经导入也不会重复导入。
s.dependency 'AFNetworking', '3.1.0'
s.dependency 'Masonry', '1.1.0'
s.dependency 'SDWebImage', '4.2.1'
s.dependency 'MJExtension', '3.0.13'
s.dependency 'MBProgressHUD', '1.0.0'
s.dependency 'MJRefresh', '3.1.15'
s.dependency 'TPKeyboardAvoiding', '1.3.1'
s.dependency 'DZNEmptyDataSet', '1.8.1'
#下面注释部分是拆分,具体的意思就是把项目中的某一个模块拆分出来,可以单独的给其它地方使用。
# s.subspec 'oneText' do |oneText|
# oneText.source_files = 'OneText/OneText/**/*.{h,m}'
# oneText.dependency 'XTesting/core'
# end
# s.subspec 'twoText' do |twoText|
# twoText.source_files = 'TwoText/TwoText/**/*.{h,m}'
# twoText.resources = 'TwoText/TwoText/**/*.{xib}'
# twoText.dependency 'XTesting/core'
# end
end
验证 pod lib lint Text.podspec --allow-warnings --use-libraries --verbose
source_file 路径要配置正确,如果验证报错--verbose 会给你提示,解决响应的错误,直到验证通过为止。
验证通过会显示绿色文字:Text passed validation
- 建立与私有仓库的关联,并且将本地的文件上传到私有仓库。
1.git init
2.git add -A (提交本地所有文件)
3.git commit -m “提交说明”
4.git remote add origin git仓库地址
5.git push origin 远程分支或者主分支
如果已经关联过,只需要直接2,3,5步骤
如果你是sourceTree管理,提交代码即可(podspec也要放在跟工程文件,提交到仓库里面去)
5.给项目打上tag
git tag 1.0.0
注意:tag的值要跟podspec文件中的s.version对应
git push - -tag
6.注册trunk
注册邮箱和用户名:pod trunk register XXX@XXX.com '名字' --verbose
查看注册信息:pod trunk me
7.在本地建立私有库
在这之前,我们可以在验证一下podspec文件是否可以验证通过
pod spec lint 库名.podspec --allow-warnings --use-libraries --verbose
pod repo add 私有库文件夹名字 git仓库地址
8.将私有库提交到pods
pod repo push 私有库文件夹名字 Text.podspec --allow-warnings --use-libraries --verbose
pod trunk push Text.podspec --allow-warnings --use-libraries --verbose
9.上传成功之后,pod setup更新。然后pod search 搜索库文件。可以搜索到就成功了。
问题
1.搜索库文件报错,An unexpected version directory Assets was encountered for the /Users/yanyan/.cocoapods/repos/ Pod in the YYLib repository.
解决办法,进入文件指定路径,将对应的文件夹删除即可。
2. [!] Unable to find a pod with name, author, summary, or descriptionmatching iOS\-AlipaySDK
rm ~/Library/Caches/CocoaPods/search_index.json
解决办法,替换pod搜索文件
~/Library/Caches/CocoaPods/search_index.json
使用私有库
添加私有 repo 到 podfile,同时还需要添加原 pod master 仓库,如下:source https://git.xxx.com/spec.git ’
source 'https://github.com/CocoaPods/Specs.git
将要使用的组件添加至 Podfile, pod install即可
如果私有库没有更新版本,直接删除tag值,然后合并代码,再重新打上tag的版本。想要获取到最新的版本的代码。请先更新本地repo库为最新。然后删除cocoapods本地存在的记录即可。
命令如下:
pod repo update 私有库名字。
CocoaPods 的缓存(~/Library/Caches/CocoaPods/Pods/Release 目录),删除此目录下你的 私有库的文件夹。
结尾
文章为自己创建私有库使用的步骤,如果你有任何问题,或者以上描述有问题,都可以告知我,我会更正问题。期待一起讨论,共同进步。