1、注册CocoaPods:
a.若CocoaPods版本低,需要升级:
sudo gen install cocoapods
pod setup
b.查看自己是否注册过:pod trunk me
c.如没有则注册:(GitHub邮箱、GitHub用户名)
pod trunk register daixingchuang@163.com " Dxc123" --verbose
2、有2种方式创建工程项目 (我一般使用第一种)
以QYVersionUpdating为例
a方式: 在github上创建好空项目(包含license ,MIT,ReadMe)创建好直接终端执行命令行clone到本地:
然后cd到项目执行下面命令会在项目中生成 QYVersionUpdating.podspec文件:
pod spec create QYVersionUpdating
b方式:用pod创建
a.
pod lib create QYVersionUpdating
之后会问你四个问题:
.是否需要一个例子工程;
.选择一个测试框架;
.是否基于View测试;
.类的前缀;
我这里选择的是:
.Yes;
.Specta/Expecta;
.Yes
.QY
会自动打开新创建的 Xcode 项目
b.向Pod文件夹中添加库文件和资源,并配置podspec文件
这里,把Classes文件夹里面的ReplaceMe.m文件删掉,我把一个QYVersionUpdating共有组件放入Pod/Classes中;(注意:要对应.podspec文件的s.source_files路径)
然后cd 进入Example文件夹下,执行pod install命令;
然后进入项目添加github上的地址
git remote add origin 项目的URL (关联的远程库)
git remote -v (查看远程库信息)
git push -u origin master (推送到GitHub)
强制push:git push -u origin master -f
3、编辑.podspec文件
用Sublime Text 软件辑或命令行:
open -a xcode QYVersionUpdating.podspec ,
使用Xcode编辑
.podspec文件模板:
Pod:Spec.new do |s|
s.name = "QYVersionUpdating" #名称
s.version = "0.1.0" #版本号
s.ios.deployment_target = '8.0'#支持的pod最低版本
s.summary = "QYVersionUpdating简介:好用的APP更新提示库"#简介
s.homepage = "https://github.com/Dxc123/QYVersionUpdating"#项目主页地址
s.license = "MIT"#许可证
s.author = { "Dxc123" => "daixingchuang@163.com" }#作者
s.source = { :git => 'https://github.com/Dxc123/QYVersionUpdating.git', :tag => s.version}#项目的地址
s.requires_arc = true #是否支持ARC
s.source_files = "QYVersionUpdating//.{h,m}"
s.public_header_files = 'QYVersionUpdating//.{h}'
end
注意:常见的写法:
1、dependency:写法
s.dependency = 'AFNetworking' , 'SDWebImage'
2、source_files: 写法
'runtime/'
'runtime/runtime/.{h,m}'
'runtime/*/.h'
'.{h,m}' 表示匹配所有以.h和.m结尾的文件
''表示匹配所有文件
'**' 表示匹配所有子目录
3、source: 常见写法
s.source = { :git => "https://github.com/zhangyqyx/ZYRunTimeCoT.git", :commit => "68defea" }
s.source = { :git => "https://github.com/zhangyqyx/ZYRunTimeCoT.git", :commit => "68defea", :tag => 1.0.0 }
s.source = { :git => "https://github.com/zhangyqyx/ZYRunTimeCoT.git", :tag => s.version }
说明: commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定
- tag => 1.0.0 表示将这个Pod版本与Git仓库中某个版本的comit绑定
- tag => s.version 表示将这个Pod版本与Git仓库中相同版本的comit绑定
4、给QYVersionUpdating打tag**
- 因为cocoapods是依赖tag版本的,所以必须打tag,以后再次更新只需要把你的项目打一个tag
- 然后修改.podspec文件中的版本接着提交到cocoapods官方就可以了.
- 为git打tag, 第一次需要在前面加一个v ;如果出现错误,试一下不加v的情况.
git tag "v0.1.0"
- //将tag推送到远程仓库
git push --tags
其他:
- a、查看所有tags
git tag
就会罗列出我们所有的tags
- b、删除本地tags
- git tag -d + 分支名称就会删除本地的分支
- c、删除远程分支
- git push origin :refs/tags/分支名称 就删除了远程分支
例如: 先删除本地再删除远程标签, 删除后需要重新打标签
git tag -d 0.0.1
删除远程标签
git push origin :0.0.1
5、上传到GitHub
将包含配置好的 .podspec, LICENSE 的项目提交 Git,命令:
git add -A
git commit -m "xxxx"
git push origin master
// 在push之前, 查看spec是否配置有问题
// 验证本地spec文件是否有误
pod lib lint
// 验证远程spec文件是否有误
pod spec lint
如果出现警告性的问题,我们可以直接忽略:
pod lib lint --allow-warnings 或者 pod spec lint --allow-warnings
出现👇种情况就说明我们通过了验证:
QYCategory passed validation.
6、发布QYVersionUpdating到cocoapod
发布时会验证 Pod 的有效性,如果你在手动验证 Pod 时使用了 --use-libraries 或 --allow-warnings 等修饰符,那么发布的时候也应该使用相同的字段修饰,否则出现相同的报错。
// --use-libraries 或者--allow-warnings
pod trunk push QYVersionUpdating.podspec或者
pod trunk push QYVersionUpdating.podspec --allow-warnings
出现如下successfully published,就表示发布成功了
🚀 QYVersionUpdating (0.1.0) successfully published
📅 July 16th, 03:38
🌎 https://cocoapods.org/pods/QYVersionUpdating
👍 Tell your friends!
验证发布成功:这时候执行命令会出现以下结果:
pod search QYVersionUpdating
如果搜不到试试下面,或者在cocoapods官网直接查询
删除仓库的索引库
rm -rf ~/Library/Caches/CocoaPods/search_index.json
删除spec仓库
rm -rf ~/.cocoapods/repos/master
更新pod spec库
pod setup 或者pod repo update --verbose
更新pod spec库老是失败,执行:
git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
7、更新QYVersionUpdating版本
版本更新跟之前的步骤差不多,这就简单说一下步骤:
-
添加更新的内容,修改.podspec文件中的版本号;
s.version = "0.0.2" //修改0.0.2版本,不能是之前的版本,否则提交不成功
2.上传代码到远程仓库;
查看哪些文件改动:
git status
git提交到本地:
git add -A
提交改动的描述
git commit -m “更新XXX”;
提交到远程仓库
git push origin master。
3.打tag并上传;
git tag '0.0.2'
git push --tags
4.验证podspec文件并提交到pod发布。
spec repo //查询repo
pod spec lint或者pod spec lint --allow-warnings //验证.podspec文件
pod trunk push PublicLibQiuyh.podspec --allow-warnings //提交pod发布
pod search PublicLibQiuyh //查询库
遇到问题参考:
使用私有Cocoapods仓库遇到的问题