请先安装CocoaPods,步骤可以自行百度,这里略过.
如果lint失败请升级CocoaPods
为什么要搞私有pod:
1. 组件化(此路漫漫),通过pod的方式将项目组件化
2. 发布自己的开源项目,支持pod
直接说步骤(包含一些可能出现的坑)
一. 创建私有的spec文件仓库
- 首先在github或gitlab上创建一个空项目,这里给个名字是TPSpecRepo.
- 在终端执行如下命令
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的项目
- 另起一个路径,这里我回到了桌面,命令如下:
allen:repos allentang$ cd ~/Desktop/
//这个命令的作用是创建一个pod项目,它会自动给你生成spec文件,后面需要更改这个文件
allen:Desktop allentang$ pod lib create TPHomeModule
-
执行完这个命令之后会有如下几个选项,按照需求来填就好了
终端显示 - 选项填完之后回车,会自动创建一个项目,名字就叫TPHomeModule
文件目录 - 在TPHomeModule里面有两个文件夹
Assets:存放图片资源等等
Classes:存放源码,默认会有一个ReplaceMe.m文件
我们只需要把要上传的代码放入Classes文件即可,如果需要查看更改后demo效果,在Example中pod update即可更新修改的文件.
- 在github或gitlab上创建新的pod项目,这里我创建的地址是
https://github.com/TestModuleForPrivate/TPHomeModule.git - 进入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
- 执行pod lib lint --allow-warnings --verbose
-> TPHomeModule (0.1.0)
TPHomeModule passed validation.
如此便是lint成功了.
- 继续执行如下命令
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 强制提交,会覆盖之前的文件
- 为仓库打tag(很重要),必须是第8步完成之后,执行这一步,而且这个tag必须和spec文件中的版本一致
git tag -m "version_1" 0.1.0
git push --tags
- 最后一步,将你的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文件的目录内
- 先注册trunk,之后会收到一封邮件,点击验证即可
pod trunk register 你的邮箱 '你的名字' --verbose
- 查看自己的注册信息
pod trunk me
- 推送到trunk
pod trunk push xxx.podspec --allow-warnings
- 查询自己的版本号
pod search xxxx
- 第一次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修饰命令
