美文网首页
发布组件到cocoaPods(附更新和删除)

发布组件到cocoaPods(附更新和删除)

作者: jiangzz | 来源:发表于2021-02-22 09:02 被阅读0次
    • 前提:打开终端 执行 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
    

    相关文章

      网友评论

          本文标题:发布组件到cocoaPods(附更新和删除)

          本文链接:https://www.haomeiwen.com/subject/gcutfltx.html