自定义库上传cocoapods 管理

作者: 武一顶顶 | 来源:发表于2018-09-05 15:30 被阅读28次

自定义库上传cocoapods 管理
2021-01-29
CocoaPods管理私有库
cocoapods上传库
CocoaPods安装
上传到cocopods
CocoaPods上传个人第三方库基本流程
iOS. 自己Framework上传Cocospods 流程处
从零创建cocoapods私有仓库
CocoaPods版本升级

引用 :
https://www.jianshu.com/p/283584683b0b //介绍遇坑
https://blog.csdn.net/yaoliangjun306/article/details/73550902 //介绍库更新
https://www.jianshu.com/p/e52bb69628a9 //介绍创建
https://www.jianshu.com/p/98aa76f62f27 //介绍创建
https://www.jianshu.com/p/fdc74f7d516b //介绍创建

导语

Cocoapods是iOS开发中一款优秀的包管理工具，由于其使用起来简单、高效，得到了广泛的使用。为什么要使用Cocoapods来管理第三方库呢？Cocoapods背后的原理是什么呢？如何制作出属于自己的私有库？如何制作属于自己的公有库呢？

为什么要使用Cocoapods来管理第三方库呢？

传统使用第三方库的劣势
1. 使用一个第三方SDK，需要在工程里面添加一堆配置，少添加一步配置就会报一大堆错误。这个时候为了排查少了哪一个步骤，只能从头开始重做一遍，太浪费时间和精力。有些配置还不好配置，就更使人烦躁郁闷了。
2. 如果使用的第三方SDK有比较重要的更新，想使用最新的SDK只能到官方下载最新的SDK，重新导入到自己的项目工程中。
3. 如果公司有多个项目，每一个工程都这样配置一遍，这是多么痛苦的领悟呀。
使用Cocoapods管理第三方库的优势
我们看下使用Cocoapods是如何管理一个第三方库的？在Podfile里面写入这些内容：
platform :ios, '8.0'
use_frameworks!
```
target 'MyApp' do
  pod 'AFNetworking'
  pod 'ORStackView'
  pod 'SwiftyJSON'
end‘
```

上面做完之后，只需要在命令终端敲入以下命令即可完成安装：
$pod install 是不是很简单，只需要敲入pod install命令，就能完成各种繁琐的配置，如果第三方库有更新，只需要敲入以下命令即可完成更新：$ pod update --no-repo-update #--no-repo-update忽略本地repo更新，这个会在下面做解释的。

Cocoapods私有库带来的好处
至此我们已经大概了解了一下使用Cocoapods管理第三方库的优势，但是我们会发现这些都是公有的库。如果公司内部实现一些私有的组件，不对外公开，而有想在不同项目中使用，改怎么办呢？使用Cocoapods制作私有库就完美的解决了这个问题。下图就是使用私有库带给我们的好处：

公有/私有库.jpg

通过图我们也可以看到，相同的代码只需要维护一份即可，遵循了软件的设计原则，don't repeat.

Cocoapods原理

关于具体的原理，可以参考Objc上的这篇文章：http://objccn.io/issue-6-4/
Cocoapods是如何实现查找第三方库呢？我自己是这样理解的，如下图：

怎么管理第三方库.jpg

从图中，可以看到通过.podspec可以找到我们想要的第三方库，那么.spec是什么呢？如下：

Pod::Spec.new do |s|
   s.name         = "CategoryComponents" #名称
   s.version      = "0.0.2" #版本号
   s.summary      = "bruce CategoryComponents." #描述

   s.homepage     = "https://coding.net/u/Bruce_ChenQi/p/DDNPrivatePods" #描述页面
   s.license      = "MIT" #版权声明
   s.author       = { "guoshimeihua" => "cqdeyouxiang@163.com" } #作者信息

   s.platform     = :ios, "7.0" #使用平台
   s.source       = { :git => "https://git.coding.net/Bruce_ChenQi/DDNPrivatePods.git", :tag => "0.0.2" } #源码地址

   s.source_files  = "Classes", "Classes/**/*.{h,m}" #源码文件
   s.frameworks = "CoreGraphics", "CoreFoundation", "Foundation", "UIKit" #依赖的framework
   s.requires_arc = true #是否支持ARC
