[iOS]最详细的CocoaPods私有pod创建教程

请先安装CocoaPods,步骤可以自行百度,这里略过.

如果lint失败请升级CocoaPods

为什么要搞私有pod:
1. 组件化(此路漫漫),通过pod的方式将项目组件化
2. 发布自己的开源项目,支持pod

直接说步骤(包含一些可能出现的坑)
一. 创建私有的spec文件仓库

1. 首先在github或gitlab上创建一个空项目,这里给个名字是TPSpecRepo.
2. 在终端执行如下命令

allen:.cocoapods allentang$ cd ~/.cocoapods/
allen:.cocoapods allentang$ ls
repos
allen:.cocoapods allentang$ cd repos/
allen:repos allentang$ ls
TPSpec1 master
//这个命令的作用:(1).创建本地仓库.(2)同第1步创建的github项目关联起来
//pod repo add 私有库名字 github/gitlab项目地址
allen:repos allentang$ pod repo add TPSpecRepo https://github.com/TPQuietBro/TPSpecRepo.git 
Cloning spec repo `TPSpecRepo` from `https://github.com/TPQuietBro/TPSpecRepo.git`
allen:repos allentang$ ls
TPSpec1     TPSpecRepo  master

此时我们需要的私有仓库TPSpecRepo已经创建好了,如下图

完成后的显示

二. 创建我们需要pod的项目

1. 另起一个路径,这里我回到了桌面,命令如下:

allen:repos allentang$ cd ~/Desktop/
//这个命令的作用是创建一个pod项目,它会自动给你生成spec文件,后面需要更改这个文件
allen:Desktop allentang$ pod lib create TPHomeModule

2. 执行完这个命令之后会有如下几个选项,按照需求来填就好了

   
   终端显示
3. 选项填完之后回车,会自动创建一个项目,名字就叫TPHomeModule
   文件目录
4. 在TPHomeModule里面有两个文件夹

Assets:存放图片资源等等
Classes:存放源码,默认会有一个ReplaceMe.m文件

我们只需要把要上传的代码放入Classes文件即可,如果需要查看更改后demo效果,在Example中pod update即可更新修改的文件.

5. 在github或gitlab上创建新的pod项目,这里我创建的地址是
   https://github.com/TestModuleForPrivate/TPHomeModule.git
6. 进入TPHomeModule项目,修改spec文件,这里可以用vi或者文件编辑器(不推荐,因为可能会改变"的格式,造成lint不通过),我这里简单粗暴直接拖到xcode进行更改

Pod::Spec.new do |s|
  s.name             = 'TPHomeModule'
//版本是必须要填的
  s.version          = '0.1.0'
//描述是必填的
  s.summary          = 'This is TPHomeModule'
  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC
  s.homepage         = 'https://github.com/TestModuleForPrivate/TPHomeModule'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'allen' => 'xxx@163.com' }
//pod来源
  s.source           = { :git => 'https://github.com/TestModuleForPrivate/TPHomeModule.git', :tag => s.version.to_s }
//支持的系统版本
  s.ios.deployment_target = '8.0'
//需要pod下来的文件,就是你想给别人pod的文件
  s.source_files = 'TPHomeModule/Classes/**/*'
end

7. 执行pod lib lint --allow-warnings --verbose

 -> TPHomeModule (0.1.0)
TPHomeModule passed validation.

如此便是lint成功了.

8. 继续执行如下命令

git remote add origin https://github.com/TestModuleForPrivate/TPHomeModule.git//这里是你需要pod的项目地址,不是私有库的地址哦!!!!!
git add .
git commit -m "init spec"
git push origin master
//注意:如果你创建项目的时候生成了README或者license文件,那么这里你push的时候可能会push不了,这里的话可以用
git push origin master -f 强制提交,会覆盖之前的文件

9. 为仓库打tag(很重要),必须是第8步完成之后,执行这一步,而且这个tag必须和spec文件中的版本一致

git tag -m "version_1" 0.1.0
git push --tags

10. 最后一步,将你的spec文件push到私有库进行管理,可以用pod repo 命令查看你的私有库

//执行如下命令
// pod repo push 最开始建立的私有库名称 pod项目中的spec文件,--allow-warnings --verbose 忽略警告,打印详细日志
allen:TPHomeModule allentang$ pod repo push TPSpecRepo TPHomeModule.podspec --allow-warnings
Validating spec --allow-warnings --verbose
 -> TPHomeModule (0.1.0)
Updating the `TPSpecRepo' repo
Your configuration specifies to merge with the ref 'refs/heads/master'
from the remote, but no such ref was fetched.
Adding the spec to the `TPSpecRepo' repo
 - [Add] TPHomeModule (0.1.0)
Pushing the `TPSpecRepo' repo

到此私有库就建立完成了.
三. 测试私有pod,新建一个项目,然后进入到项目文件中,pod init之后在podfile如下书写:

(1)写source
//下面两个source是必须写的,通过下面两个url,pod的时候才能找到对应的仓库地址
(很重要**********************************)
source 'https://github.com/CocoaPods/Specs.git'
//下面这个地址是管理spec文件的私有库地址,不是pod lib create那个项目的地址
source 'https://github.com/TPQuietBro/TPSpecRepo.git'
platform :ios, '8.0'
target 'Demo' do
//注意,单引号也可以
pod "TPHomeModule"
end
(2) 不写source
platform :ios, '8.0'
target 'Demo' do
pod 'TPHomeModule',:git=>'https://github.com/TestModuleForPrivate/TPHomeModule.git'
end

然后pod install 即可在pods中生成你自己的项目文件.
后面的组件化之路,便是基于此.
这里感谢陈司机的博客CocoaPods私有库
谢谢!
10-17补充:
如果我们需要通过版本号进行pod,如图:

版本号pod

那么需要在spec文件的目录内

1. 先注册trunk,之后会收到一封邮件,点击验证即可

pod trunk register 你的邮箱 '你的名字'  --verbose

2. 查看自己的注册信息

pod trunk me

3. 推送到trunk

pod trunk push xxx.podspec --allow-warnings

4. 查询自己的版本号

pod search xxxx

5. 第一次pod 库的时候需要用pod update来进行更新,之后就可以用pod install了.

10-30更新
如果更新了spec文件,但是没有更新版本号,并且spec之前被push到了trunk,再pod repo push之后,实际上并没有改变pod的内容,这时候必须删除pod trunk delete name 0.1.1 之前的版本,然后再一次pod trunk push xxx.podspec,这时候更改的spec文件才会起作用.
11-15更新
如果遇到"could not find xxxmodule" 需要用--use-libraries修饰命令