使用Cocoapods创建开源库 及 更新

转载自：CSDN 使用Cocoapods创建开源库 及 更新

题外话：项目中有一些组件需要从项目中剥离出来，使用Cocoapods创建私有的podspec并在项目中部署使用

实现步骤（基于pods自动创建）

在github 上新建一个repository

名字为 YYLib，如图：

这里写图片描述

1.克隆这个项目到本地 git checkout /clone ***

使用命令创建模板项目：pod lib create [podName]

该命令会根据输入的信息自动创建名为podName的本地git仓库，在项目的根目录下自动创建了podName.podspec、README.md、LICENSE文件，自动创建使用了podName库的Demo项目，在Pods工程下自动创建pod个人库开发文件夹。

$ pod lib create YYLib

命令执行后，会让确认一下几个问题

What language do you want to use?? [ Swift / ObjC ]

ObjC

Would you like to include a demo application with your library? [ Yes / No ]

yes

Which testing frameworks will you use? [ Specta / Kiwi / None ]

Kiwi

Would you like to do view based testing? [ Yes / No ]

yes

What is your class prefix?

CY

回答完这几个问题，用 XCode打开该库，如图所示:

这里写图片描述

用 XCode打开 YYLib.podspec，进行修改

Pod::Spec.new do |s|
  s.name             = 'YYLib'
  s.version          = '0.1.0'
  s.summary          = 'it is my pod Demo'

# This description is used to generate tags and improve search results.
#   * Think: What does it do? Why did you write it? What is the focus?
#   * Try to keep it short, snappy and to the point.
#   * Write the description between the DESC delimiters below.
#   * Finally, don't worry about the indent, CocoaPods strips it!

  s.description      = <<-DESC
