使用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/<GITHUB_USERNAME>/YYLib'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'yanyanforest' => 'yanyanforest@163.com' }
  s.source           = { :git => 'https://github.com/yanyanforest/YYLib.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  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:    yanyanforest@163.com
  - 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 yanyanforest@163.com ‘yanyanforest’ –description=’yanyan’

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

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

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, <new_branch> is created if it doesn't exist;
       otherwise, it is reset. This is the transactional equivalent of

           $ git branch -f <branch> [<start point>]
           $ git checkout <branch>

       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删除即可,删除完再发布就可以了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342

推荐阅读更多精彩内容