cocoapods-发布组件库到trunk

相关：
1- 发布组件库到私有索引库spec

• 前提： 先执行 pod search <名字>，查看在cocoapods官网上，是否已有同名的第三方库，避免后面麻烦；

一、创建仓库

• 仓库名为组件名字;
• Readme文件不用勾选；
• 访问级别：private、public；

两者不同，代表索引库的开放权限：
private：SDK私有，需要授权才能pod集成；
public：所有人都可以pod集成；

创建好后，先放置一边；

二、创建本地组件代码库

先进入(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
git tag <版本号> （和XXX.podspec里的一致，如：0.1.0）
git push --tags

七、验证cocoapods索引文件

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

• 1- 进行检验

pod spec lint --verbose --allow-warnings
//或
pod spec lint --skip-import-validation --allow-warnings --use-libraries 

pod spec lint --verbose --use-libraries --allow-warnings --sources='git@私有库地址.git,https://github.com/CocoaPods/Specs.git'

• 2- 校验成功：

XXX.podspec passed validation.

• 3- 校验失败
  会标出错误的说明，可以根据说明进行处理；

[!] The spec did not pass validation, due to 1 error.

失败信息 失败结果

八、发布

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

• 1- 先查看是否注册trunk；

pod trunk me

已注册

• 2- 如果没有注册，则先注册

pod trunk register <邮箱xxx@qq.com> "<名字>" --verbose

注册完成后，会发送一个确认邮件，里面有链接，点击后，确认；
注册完毕后.

• 3- 发布SDK (在工程根目录下，有XXX.podspec的目录)

pod trunk push xxx.podspec 
//或
pod trunk push xxx.podspec --allow-warnings //允许警告
//或
pod trunk push xxx.podspec --allow-warnings --skip-import-validation //跳过验证pod是否导入

• 4- 发布成功

Updating spec repo `trunk`
Validating podspec
  -> MySDK (0.1.0)

Updating spec repo `trunk`

--------------------------------------------------------------------------------
 🎉  Congrats

 🚀  MySDK (0.1.0) successfully published
 📅  January 26th, 00:41
 🌎  https://cocoapods.org/pods/MySDK
 👍  Tell your friends!
--------------------------------------------------------------------------------

九、验证

• 将组件发布cocoapods成功后，可以使用search命令搜索；

pod search <库名字>

• 查找成功

-> MySDK (0.1.0)
   A short description of MySDK.
   pod 'MySDK', '~> 0.1.0'
   - Homepage: https://github.com/[GitHub名字]/MySDK  //对应XXX.podspec配置的
   - Source:   https://github.com/[GitHub名字]/MySDK.git
   - Versions: 0.1.0 [trunk repo]

• 查找失败，会出现红色一行字，提示找不到
• 原因：
  1- 发布成功后，需要隔一段时间，可能是还在审核中；
  2- 可能第二天早上执行以下，就可以找到了；

[!] Unable to find a pod with name, author, summary, or description matching `MySDK `

可以尝试以下方式:

//进入搜索CocoaPods缓存目录
cd ~/Library/Caches/CocoaPods
//查看缓存文件search_index.json
ls
//删除搜索缓存文件
rm -f search_index.json

有时候pod search找不到的情况下，可能直接使用pod install就安装成功了，得到意想不到的结果；

pod 'MySDK' //podfile中添加
pod install //执行安装

查询已发布到trunk的库

更新已发布的库

// 1-先修改XXX.podspec里面的tag
s.version = '0.1.0' 

// 2- 更新改动到远程仓库
git push origin master

// 3- 打tag，和XXX.podspec里面的tag一致；
git tag <版本号> 
git push --tags

//4- 校验
pod spec lint --allow-warnings --skip-import-validation --use-libraries 
//5- 发布
pod trunk push xxx.podspec --allow-warnings --skip-import-validation

执行pod trunk push xxxx遇到的问题

1- 原因：原因是身份认证失效

invalid

Authentication token is invalid or unverified. Either verify it with the email that was sent or register a new session.

解决方案：重新验证身份

pod trunk register 'xxx@qq.com' 'yourname' --description='描述~'  
//然后到邮箱点击验证的链接；
//重新执行：pod trunk push xxxx

相关资料：

pod spec lint官网资料说明

--verbose //显示详情信息
--use-libraries //组件有依赖，迭代组件版本的时候,需要加上--use-libraries
--allow-warnings //允许警告
--skip-import-validation //跳过校验pod是否可以导入

pod spec lint --verbose 
pod spec lint --use-libraries
pod spec lint --allow-warnings

两种校验方式的区别：

• 两者和s. source填入的内容是相关的；

pod lib lint  //校验本地
pod spec lint  //校验本地和远程github，只有校验成功了，才能将

资料：cocoapods官网