it is my pod Demo.
                       DESC

  s.homepage         = 'https://github.com//YYLib'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'yanyanforest' => '[email protected]' }
  s.source           = { :git => 'https://github.com/yanyanforest/YYLib.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/'

  s.ios.deployment_target = '7.0'

  s.source_files = 'YYLib/Classes/**/*'

  # s.resource_bundles = {
  #   'YYLib' => ['YYLib/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
   s.frameworks = 'UIKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end

修改文件podspec和README 文件，添加封装的类。确保无误。

验证本地.podspec 文件的有效性（下面文中）

再把本地的文件提交并打 tag

$ git add .

$ git commit -a -m ‘first commit’//提交代码，并标注此次提交的信息

$ git push --set-upstream origin master

$ git remote add origin https://github.com/yanyanforest/YYLib.git

$ git push -u origin master

$ git tag -m “first release” “0.1.0”

$ git push --tags #推送tag到远端仓库

验证本地.podspec 文件的有效性

$ pod lib lint YYLib.podspec

 -> YYLib (0.1.0)
    - WARN  | url: The URL (https://github.com/yanyanforest/YYLib) is not reachable.

[!] YYLib did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it) and all results apply only to public specs, but you can use `--private` to ignore them if linting the specification for a private pod.
You can use the `--no-clean` option to inspect any issue.

如果有 Error这需要更改 error。如果有 warning, 但有不改正需要执行下面的命令：
$ pod lib lint YYLib.podspec --allow-warnings

在 pod 上创建库 远程托管地址为https://github.com/yanyanforest/YYLib.git

$ pod repo add YYLib https://github.com/yanyanforest/YYLib.git

正常执行结果为：

Cloning spec repo `YYOCFramework` from `https://github.com/yanyanforest/YYLib.git`

如果报错为

[!] /usr/bin/git clone https://github.com/yanyanforest/YYLib.git YYLib

Cloning into 'YYLib'...
remote: Repository not found.
fatal: repository 'https://github.com/yanyanforest/YYLib.git/' not found

解决方法：去自己的git官网 创建一个repository 名字为YYLib，之后执行

$ pod repo add YYLib https://github.com/yanyanforest/YYLib.git

Cloning spec repo YYLib from https://github.com/yanyanforest/YYLib.git

再次执行

$ pod lib lint YYLib.podspec

YYLib passed validation.

推到 pod 上

$ pod trunk push YYLib.podspec --allow-warnings

Log messages:

• December 1st, 20:18: Push for `YYLib 0.1.0' initiated.
• December 1st, 20:18: Push for`YYLib 0.1.0’ has been pushed
  (0.207867721 s).

分支

查看自己 pod 的信息。

$ pod trunk me

  - Name:     yanyanforest
  - Email:    [email protected]
  - Since:    November 28th, 20:30
  - Pods:
    - UICollectionViewLeftAlignFlowLayout
    - YYLib
  - Sessions:
    - November 28th, 20:30 日期地址
    Description: yanyan

$ pod trunk push YYLib.podspec

[!] You need to register a session first.

$ pod trunk register [email protected] ‘yanyanforest’ –description=’yanyan’

[!] Please verify the session by clicking the link in the verification email that has been sent to [email protected]
进入自己的邮箱，打开链接即可。

新建一个项目测试一下自己的类库

pod search 一下自己的类库

$ pod search YYLib

问题

pod search 搜索不到库

Unable to find a pod with name, author, summary, or descriptionmatching 「库名」

解决方法:输入下面命令
rm ~/Library/Caches/CocoaPods/search_index.json

An unexpected version directory Assets was encountered for the /Users/yanyan/.cocoapods/repos/** Pod in the YYLib repository.

解决方法:进入指定文件夹repos把YYLib删除即可。

回到指定 tag 的版本

$ git checkout -B master 0.1.3

注意这里的参数-B 和-b 的区别

git checkout -b
git checkout -b|-B []
Specifying -b causes a new branch to be created as if git-branch(1)
were called and then checked out. In this case you can use the
–track or –no-track options, which will be passed to git branch.
As a convenience, –track without -b implies branch creation; see
the description of –track below.

       If -B is given,  is created if it doesn't exist;
       otherwise, it is reset. This is the transactional equivalent of

           $ git branch -f  []
           $ git checkout 

       that is to say, the branch is not reset/created unless "git
       checkout" is successful.

-b
Create a new branch named and start it at
; see git-branch(1) for details.

-B
Creates the branch and start it at ; if
it already exists, then reset it to . This is
equivalent to running “git branch” with “-f”; see git-branch(1) for
details.

bug

[!] Authentication token is invalid or unverified. Either verify it with the email that was sent or register a new session.
或者

[!] You need to register a session first.

解决方法：

终端输入命令：$ pod trunk register 邮箱地址 名字

• ERROR | [iOS] unknown: Encountered an unknown error (Simulator iPhone 4s is not available.) during validation.
  Pods workspace available at/var/folders/wx/yl8z3mrs3_x4hrznm38rhdj00000gn/T/CocoaPods/Lint/App.xcworkspace for inspection.

解决方法：

! [rejected] master -> master (non-fast-forward)
error: failed to push some refs to ‘https://github.com/yanyanforest/UICollectionViewLeftAlignFlowLayout.git’

解决方法：
$ git push -f origin master

---

更新

打开Example 下的项目文件: 库名.xcworkspace
找到Podfile,修改 pod ‘CYFramework’, :path => ‘../’
在终端进入到库文件夹
执行$ pod update
这里注意:有时会报如下错误

$ pod update

Update all pods
Updating local specs repositories
  $ /usr/bin/git -C /Users/yanyan/.cocoapods/repos/master fetch origin
  --progress
  fatal: unable to access 'https://github.com/CocoaPods/Specs.git/': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443 
[!] CocoaPods was not able to update the `master` repo. If this is an unexpected issue and persists you can inspect it running `pod repo update --verbose`

解决方法
$ env GIT_SSL_NO_VERIFY=true
再执行$ pod update
这里顺便注意一下，只要在过程中遇到LibreSSL SSL_connect: SSL_ERROR_SYSCALL ... 443 的错误就在终端输入该命令即可$ env GIT_SSL_NO_VERIFY=true

修改或者添加相应的文件, 修改对应的文件 :[库名].podspec 版本号

验证podspec文件的有效性

$ pod lib lint --allow-warnings

提交代码 打tag 该tag值和[库名].podspec中版本号保持一致
$ git tag 0.1.3 $ git push --tags
最后 trunk push [ 库名].podspec
$ pod trunk push [ 库名].podspec --allow-warnings
结果：

这里写图片描述

3.Unable to find a specification for 'xxx' depended upon by 'xxx'

pod lib lint WTxxxSDK.podspec

 -> WTxxSDK (0.1.0)
    - WARN  | source: Git SSH URLs will NOT work for people behind firewalls configured to only allow HTTP, therefore HTTPS is preferred.
    - WARN  | summary: The summary is not meaningful.
    - ERROR | [iOS] unknown: Encountered an unknown error (Unable to find a specification for `WTyySDK (~> 0.1.0)` depended upon by `WTxxSDK`

You have either:
 * out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.
 * mistyped the name or version.
 * not added the source repo that hosts the Podspec to your Podfile.
) during validation.

[!] CMIAPSDK did not pass validation, due to 1 error and 2 warnings.
You can use the `--no-clean` option to inspect any issue.

我的问题是因为，要上传的私有库依赖了一个WTyySDK私有库，导致无法找到。
解决，在pod lib link 时，添加--sources=''

pod spec lint --sources='https://github.com/CocoaPods/Specs.git,http://gitlab.appshahe.com/component/metaapp-ios-specs.git' --use-libraries --allow-warnings

最后我自己的项目中遇得到的一些问题，一些命令的区分使用：

参考：CocoaPods创建私有pod库（踩坑篇）
1.pod lib lint 和 pod spec lint
2.pod repo push
pod repo push xxxxxxx-ios_common_spec_repo XXIAPSDK.podspec --allow-warnings
3.“An unexpected version directory ‘Assets’ was encountered for the /Users/yanyan/.cocoapods/repos/** Pod in the xxx repository.”
这可能是由于误操作将私有库制作成了私有仓库了，搞成容器了，可以进入指定文件夹repos把xxx删除即可，删除完再发布就可以了。