创建Cocoapods私有库

Posted 2020-10-19 beckwang0912

本文以自己在公司做的一个手势密码私有库GesturePasswordKit为例说明。

 

1、在gitlab（或者github,我这里使用的例子是在gitlab上）上创建git仓库 （确保授权正确，避免后续出现权限问题） 

 

2、使用sourcetree 把空仓库clone到本地

 

3、将准备好的代码拷贝进去（只留下需要的文件，建议使用一级目录存储）, 需要外部调用的方法，要注意使用权限控制符号public /open

 

4、创建.podspec 文件 

       4.1 复制已有的 podspec 文件然后修改对应的参数

       4.2 执行命令行创建  pod spec create 【私有库名称】

       书写正确的参数配置，如下图：

Pod::Spec.new do |s|

  s.name         = "GesturePasswordKit"
  s.version      = "0.0.8"
  s.summary      = "手势密码"
  s.homepage     = "http://git.tuandai888.com/ios/GesturePasswordKit"
  s.license      = { :type => "MIT", :file => "LICENSE" } 
  s.description  = <<-DESC 
                        GesturePasswordKit 是一个用于实现手势密码管理的工具
                   DESC
  s.author       = { "wangzhitao" => "[email protected]" }
  s.platform     = :ios, "8.0"
  s.ios.deployment_target = "8.0"
  s.source       = { :git => "[email protected]:iOS/GesturePasswordKit.git", :tag => ‘v‘+s.version.to_s}
  s.source_files = ‘GesturePasswordKit/*.{png,h,m,swift}‘     // 多级目录使用：s.source_files = ‘GesturePasswordKit/**/*‘
  s.resources = "GesturePasswordKit/Resource.bundle"
  s.requires_arc = true
  s.dependency "Kingfisher"
  s.pod_target_xcconfig = { ‘SWIFT_VERSION‘ => ‘4.0‘ }       // 指定swift版本，一般不需要写

end

 

 

5、验证podspec

      pod lib lint --allow-warnings 

      此时验证时，gitLab上需要有podspec中的版本tag 

 

6、把代码提交到git服务器

      git init

      git add .

      git commit -m "first commit"

      git push origin master

    可随时使用git status 检查文件状态

 

7、打tag (命令行)

      git tag v0.0.1

      git push --tags

      git push origin master

      

     删除tag

     git tag -d v0.0.1

     git push origin :refs/tags/v0.0.1

     git push origin master

 

8、添加你的 Podspec 到你的 repo

      pod repo add  GesturePasswordKitSpecs [email protected]:iOS/GesturePasswordKit.git

    

      在此之前先打tag

      pod repo push GesturePasswordKitSpecs GesturePasswordKit.podspec --allow-warnings

 

     // 检查是否成功

     cd ~/.cocoapods

     open .

 

9、pod search GesturePasswordKit

 

#私有库版本升级遇到的问题 swift3.0->4.0

1. 更新时遇到此错误，处理方法。 

[!] The spec did not pass validation, due to 1 error.

[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run: 

    `echo "2.3" > .swift-version`.

遇到上面的这种情况，直接使用下面的这条命令就可以解决问题了。

echo "4.0" > .swift-version

加入这句话后多了.swift-version文件

2.主工程podfile文件最后添加以下代码，这段代码的作用是，不同的库，指定不同的版本，如有些第三方库用3.2版本，有些升级为4.0版本，可以自定在 

swift_32  swift4

中添加，数组可为空，如swift_3.2 = [‘RxSwift‘, ‘RxCocoa‘]  swift4 = [] 说明除了 [‘RxSwift‘, ‘RxCocoa‘]其余库都升级为4.0版本

添加下面这段代码的原因是，上面 echo "4.0" > .swift-version 执行后，导入私有库后pod install 会让主工程的pod 一并升级到4.0，导致所有第三方都变成了4.0，编译失败。

swift_32 = [‘RxSwift‘, ‘RxCocoa‘]

swift4 = [‘PalaverKit‘]

post_install do |installer|

  installer.pods_project.targets.each do |target|

    swift_version = nil

 

    if swift_32.include?(target.name)

      swift_version = ‘3.2‘

    end

 

    if swift4.include?(target.name)

      swift_version = ‘4.0‘

    end

 

    if swift_version

      target.build_configurations.each do |config|

        config.build_settings[‘SWIFT_VERSION‘] = swift_version

      end

    end

  end

end