发布组件到cocoaPods（附更新和删除）

• 前提：打开终端 执行 pod search <名字>，查看在cocoapods官网上，是否已有同名的第三方库 ，有则修改。

例：pod search  MyThirdPartySDK

一、创建仓库

• 仓库名为 组件名称（在GitHub平台创建一个新的工程项目 ：名字为前提中的<名字>）

image

创建好后，先放置一边；

二、创建本地组件代码库

• 在本地创建一个存放组件的文件夹

• 打开终端 先cd到该文件夹下；

• pod lib create<组件名>

例：pod lib create  MyThirdPartySDK

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

1.Whatisyour email?What platformdoyou want to use??[iOS/macOS]//选择平台：

2.IOSWhat languagedoyou want to use??[Swift/ObjC]//选择语言：

3.ObjCWould you like to include a demo applicationwithyourlibrary?[Yes/No]//是否自动生成一个demo：

4.YesWhich testing frameworks will you use?[Specta/Kiwi/None]//None

5.Would you like todoview based testing?[Yes/No]//No

6.Whatisyourclassprefix?//生成类的前缀

fixed：6 有可能没有

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

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

在这个项目中，Classes和Assets文件夹就是放组件文件的地方；

ReplaceMe.m这个文件，是生成项目时，自动生成的，可以删除；

在Classes放入组件的文件，Assets组件放资源文件；

组件文件目录.png

四、pod组件到项目中

• cd Example，到Example目录，有Podfile文件的地方；

• 执行pod install;

执行完毕后，在工程目录下，可以看到组件已pod到工程中；

五、索引文件XXX..podspec

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

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

  s.description      = <<-DESC
  TODO: Add long description of the pod here. //描述
                       DESC

  s.homepage         = 'https://github.com/[GitHub名字]/MyThirdPartySDK'
  # 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名字]/MyThirdPartySDK.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 = 'MyThirdPartySDK/Classes/**/*' //pod库的源文件
  s.vendored_frameworks = "MyThirdPartySDK/Classes/*.framework" //pod库中framework的路径
  
  # s.resource_bundles = {
  #   'MyThirdPartySDK' => ['MyThirdPartySDK/Assets/*.png']
  # }
  s.resource         = "MyThirdPartySDK/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所在的文件夹；

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

校验成功：
XXX.podspec passed validation.
校验失败：
会标出错误的说明，可以根据说明进行处理；
[!] The spec did not pass validation, due to 1 error.

八、发布

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

• 先查看是否注册trunk；

pod trunk me

已注册trunk截图.png

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

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

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

• 注册完毕后，进行发布；(在工程根目录下)

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

发布成功

Updating spec repo `trunk`
Validating podspec
  -> MyThirdPartySDK (0.1.0)
Updating spec repo `trunk`
--------------------------------------------------------------------------------
 🎉  Congrats
 🚀  MyThirdPartySDK (0.1.0) successfully published
 📅  January 26th, 00:41
 🌎  https://cocoapods.org/pods/MyThirdPartySDK
 👍  Tell your friends!
--------------------------------------------------------------------------------

九、验证

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

pod search <库名字>

查找成功

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

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

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

---

附1：

• 更新已发布的库
  使用下面方法或重复 六、七、八步骤

//1-先修改XXX.podspec里面的tag
//2- 更新改动到远程仓库
git pull origin master

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

//4- 执行发布命令
pod trunk push xxx.podspec --allow-warnings --skip-import-validation

附2：

• 删除已发布的库的某一版本

pod trunk delete MyThirdPartySDK 0.1.0