end

至此，我们明白了查找到第三方库背后的原理。但是，具体如何进行搜索的呢？

先解释一个概念，什么是Spec Repo？它是所有的Pods的一个索引，也就是一个容器（集合），所有公开的Pods都在这个里面。实际上就是一个Git仓库remote端，当你使用了Cocoapods，这个仓库会被clone到本地的~/.cocoapods/repos目录下，进入到这个文件下可以看到master文件夹，就是官方的Spec Repo了。当你pod search的时候就在master这个文件下面查找的。

如何制作属于自己的公有库呢？

制作依赖库有几步

1.在github创建一个共有库

屏幕快照 2018-09-05 下午2.45.43.png
2.clone到本地，在该文件夹内创建一个新的项目

屏幕快照 2018-09-05 下午2.46.25.png

屏幕快照 2018-09-05 下午2.46.34.png

屏幕快照 2018-09-05 下午2.46.48.png

3.上传到github上
4.创建或登录trunk账号

屏幕快照 2018-09-05 下午2.47.52.png

屏幕快照 2018-09-05 下午2.47.58.png

5.添加podspec文件

屏幕快照 2018-09-05 下午2.48.17.png
6.上传到github，添加tag标记

git add .
git commit -m "添加了 .podspec文件"
git push

//这句话就是给我们的库文件打tag，这个tag一定要和.podspec文件内容一一对应，否则有问题
//将来每次更新我们自己的库文件的时候，要去升级库的版本号，要做两步
//1.修改.podspec文件中的数字      2.给我们的库打tags，如下所示
git tag 0.0.1
git push --tags

7.验证podspec文件

8.上传到Cocoapod中

 如果刚才验证，没有发现警告，那么可以直接这个样上传

pod trunk push waterFlowView.podspec
如果有警告，那么我们要去修改警告或者忽略警告

pod trunk push waterFlowView.podspec --allow-warnings
在上传的时候，要等几分钟才行

//上传成功的提示
🎉  Congrats
🚀  WaterFlowView (0.0.1) successfully published
📅  April 25th, 00:08 
🌎  https://cocoapods.org/pods/WaterFlowView 
👍  Tell your friends!

9.验证自己的库是否上传成功（大约半小时左右，时间不一定）

pod search WaterFlowView //查找

//也可以在https://cocoapods.org上搜
//搜不到 移除search_index.json
rm ~/Library/Caches/CocoaPods/search_index.json

CocoaPods: pod search 搜索类库失败的解决办法 (第9点, 此段文章是之前的文章移过来了, 非本文文章)


相信有的小伙伴已经成功安装了CocoaPods，也可以正常使用，然而会发现执行`pod search`来搜索类库信息时，却总是`[!] Unable to find a pod with name, author, summary, or descriptionmatching '······'`。在此我分享一下自己的经验，希望能给您提供帮助。(此贴是在成功安装CocoaPods，但不能pod search搜素类库的情况下探讨问题)。
*******************************************

1.  执行`pod setup`
    *   其实在你安装CocoaPods执行`pod install`时，系统会默认操作`pod setup`，然而由于中国强大的墙可能会pod setup不成功。这时就需要手动执行`pod setup`指令，如下：
    *   终端输入：`pod setup`
    *   会出现`Setting up CocoaPods master repo`，稍等几十秒，最底下会输出`Setup completed`。说明执行`pod setup`成功。
    *   如果pod search操作还是搜索失败，如下：
    *   终端输入：`pod search AFNetworking`
    *   输出：`Unable to find a pod with name, author, summary, or descriptionmatching 'AFNetworking'` 这时就需要继续下面的步骤了。
*******************************************
2.  删除~/Library/Caches/CocoaPods目录下的search_index.json文件
    *   `pod setup`成功后，依然不能`pod search`，是因为之前你执行`pod search`生成了search_index.json，此时需要删掉。
    *   终端输入：rm ~/Library/Caches/CocoaPods/search_index.json
    *   删除成功后，再执行`pod search`。
*******************************************
3.  执行`pod search`
    *   终端输入：`pod search afnetworking`(不区分大小写)
    *   输出：`Creating search index for spec repo 'master'.. Done!`，稍等片刻······就会出现所有带有afnetworking字段的类库。
