前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >cocoaPods 组件发布

cocoaPods 组件发布

原创
作者头像
派大星在吗
发布2021-12-06 13:47:01
5820
发布2021-12-06 13:47:01
举报
文章被收录于专栏:我的技术专刊我的技术专刊

一、创建仓库

  • 仓库名为 组件名称(在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

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
作者已关闭评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、创建仓库
  • 二、创建本地组件代码库
  • 三、在组件项目中添加组件
  • 四、pod组件到项目中
  • 五、索引文件XXX..podspec
  • 六、提交到远程仓库
  • 七、验证cocoapods索引文件
  • 八、发布
  • 九、验证
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档