如何创建你的第一个podspec文件以及填补各种坑

这是我第一次写文章,正是刚刚创建成功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  你会发现终于成功了  

那么就赶紧跟小伙伴分享你的经验吧  

第一次写文 ,多谢支持啦





最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,590评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,808评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,151评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,779评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,773评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,656评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,022评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,678评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,038评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,756评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,411评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,005评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,973评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,053评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,495评论 2 343

推荐阅读更多精彩内容