*******************************************

10.如何升级自己的库

升级终端演示 demo

ying-MacBookPro:YYYFlow yingzhao$ git add .
ying-MacBookPro:YYYFlow yingzhao$ git commit -m "升级版本到1.0.2"
[1.0.0 cbc5f9b] 升级版本到1.0.2
 1 file changed, 1 insertion(+), 1 deletion(-)
ying-MacBookPro:YYYFlow yingzhao$ git push
Counting objects: 3, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 312 bytes | 312.00 KiB/s, done.
Total 3 (delta 2), reused 0 (delta 0)
remote: Resolving deltas: 100% (2/2), completed with 2 local objects.
To https://github.com/Ying419759006/YYYFlow.git
   04506b6..cbc5f9b  1.0.0 -> 1.0.0
ying-MacBookPro:YYYFlow yingzhao$ git tag 1.0.2
ying-MacBookPro:YYYFlow yingzhao$ git push --tags
Total 0 (delta 0), reused 0 (delta 0)
To https://github.com/Ying419759006/YYYFlow.git
 * [new tag]         1.0.2 -> 1.0.2

ying-MacBookPro:YYYFlow yingzhao$ pod lib lint YYYFlow.podspec

 -> YYYFlow (1.0.2)

YYYFlow passed validation.
ying-MacBookPro:YYYFlow yingzhao$ pod trunk push YYYFlow.podspec
Updating spec repo `master`

CocoaPods 1.6.0.beta.1 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.6.0.beta.1

Validating podspec
 -> YYYFlow (1.0.2)
    - WARN  | url: There was a problem validating the URL https://github.com/Ying419759006/YYYFlow.

[!] The spec 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.
ying-MacBookPro:YYYFlow yingzhao$ pod trunk push YYYFlow.podspec --allow-warnings
Updating spec repo `master`

CocoaPods 1.6.0.beta.1 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.6.0.beta.1

Validating podspec
 -> YYYFlow (1.0.2)

Updating spec repo `master`

CocoaPods 1.6.0.beta.1 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.6.0.beta.1


--------------------------------------------------------------------------------
 🎉  Congrats

 🚀  YYYFlow (1.0.2) successfully published
 📅  September 5th, 00:58
 🌎  https://cocoapods.org/pods/YYYFlow
 👍  Tell your friends!
--------------------------------------------------------------------------------
ying-MacBookPro:YYYFlow yingzhao$

如何制作出属于自己的私有库？

先创建出一个私有仓库，大家可以在coding上创建一个私有库（免费的）。
先cd到你要创建私有库的目录下面，然后把刚才创建的私有库从remote端clone到本地，clone完成后，如下图:

屏幕快照 2018-09-05 上午11.18.51.png

MyPods是我创建出来的文件夹，MyPrivatePods是从remote端clone到本地的。

在MyPrivatePods文件目录下，创建一个Classes文件，用来存放源码文件。创建完成如下：

[图片上传中...(屏幕快照 2018-09-05 上午11.18.51.png-1fd63b-1536118926151-0)]
在MyPrivatePods目录下创建.podspec文件，先在终端cd到该目录下，然后输入以下命令：
```
pod spec create BruceCategoryComponents
```

其中BruceCategoryComponents是我自己起的spec_name，可以根据自己的需要改成自己想要的名字。创建完成后如下图：

屏幕快照 2018-09-05 上午11.43.53.png

然后用Xcode打开.podspec文件，进行编辑，怎么进行编辑可以参考Cocoapods原理那部分，有提到的。编辑完成后，在终端可以输入
```
pod lib lint
```

编辑成功后，会出现以下提示的：

屏幕快照 2018-09-05 上午11.49.18.png

否则的话，根据终端提示的错误信息，进行修改，直到验证成功。

为了测试的方便，我们在MyPrivatePods目录下创建一个demo工程，这样方便以后对私有库进行维护更新与测试，创建完成后如下图：

屏幕快照 2018-09-05 上午11.49.23.png

把Classes源文件拷贝到demo工程里面，这样方便其他人也对该私有库进行维护，添加新的功能。

