这是我第一次写文章,正是刚刚创建成功podspec文件,也确实遇到甚多坑也查了很多资料都比较零碎,所以想写下这次经历好好整理一下。OK ,这两天因为工作的原因,需要将工作的某个版块业务整理个framework以便项目后期其他项目方便使用,于是乎想何不搞个pod文件呢,好吧 来开始创建我们的第一个podspec文件吧。
首先呢我们要在github上创建我们的项目名称,你可以直接在github上创建然后在本地上传 你也可以直接通过github客户端直接上传,二者的区别是前者在创建的时候直接可以通过选择创建LICENSE,README等文件,后者的需要你长传文件后然后在手动创建文件. 我就不再这里陈述了网上太多,现在开始我们今天主要的任务。
首先先做好准备工作 注册 trunk CocoaPod官网 按照提示在终端输入
其中 :orta@cocoapods.org --->输入一个准确的邮箱
Orta Therox ----->输入一个用户名
macbook air ------>一个详情介绍
注册成功后会提示你注册成功 然后回收一封邮件 点击验证即可 然后输入 $ pod trunk me 来查看信息。
这里插播一个坑,当你一直没有收到邮件时试试更换一下cocoapods镜像地址(淘宝的Ruby镜像已经不更新了)
$gem sources -attp://rubygems-china.oss.aliyuncs.com
https://gems.ruby-china.org这个是ruby的官方源
http://rubygems-china.oss.aliyuncs.com阿里云源
这里有几个 你们可以试试 后面我再总结一些坑 及解决办法
假使以上准备工作都成功了下面就开始了创建spec文件了
1)在终端 cd 你的本地项目 然后终端输入 $ pod spec create iOS_Project(你的项目名称)
2)用Xcode 打开.podspec文件
接下来讲解一下每行代码的含义
s.name:名称,pod search 搜索的关键词,注意这里一定要和.podspec的名称一样,否则报错
s.version:版本号
s.ios.deployment_target:支持的pod最低版本
s.summary: 简介
s.homepage:项目主页地址
s.license:许可证(这里就是那个LICENSE文件 需要的)
s.author:作者
s.social_media_url:社交网址,这里我写的微博默认是Twitter,如果你写Twitter的话,你的podspec发布成功后会@你
s.source:项目的地址
s.source_files:需要包含的源文件)
s.resources: 资源文件
s.requires_arc: 是否支持ARC
s.dependency:依赖库,不能依赖未发布的库
s.dependency:依赖库,如有多个可以这样写
根据自己的需要更改文件内容,前面有#的为注释
3)以上都更改完了 记得上传到github同步然后下面让我们来验证podspec文件是否验证通过不允许有任何的Warning或者Error
输入命令:$ pod lib lint
如果出现 --> iOS_PriOSoject(你的项目)(0.0.1)
iOS_PriOSoject(你的项目)passsed validation
则验证通过 否则根据提示修改podspec文件再次验证直到通过 如果出现Error但是提示信息不足,可以添加$ pod lib lint --verbose以获取更多错误信息
4)podspec文件中需要指定的tag, 完成上述操作后给项目打tag
然后 输入 pod trunk iOS_Project.podspec 这个过程可能耗时
5)如果一切顺利 pod search iOS_progect 就可以看到你的项目信息 还有安装指令
现在来总结你在这个过程中会遇到的坑:
1)在注册 trun失败时 请查看自己的ruby版本 $ ruby -v
假如记得ruby 版本是最新 2.4.1,但是提示你 load error cannot load such file -- openssl 找不到 2.3.0 的xxxxxxx等等
这就是说明在安装最新版本时候有些文件没有解压成功或者没有完全安装上 这时候最好的办法就是重新安装对应版本 比如 2.3.0
安装 ruby
1) 安装 RVM: $ curl -L https://get.rvm.io | bash -s stable 期间可能需要输入密码 等待一段时间就好
2)载入 rvm :$ source ~/.rvm/scripts/rvm
3)检查是否安装好 输入:$ rvm -v
4) 安装ruby 并列出 已知版本 $ rvm list known
5)选择版本进行安装 例如 :$ rvm install 2.0.0 等待下载(途中需要按回车确定安装路径、还要输入密码)、编译。完成之后Ruby、Ruby Gems就安装好了
查询已安装的ruby
$ rvm list
卸载已安装的版本(若已经安装过ruby)
$ rvm remove [版本号]
4.设置Ruby版本
$ rvm 2.0.0 --default
检查是否安装好了
$ rvm -v $ gem -v
如果不成功 说明被墙了 重新更换 gem 镜像源 ,一切成功后 再次重新注册 trunk 会提示你注册成功 让你点击邮箱验证
上传 pod trunk push podspec 文件时 基本错误根据提示改后 仍 提示
[iOS] file patterns: The `source_files` pattern did not match any file.
这说明你的podspec 里s.sources_files 设置错误,要重新更改好 并上传github ,大概是这几个
s.source_files='Classes/*.{h,m}'
s.source_files='Classes/DropDownMenu.{h,m}'
s.source_files='Classes'
s.source_files='Classes/**/*.{h,m}'
路径一定不要错
这里有个别人遇到的坑 也可以看看创建仓库踩过的坑
6)加如以上都没问题了 也上传成功了 当你在终端想查看是否有这个文件时输入:pod search iOS_Project 时 WHF居然没有 还给你报个错
CocoaPod [!] Unable to find a pod with name, author, summary, or description matching `AFNetworking`
是不是很调皮 ,你要淡定 首先 1)rm ~/Library/Caches/CocoaPods/search_index.json 再试试
2)如果还不行 输入:pod setup 看看提示什么 如果是
cocoapods was not able to update the 'master' repo.if it is a unexpected issue and persists you can inspect it running 'pod repo update --verbose'
1):按照提示 输一遍:pod repo update --verbose 在pod setup试试
2)如果还不行 输入:gem uninstall cocoapods 在安装 gem install cocoapods
3)还不行sudo rm -fr ~/.cocoapods/repos/master 然后在 pod setup
4)如果还不行,那就来个狠点的 先删除全局的缓存
$ sudo rm-fr ~/Library/Caches/CocoaPods/
$ sudo rm-fr ~/.cocoapods/repos/master/
还不行的话就把当前 Pods 目录清空:
$ sudo rm-fr Pods/
//再执行
$ sudo gem install cocoapods
$ pod setup 看看还有没有报错
此时应该没问题 会重新setup master
这个过程可能会有点时间 等等就好 直到安装成功
最后 终端 输入 pod search iOS_Project 你会发现终于成功了
那么就赶紧跟小伙伴分享你的经验吧
第一次写文 ,多谢支持啦