- git 安装教程:https://git-scm.com/book/zh/v1/起步-安装-Git
- cocoapods 安装教程:https://www.jianshu.com/p/1c52087e6f9c
这里就不对git 和 cocoapods安装进行过多的讲解,自己可以尝试安装。如果git和cocoapods都已经安装完成,接下来进入正题:
一、新建代码仓库
-
进入github官网 https://github.com,新建respository。注意:仓库的名字一定不能和已有的仓库名称冲突,最好加上前缀。
如下图所示:
在本地新建一个ToolTest文件夹, 把新建的git仓库克隆到ToolTest文件夹中,代码如下:
打开terminal, cd到ToolTest文件夹下,执行下面命令
git clone URL 这里的URL就是新建仓库的clone地址
如下图所示:
-
clone成功后,会存在两个隐藏文件:.git, .gitignore文件。显示/关闭隐藏文件 的快捷键: command+shift+.
二、上传文件到刚刚新建的MCTools仓库
-
MCTools文件加下,也就是仓库的位置,增加你要传到git仓库的文件,一定保证其正确性,否则后面的校验会失败。下面是我增加的文件:
把新增加的文件提交到git仓库,cd到MCTools文件夹下, 执行如下命令:
1. git add . 添加当前文件夹下的所有文件到git仓库缓存区
2. git status 显示代码状态
3. git commit -m '注释' 提交代码加注释, 提交到本地git仓库
4. git log 看本地git仓库的提交记录
5. git push origin master 推送到远程master分支
- 提交成功后,刷新下git仓库,就可以看见咱们刚才上传的文件,这个时候打一个0.0.1的tag, 等配置spec文件使用。
git tag -a '0.0.1' -m '新增0.0.1tag' 在本地仓库增加0.0.1tag。
git push --tags 提交tag到远程仓库。
- 如果对git操作不熟悉的,可以看看这个教程, 讲解的非常详细。https://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000
三、配置.podspec文件
- 在MCTools目录下,新建.podspec文件, 注意spec的名字必须和远程仓库的名字保持一致,我这里就是MCTools。
pod spec create MCTools
- 创建成功后,打开spec文件,进行修改。下面是我修改完成的:
Pod::Spec.new do |s|
s.name = "MCTools" //名称
s.version = "0.0.1" //版本号,也是tag
s.summary = "MCTools summary" //Tools 的总结
s.description = <<-DESC
MCTools的描述,一些介绍。
DESC //这里的描述,必须比s.summary的长度要长。
s.homepage = "https://github.com/muchangqing/MCTools" //远程仓库的首页地址
s.license = "MIT" //MIT
s.author = { "mcq" => "845891612@qq.com" } //作者,邮箱
s.platform = :ios, "5.0"
s.source = { :git => "https://github.com/muchangqing/MCTools.git", :tag => s.version } //git => 远程仓库的clone地址, tag取版本号就行
s.requires_arc = true //ARC
s.source_files = "Classes", "Classes/**/*.{h,m}" //包含文件,Classes文件下的所有.h.m
# s.resource = "Classes/<name>.xib" //注意:如果你的代码里包含xib文件,xib属于资源文件,需要resource引入。
end
- 对MCTools.podspec文件进行校验
pod lib lint MCTools
注: 校验的过程中,出现问题的汇总:https://www.jianshu.com/p/283584683b0b
- 本地校验成功后,上传到远程仓库。
git add .
git commit -m '增加Tools.podspec文件'
git push origin master
四、注册cocoapods trunk, 并上传MCTools.podsepc文件到git的cocoapods/Specs公开仓库。
pod trunk register [EMAIL] [USERNAME] //邮箱,名称
pod trunk register 845891612@qq.com 'mcq'
-
进入自己的邮箱,确认邮件, 看到如下图代表注册成功了。
- 上传MCTools.podspec文件到git的Specs仓库
pod trunk push MCTools.podspec
四、搜索并使用MCTools
- 终端上搜索 MCTools,这个时候是搜索不到的。
pod search MCTools
- 需要删除 : 资源库->Caches->CocoaPods中的search_index(索引文件),然后在终端pod search MCTools,这个等待时间比较久,因为需要重新生成索引文件。
大功告成..,你可以新建个项目进行pod install 了。
五、出现的问题汇总
这个问题主要是由于在写spec文件的时候,没有加载xib文件,因为xib文件属于资源文件,需要增加如下:
s.resource = "Classes/<name>.xib" //注意:如果你的代码里包含xib文件,xib属于资源文件,需要resource引入。
有任何问题欢迎指出,我及时更正。