// 引用最好, 如果是copy的修改源码时还得替换

屏幕快照 2018-09-05 下午2.18.42.png

往coding上提交刚才的修改，并打上tag标签。一定要记得打上tag标签，且与刚才编辑.podspec里面写的版本号一致。

屏幕快照 2018-09-05 下午1.54.21.png

// 或者用终端
  git tag 1.0.0
  git push --tags

创建属于自己的私有库中心，为什么要创建自己的私有库，可以参照Cocoapods原理部分讲的。敲入以下命令即可：
```
pod repo add BrucePods https://git.coding.net/Bruce_ChenQi/MyPrivatePods.git
```

创建成功后，可以进入~/.cocoapods/repos目录下可以看到BrucePods文件。如下图：

屏幕快照 2018-09-05 下午2.32.46.png

下面就是把BruceCategoryComponents.podspec添加到私有库中心，如下：
```
pod repo push BrucePods BruceCategoryComponents.podspec
```

添加成功后，如下图：

屏幕快照 2018-09-05 下午2.24.30.png

可以进入到BrucePods目录下查看一下现在的文件目录结构：

屏幕快照 2018-09-05 下午2.24.39.png

这个时候，就可以通过pod search命令搜索到刚才创建的私有库了。如下所示：

屏幕快照 2018-09-05 下午2.24.45.png

到这个步骤我们的私有库就制作完成了。来测试一下，我们的私有库是否能够正常使用。我们创建一个新的工程，在Podfile文件中，写入以下内容：

target 'BruceDemo' do
   platform :ios, '7.0'
   pod 'BruceCategoryComponents'
end

然后运行pod install --no-repo-update命令，但是结果却如下：

屏幕快照 2018-09-05 下午2.35.35.png

这是为什么呢？因为需要指明仓库的来源才可以的。添加以下两句话就可以了。
公有仓库
source 'https://github.com/CocoaPods/Specs.git'
私有仓库
source 'https://git.coding.net/Bruce_ChenQi/MyPrivatePods.git'

私有库的升级、分支
在对私有库进行升级维护的时候，测试没有问题后，只需要重新编辑.podspec文件，修改相应的版本号，再次执行下面命令即可：

```
pod repo push BrucePods BruceCategoryComponents.podspec
```

想创建分支的话，只需对subspec进行设置即可。

删除私有库
如果想要删除私有库，需要分两步，第一步删除coding上创建的私有库。第二部，到~/.cocoapods/repos目录下，通过以下命令行即可删除：

```
rm -rf BrucePods
```

其他项目组成员如何使用私有库
首先在coding上面给其他成员添加相应的权限。另外，在其电脑上执行以下命令即可：
pod repo add BrucePods https://git.coding.net/Bruce_ChenQi/MyPrivatePods.git

自定义库上传cocoapods 管理
引用 :https://www.jianshu.com/p/283584683b0b //介绍遇坑https...
2021-01-29
创建和管理一个公共cocoapods仓库引言将自己封装的第三方库上传至Cocoapods的repo存储库，这样...
CocoaPods管理私有库
CocoaPods管理私有库 CocoaPods介绍 CocoaPods是帮助管理xcode项目第三方开源库的一个...
cocoapods上传库
参考文章https://www.jianshu.com/p/81d364c32432https://www.jia...
CocoaPods安装
CocoaPods安装 CocoaPods是什么鬼?## Cocoapods是类库管理工具。 CocoaPods有...
上传到cocopods
上传代码 github / cocoapods1: pod lib create 库名 2:github 创建库 ...
CocoaPods上传个人第三方库基本流程
前言: 之前写完EWPhotoPicker后尝试上传CocoaPods,毕竟通过CocoaPods管理要更方便,在...
iOS. 自己Framework上传Cocospods 流程处
前因：因公司需要做一些自定义动态库且适应多项目使用，鉴于方便管理，变想放入Cocoapods管理，然后经历一番...
从零创建cocoapods私有仓库
开发中用cocoapods管理第三方库,已经非常普遍.为了创建自己的cocoapods库,需要对cocoapods...
CocoaPods版本升级
CocoaPods版本升级使用CocoaPods管理项目类库错误现象失败，提示需要CocoaPods 1.0...