cocoapods-发布组件库到私有索引库spec

相关：
发布组件库到cocoapods trunk;

一、先建两个仓库

我使用GitLab来创建两个私有仓库，两个仓库的作用：

• 项目仓库：存放SDK项目的代码，用于打tag，和SDK版本对应；
• 索引库：存放SDK的索引；

索引库私有仓库注意点：
1- 创建之后，索引库是空的；
2- 需要有master分支，可以添加readme文件；
3- 索引库的命名，一般为：xxx_spec；

二、查看当前电脑的索引库

• 当前电脑有哪些索引库：

pod repo

索引库

• 关联索引库

pod repo add <索引库名字> <GitLab地址>
//如：
pod repo add xxx_spec http://git.xxxx/xxx_spec.git  

三、创建本地组件代码库

先进入(cd)到想放组件的文件夹下；

• 1- 创建索引项目

pod lib create <组件名>
//如： pod lib create MySDK

• 2- 执行后，会出现一系列的选择，按照步骤进行选择就OK；

What is your email?
What platform do you want to use?? [ iOS / macOS ]  //选择平台：iOS
What language do you want to use?? [ Swift / ObjC ] //选择语言：ObjC
Would you like to include a demo application with your library? [ Yes / No ]  //是否自动生成一个demo：Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]  //None
Would you like to do view based testing? [ Yes / No ] //No
What is your class prefix? //生成类的前缀

• 3- 最终生成一个组件项目，会自动打开项目；在项目的目录下，其中有个Example的目录，打开就可以看到目录结构；
  工程目录.png

四、在组件项目中添加组件

• 在这个项目中，Classes和Assets文件夹就是放组件文件的地方；
• ReplaceMe.m这个文件，是生成项目时，自动生成的，可以删除；
• 在Classes放入组件的文件，Assets组件放资源文件；

项目目录.png

五、pod组件到项目中

• cd Example，到Example目录，有Podfile文件的地方；
• 执行pod install;
• 执行完毕后，在项目目录可以看到组件已pod到工程中；

pod目录.png

六、索引文件XXX..podspec

打开工程的XXX..podspec文件，根据需要修改；

Pod::Spec.new do |s|
  s.name             = 'MySDK' //SDK名字
  s.version          = '0.1.0' //版本号，和GitHub上的tag要保持一致
  s.summary          = 'A short description of MySDK.' //简介

  s.description      = <<-DESC
  TODO: Add long description of the pod here. //描述，可以是个链接URL
                       DESC

  s.homepage         = 'https://github.com/[GitHub名字]/MySDK'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' } //开源默认证书
  s.author           = { 'XXX' => 'XXX@qq.com' } //作者
  s.source           = { :git => 'https://github.com/[GitHub名字]/MySDK.git', :tag => s.version.to_s } //项目地址和tag
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '9.0'

  # s.source_files = 'MySDK/Classes/**/*' //pod库的源文件
  s.vendored_frameworks = "MySDK/Classes/*.framework" //pod库中framework的路径
  
  # s.resource_bundles = {
  #   'MySDK' => ['MySDK/Assets/*.png']
  # }
  s.resource         = "MySDK/Assets/*.bundle" //指定的资源直接复制到客户端目录
  s.pod_target_xcconfig = { 'VALID_ARCHS[sdk=iphonesimulator*]' => '' }

  # s.public_header_files = 'Pod/Classes/**/*.h' //pod库暴露给用户工程的头文件
  #s.frameworks = 'UIKit', 'MapKit' //依赖的系统库
  s.dependency 'AFNetworking', '~> 4.0.1' //依赖的第三方库
  
end

七、项目推到私有仓库

在工程根目录下执行，即在XXX.podspec所在的文件夹

git add .
git commit -m "第一次添加组件"
git remote add origin <GitHub仓库地址>
git push origin master

八、本地检验

pod lib lint --allow-warnings

• 如果依赖了第三方库，则需要

pod lib lint --sources='<库1>,https://github.com/cocoaPods/Specs.git' --allow-warnings

• 第三方库中依赖了另外的第三方库

pod lib lint --sources="<库1>,<库2>,https://github.com/cocoaPods/Specs.git" --use-libraries --allow-warnings

九、打tag

git tag <版本号> （和XXX.podspec里的一致，如：0.1.0）
git push --tags

十、远程检验

pod spec lint --sources='<索引库地址>,https://github.com/cocoaPods/Specs.git' --use-libraries --allow-warnings

十一、将spec推到索引库

进入到xxx..podspec的文件夹下：

pod repo push <SDK名字> <依赖文件名>.podspec --skip-import-validation --allow-warnings --verbose