cocoaPods 公有仓库的建立 (分享自己的源码)
查看 cocoapods Specs 索引目录
两种方式
1.终端: cd ~/.cocoapods/repos/master
open .
. 代表当前目录
.. 代表上级目录
2.finder: 显示隐藏文件
先在终端执行命令
defaults write com.apple.finder AppleShowAllFiles -boolean true
killall Finder
查看远程 Specs 仓库
你会发现master是一个git仓库
远程仓库的地址 git remote -v
```
// 输入浏览器查看
origin https://github.com/CocoaPods/Specs.git (fetch)
origin https://github.com/CocoaPods/Specs.git (push)
```
继续查看文件目录 Specs
这个时候我们输入 pod search Defaultskit (通过json文件获取)
可以看到里面有源码的下载地址 source versions 有多少个版本 等配置信息
我们在用cocoaPods 发布源码时, 需要将仓库的描述信息push到远程仓库中, 使用pod命令即可实现
创建 cocoaPods 账户
要想通过cocoaPods 上传我们的仓库配置信息, 需要注册cocoaPods账号
1.在终端执行命令
pod trunk register github_email 'user_name' --verbose
github_email 你的github账号注册时用的邮箱地址 user_name 自定义
出现下面的这条信息时, 说明账号注册成功, 到邮箱点击链接, 进行验证
Please verify the session by clicking the link in the verification email that has been sent to you_email
2.验证成功如下图
3.确认注册信息后, 在终端执行
pod trunk me
可看到注册信息如下图
到此, 注册账号完成
创建git仓库 (用来存放源码)
下来我们在github上 创建一个放我们要共享代码的仓库
如无github账号,先注册github账号
点击第二步之后, 复制了git仓库的地址
接下来在终端执行
cd 到你想要存放代码的目录
将github上创建的项目clone到本地
git clone https://github.com/xuxueyong/TestDemo.git
在testDemo目录下创建
- code 文件夹 用来存放我们的代码
- LICENSE 文件许可证
- READ.me 是创建仓库的时候就存在的 (仓库使用说明)
- podspec文件 用来描述和配置仓库信息 (非常重要)
创建podspec文件
在终端执行
pod spec create code
出现 Specification created at code.podspec
表示 code.podspec 创建成功
查看该文件有什么内容 发现很多字段, 我这里有整理好的字段 (ruby脚本语言)
Pod::Spec.new do |s|
s.name = "code" # 项目名称
s.version = "1.0.0" # 版本号 与 你仓库的 标签号 对应
s.license = "MIT" # 开源证书
s.summary = "A delightful TextField of PhoneNumber" # 项目简介
s.homepage = "https://github.com/xuxueyong" # 你的主页
s.source = { :git => "https://github.com/xuxueyong/TestDemo.git", :tag => "#{s.version}" }#你的仓库地址，不能用SSH地址
s.source_files = "code/*.{h,m}" # 你代码的位置， code/*.{h,m} 表示 code 文件夹下所有的.h和.m文件
s.requires_arc = true # 是否启用ARC
s.platform = :ios, "9.0" #平台及支持的最低版本
s.frameworks = "UIKit", "Foundation" #支持的框架
# s.dependency = "AFNetworking" # 依赖库
# User
s.author = { "xueyong" => "794334810@qq.com" } # 作者信息
s.social_media_url = "https://github.com/xuxueyong" # 个人主页
end
验证 本地的.podspec 文件是否正确
异常情况 如果使用swift 语言的时候, 可能会出现
[!] BYPhoneNumTF 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.
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run:
`echo "2.3" > .swift-version`.
You can use the `--no-clean` option to inspect any issue.
从异常信息可以看出, 我们需要使用 --allow-warnings 参数
pod lib lint --allow-warnings
给仓库打上标签
在打标签之前 先提交我们刚才创建的那些文件到远程仓库
git add .
git commit -m '测试公有库创建'
git push
// 初次提交代码, 是需要登录的
Username for 'https://github.com': 794334810@qq.com
Password for 'https://794334810@qq.com@github.com':
给仓库打上标签 也就是之前看到的版本号
仓库版本号 要与.podspec 文件中的 s.version = '1.0.0' 相对应
// 打标签
git tag -a '1.0.0' -m '仓库打标签'
-a 表示添加标签 -m 表示 注释信息 comment
// 推送到远程仓库
git push origin --tags
提示 * [new tag] 1.0.0 -> 1.0.0 说明推送成功
发布 .podspec文件
将code.podspec文件发布到公有spec上
在终端执行命令
pod trunk push code.podspec
提示错误信息
You (794334810@qq.com) are not allowed to push new versions for this pod. The owners of this pod are 1069156011@qq.com.
说明公有库的拥有者有错
移除公有库的拥有者 pod trunk remove-owner code.pospec 1069156011@qq.com
发生了那些操作:
- Updating spec repo
master - 将 .podspec 文件转成 JSON 格式
- 对 master 仓库 进行合并 ,再次提交master仓库
产生异常信息 {"name"=>["is already taken"]}
说明这个名字 已经被别人使用了
将名字改为 yongTestCocoaPodsShare
提交成功后
https://cocoapods.org/pods/yongTestCocoaPodsShare
说明发布成功 可以通过上面的URL查看
更新 pods
在终端执行 pod setup
pod search yongTestCocoaPodsShare
出现异常 Unable to find a pod with name, author, summary, or description matching yongTestCocoaPodsShare
估计是更新不及时
在 https://github.com/CocoaPods/Specs/commits/master
因为在这里可以看到提交记录
使用
新建立一个项目
在 Podfie 文件中使用 pod 'yongTestCocoaPodsShare', '1.0.2'
报异常信息 [!] CocoaPods could not find compatible versions for pod "yongTestCocoaPodsShare":
In Podfile:
yongTestCocoaPodsShare (= 1.0.2)
Specs satisfying the yongTestCocoaPodsShare (= 1.0.2) dependency were found, but they required a higher minimum deployment target.
解决方法
pod setup
如果还是异常
执行 删除缓存操作 rm -fr ~/.cocoapods/repos/master
再次执行 pod setup
更新维护
- 修改 代码
- 修改 .podspec 文件
- 打标签
- 推送到 pods 远程库
