美文网首页iOS学习笔记
使用Cocoapods管理iOS组件入门

使用Cocoapods管理iOS组件入门

作者: 摘心 | 来源:发表于2021-01-05 20:33 被阅读0次

    1.创建组件

    pod lib create '组件名'
    
    # 使用平台
    What platform do you want to use?? [ iOS / macOS ] 
     > iOS
    # 使用语言
    What language do you want to use?? [ Swift / ObjC ] 
     > ObjC
    # 在组件中创建一个Example
    Would you like to include a demo application with your library? [ Yes / No ]   
     > Yes
    # 是否添加测试框架
    Which testing frameworks will you use? [ Specta / Kiwi / None ] 
     > None
    # 是否添加UI测试
    Would you like to do view based testing? [ Yes / No ] 
     > No
    # 组件类前缀
    What is your class prefix? 
     > YDD
    

    执行完成后打开工程目录如图:


    WeChatbef255916b0e837b72a62aabc4d6d93a.png

    将组件文件创建在图中ReplaceMe.m文件位置,将组件文件存储在ReplaceMe.m的文件夹Classes目录下,并删除ReplaceMe.m文件。

    2.修改podspec描述文件

    Cocopods原理:根据Podfile描述,找到对应代码库的podspec文件
    然后根据podspec中的描述,找到代码库,并且拷贝需要的文件到自己的工程中。
    如果组件工程已近存在,则直接在组件工程目录创建podspec文件即可

    pod spec create '组件名'
    
    Pod::Spec.new do |s|
    # 组件名称
      s.name             = 'YDDCategroy'
    # 组件版本号
      s.version          = '0.1.0'
    # 组件简介
      s.summary          = 'A short description of YDDCategroy.'
    # 组件详细描述,要比简介字数多一些
      s.description      = <<-DESC
    TODO: Add long description of the pod here.
                           DESC
    # 组件仓库
      s.homepage         = 'https://github.com/***/YDDCategroy'
      # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
    # 设置许可
      s.license          = { :type => 'MIT', :file => 'LICENSE' }
    # 组件作者
      s.author           = { '***' => '***' }
    # 组件仓库源,表示在哪可以找到组件工程(支持 git、svn、http 服务器)
      s.source           = { :git => '***', :tag => s.version.to_s }
      # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
    # 组件支持的最低系统版本
      s.ios.deployment_target = '9.0'
     # 组件库需要暴露的文件
      s.source_files = 'YDDCategroy/Classes/**/*'
    
     # 设置依赖库(系统),不需要 lib,例如: libicucore写成icucore即可
      s.libraries    = "resolv.9","icucore","sqlite3","z","xml2","bz2.1.0","c++"
     #设置依赖的 framework(系统),写的时候不需要后缀名
      s.framework    = "CoreTelephony","MediaPlayer","CFNetwork","SystemConfiguration","MobileCoreServices","AudioToolbox","AVFoundation","VideoToolbox"
     # 设置使用的静态库(非系统)
      s.vendored_library = 'sdk/*.a'  
      # 设置使用的framework(非系统)
      s.vendored_frameworks = ""
    
    # 设置子目录
      s.subspec 'Delegate' do |ss|
      ss.source_files = "sdk/Delegate/*.h"
      end
    
      s.subspec 'enums' do |ss|
      ss.source_files = "sdk/enums/*.h"
      end
    
      s.subspec 'Manager' do |ss|
      ss.source_files = "sdk/Manager/*.h"
      end
    
      s.subspec 'private' do |ss|
      ss.source_files = "sdk/private/*.h"
      end
    
      s.subspec 'types' do |ss|
      ss.source_files = "sdk/types/*.h"
      # 三级目录
      ss.subspec 'LiveChatRoomType' do |sss|
      sss.source_files = "sdk/types/LiveChatRoomType/*.h"
      end
      end
    
      s.subspec 'board' do |ss|
      ss.source_files = "sdk/board/*.h"
      end
    
      # s.resource_bundles = {
      #   'YDDCategroy' => ['YDDCategroy/Assets/*.png']
      # }
    
      # s.public_header_files = 'Pod/Classes/**/*.h'
      # s.frameworks = 'UIKit', 'MapKit'
     # 设置依赖的其他 pod 库
      # s.dependency 'AFNetworking', '~> 2.3'
    end
    

    3.将本地组件push到远端仓库

    在自己的github上新建组件仓库,将本地代码推向远端,并且打tag,注意tag版本号要和podspec文件中的版本号一直。

    # 创建tag版本
    git tag -a 0.1.0 -m '描述'
    # 将本地所有tag版本push到远端
    git push origin --tag
    

    4.验证组件

    验证组件,保证组件代码编译是没有问题的,verbose打印log,allow-warnings忽略警告保证lint通过,如果是私有组件要在后面添加--use-libraries

    pod lib lint --verbose --allow-warnings
    

    5.将组件的podspec描述文件推送到cocoapods

    pod trunk push --verbose --allow-warnings --use-libraries
    

    如果你的github账号之前没有注册cocoapod是不能推送podspec文件的,所以需要先注册。

    pod trunk register 'git邮箱' 'git用户名'
    

    执行完成后会收到验证邮件,在邮箱验证即可。

    通过以上过程自己的pod库就已经制作完毕,在第一使用pod install时没有找到自己的库,可能是本地trunk没有更新的原因吧,使用pod update是可以导入。如果是Podfile文件指定的iOS版本低于podspec中指定的iOS版本也会报错找不到对应的库,这种情况可以修改Podfile文件也可以修改podspec文件中系统版本,修改podspec文件后需要重新上传。

    6.更新组件:

    首先需要更新组件仓库代码,提交后大tag,然后更新podspec文件,podspec文件中的版本号和tag保证一致。

    # 更新cocoapod中的podspec
    pod trunk push
    # 更新私有仓库podspec
    pod 私有仓库 push
    

    7.本地组件

    组件在开发过程中还没有推送到远端,这时候需要使用本地组件,在主工程中对组件进行开发。
    1.修改本地组件的podspec文件中的spec.source路径,使其指向自己的本地文件路径。

    # path 为podspec文件目录下的相对路径
    spec.source       = { :path => 'YDDCategroy.podspec' }
    

    2.修改Podfile文件中的pod, 添加path本地文件路径

    target 'TestDemo' do
        pod 'YDDCategroy',  :path => '../YDDCategroy'
    end
    

    path路径可以是绝对路径也可以是相对路径,这里使用相对路径,由于TestDemo工程文件夹和YDDCategroy组件工程文件夹是同级文件夹,Podfile在TestDemo文件夹下,而YDDCategroy.podspec在YDDCategroy文件夹下,所以../指向TestDemo和 YDDCategroy的上级文件目录,YDDCategroy.podspec的文件目录的相对路径为 '../YDDCategroy' 。
    执行pod install后就会发现在工程的pods里面多了Development Pods,这时候说明可以直接在TestDemo工程中对组件进行开发。

    参考:https://www.jianshu.com/p/e3ec9a8bec97
    参考:https://www.dazhuanlan.com/2019/12/14/5df40a0b09d99/

    相关文章

      网友评论

        本文标题:使用Cocoapods管理iOS组件入门

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