cocoapods私有库创建步骤和问题

目的

不知道小伙伴们会在什么样的情况下用到私有库。我最初是在组件化拆分项目,接触到这个概念。项目解耦拆分成功之后,需要通过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. 建立与私有仓库的关联,并且将本地的文件上传到私有仓库。
    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 目录),删除此目录下你的 私有库的文件夹。

结尾

文章为自己创建私有库使用的步骤,如果你有任何问题,或者以上描述有问题,都可以告知我,我会更正问题。期待一起讨论,共同进步。

推荐阅读更多精彩内容