cocoaPods 组件发布

一、创建仓库

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

创建好后，先放置一边；

二、创建本地组件代码库

• 在本地创建一个存放组件的文件夹
• 打开终端 先cd到该文件夹下；
• pod lib create<组件名>

代码语言：txt复制

例：pod lib create  MyThirdPartySDK

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

代码语言：txt复制

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

代码语言：txt复制

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

代码语言：txt复制

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

代码语言：txt复制

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

代码语言：txt复制

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

代码语言：txt复制

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

fixed：6 有可能没有

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

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

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

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

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

组件文件目录.png

四、pod组件到项目中

• cd Example，到Example目录，有Podfile文件的地方；
• 执行pod install;

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

五、索引文件XXX..podspec

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

代码语言：txt复制

Pod::Spec.new do |s|

代码语言：txt复制

  s.name             = 'MyThirdPartySDK' //SDK名字

代码语言：txt复制

  s.version          = '0.1.0' //版本号，后面和GitHub上的tag要保持一致

代码语言：txt复制

  s.summary          = 'A short description of MyThirdPartySDK.' //简介

代码语言：txt复制

  s.description      = <<-DESC

代码语言：txt复制

  TODO: Add long description of the pod here. //描述

代码语言：txt复制

                       DESC

代码语言：txt复制

  s.homepage         = 'https://github.com/[GitHub名字]/MyThirdPartySDK'

代码语言：txt复制

  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'

代码语言：txt复制

  s.license          = { :type => 'MIT', :file => 'LICENSE' } //开源默认证书

代码语言：txt复制

  s.author           = { 'XXX' => 'XXX@qq.com' } //作者

代码语言：txt复制

  s.source           = { :git => 'https://github.com/[GitHub名字]/MyThirdPartySDK.git', :tag => s.version.to_s } //项目地址和tag

代码语言：txt复制

  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

代码语言：txt复制

  s.ios.deployment_target = '9.0'

代码语言：txt复制

  # s.source_files = 'MyThirdPartySDK/Classes/**/*' //pod库的源文件

代码语言：txt复制

  s.vendored_frameworks = "MyThirdPartySDK/Classes/*.framework" //pod库中framework的路径

代码语言：txt复制

  # s.resource_bundles = {

代码语言：txt复制

  #   'MyThirdPartySDK' => ['MyThirdPartySDK/Assets/*.png']

代码语言：txt复制

  # }

代码语言：txt复制

  s.resource         = "MyThirdPartySDK/Assets/*.bundle" //指定的资源直接复制到客户端目标

代码语言：txt复制

  s.pod_target_xcconfig = { 'VALID_ARCHS[sdk=iphonesimulator*]' => '' }

代码语言：txt复制

  # s.public_header_files = 'Pod/Classes/**/*.h' //pod库暴露给用户工程的头文件

代码语言：txt复制

  #s.frameworks = 'UIKit', 'MapKit' //依赖的系统库

代码语言：txt复制

  s.dependency 'AFNetworking', '~> 4.0.1' //依赖的第三方库

代码语言：txt复制

end

六、提交到远程仓库

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

代码语言：txt复制

git add .

代码语言：txt复制

git commit -m "第一次添加组件"

代码语言：txt复制

git remote add origin <GitHub仓库地址>

代码语言：txt复制

git push origin master

代码语言：txt复制

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

代码语言：txt复制

git push --tags

七、验证cocoapods索引文件

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

代码语言：txt复制

pod spec lint --verbose --allow-warnings

代码语言：txt复制

//或

代码语言：txt复制

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；

代码语言：txt复制

pod trunk me

已注册trunk截图.png

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

代码语言：txt复制

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

• 注册完成后，会发送一个确认邮件，里面有链接，点击后，确认；
• 注册完毕后，进行发布；(在工程根目录下)

代码语言：txt复制

pod trunk push xxx.podspec 

代码语言：txt复制

//或

代码语言：txt复制

pod trunk push xxx.podspec --allow-warnings //允许警告

代码语言：txt复制

//或

代码语言：txt复制

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

发布成功

代码语言：txt复制

Updating spec repo `trunk`

代码语言：txt复制

Validating podspec

代码语言：txt复制

  -> MyThirdPartySDK (0.1.0)

代码语言：txt复制

Updating spec repo `trunk`

代码语言：txt复制

--------------------------------------------------------------------------------

代码语言：txt复制

   Congrats

代码语言：txt复制

   MyThirdPartySDK (0.1.0) successfully published

代码语言：txt复制

  January 26th, 00:41

代码语言：txt复制

 https://cocoapods.org/pods/MyThirdPartySDK

代码语言：txt复制

 Tell your friends!

代码语言：txt复制

--------------------------------------------------------------------------------

九、验证

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

代码语言：txt复制

pod search <库名字>

查找成功

代码语言：txt复制

-> MyThirdPartySDK (0.1.0)

代码语言：txt复制

   A short description of MyThirdPartySDK.

代码语言：txt复制

   pod 'MyThirdPartySDK', '~> 0.1.0'

代码语言：txt复制

   - Homepage: https://github.com/[GitHub名字]/MyThirdPartySDK  //对应XXX.podspec
配置的
   - Source:   https://github.com/[GitHub名字]/MyThirdPartySDK.git
   - Versions: 0.1.0 [trunk repo]

查找失败，会出现红色一行字，提示找不到

找不到的原因：

1- 发布成功后，需要隔一段时间，可能是还在审核中；

2- 可能第二天早上执行以下，就可以找到了；

代码语言：txt复制

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

---

附1：

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

代码语言：txt复制

//1-先修改XXX.podspec里面的tag

代码语言：txt复制

//2- 更新改动到远程仓库

代码语言：txt复制

git pull origin master

代码语言：txt复制

//3- 打tag，和XXX.podspec里面的tag一致；

代码语言：txt复制

git tag <版本号> 

代码语言：txt复制

git push --tags

代码语言：txt复制

//4- 执行发布命令

代码语言：txt复制

pod trunk push xxx.podspec --allow-warnings --skip-import-validation

附2：

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

代码语言：txt复制

pod trunk delete MyThirdPartySDK 0.1.0

assets cocoapods png search validation

0 人点赞