配置自己GitHub的开源项目,使用CocoaPods让其支持pod

整个流程,包括Github创建项目、上传项目,到最后的支持Cocoapods。
步骤如下:

  • GitHub创建存储库,上传代码,并且克隆项目到本地
  • 注册CocoaPods账号
  • 创建podspec文件,配置podspec文件信息,并且验证
  • 在Github上创建项目release版本
  • 上传代码到CocoaPods
  • 错误信息s.source_files解决办法

一、GitHub创建存储库,上传代码,并且克隆项目到本地

  • 打开github.com,然后创建自己的项目工程:
    image.png
image.png
  • 通过终端命令或者github客户端将项目 clone 到本地
    并且把需要支持pod的文件或者demo放到里面,文件夹如下图所示:
    image.png

JYWKWebViewDemo是示例demo,JYWKWebView就是提供给他人使用的库,然后提交同步到Github。

二、 注册CocoaPods账号

  • 终端输入
// pod trunk register 邮箱地址 '用户名' --description='描述信息'
pod trunk register 505340739@qq.com 'zjy'  --description '创建CocoaPods'
  • 然后打开邮件中的链接, 这样就成功注册了Cocoapods账号。


    image.png
  • 检查是否创建成功,如下图表示创建成功

pod trunk me
image.png

三、 创建podspec文件,配置podspec文件信息,并且验证

  • 打开终端,cd到项目文件夹下
  • 创建.podspec
// JYWebView为你需要支持pod的库名,文件名
pod spec create JYWebView
  • 编辑.podspec文件
    项目文件夹下可用Xcode方式打开,建议里面内容全部删除,将需要配置的信息进行 copy,然后修改。
Pod::Spec.new do |s|
s.name         = "JYWKWebView"
s.version      = "1.0.0"
s.summary      = "WKWebView简单封装"
s.ios.deployment_target = '9.0'
s.homepage     = "https://github.com/CoderJYZhu/JYWKWebView"
s.license      = { :type => "MIT", :file => "LICENSE" }
s.author       = { "某天" => "505340739@qq.com" }
s.source       = { :git => "https://github.com/CoderJYZhu/JYWKWebView.git", :tag => s.version }
s.source_files = "JYWKWebView/*.{h,m}"
s.requires_arc = true
end

下面列出常用配置信息:
s.name:名称,pod search 搜索的关键词,注意这里一定要和.podspec的名称一样,否则报错
s.version:版本号
s.ios.deployment_target:支持的pod最低版本
s.summary: 简介
s.homepage:项目主页地址
s.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:依赖库,如有多个可以这样写
更多配置信息可以自行百度。
附上官网链接:specs-and-specs-repo
关于资源文件更详细的写法,可以看这篇文章:给 Pod 添加资源文件

source_files:写法及含义建议大家写第一种或者第二种

"JYWebView/*
""JYWebView/JYWebView/*.{h,m}"
"JYWebView/**/*.h"

“*” 表示匹配所有文件
“*.{h,m}” 表示匹配所有以.h和.m结尾的文件
“**” 表示匹配所有子目录
  • 验证.podspec文件是否合法
pod lib lint    

下图表示验证通过:


image.png

四、在Github上创建项目release版本

一般也叫做打Tag步骤,可以用命令行操作

image.png

image.png
image.png

点击Publish release即可。创建完成后如图所示:

image.png

五、上传代码到CocoaPods

  • 终端cd到项目文件夹下,首先检查文件有效性
pod spec lint

通过验证:


image.png
  • 上传到CocoaPods
// pod trunk push xxx.podspec —allow-warnings (验证有警告可以使用 —allow-warnings忽略)
pod trunk push JYWKWebView.podspec --allow-warnings
image.png
  • 验证是否上传成功
// 使用pod search XXX搜索
pod search JYWKWebView
image.png
  • 如果搜索不到出现下图问题:


    image.png
  1. 执行pod setup其实在你安装CocoaPods执行pod install时,系统会默认操作pod setup,然而由于中国强大的墙可能会pod setup不成功。这时就需要手动执行pod setup指令,如下:
    终端输入:pod setup
    会出现Setting up CocoaPods master repo,稍等几十秒,最底下会输出Setup completed。说明执行pod setup成功。
    如果pod search操作还是搜索失败,如下:
    终端输入:pod search JYWKWebView

  2. 删除~/Library/Caches/CocoaPods目录下的search_index.json文件
    pod setup成功后,依然不能pod search,是因为之前你执行pod search生成了search_index.json,此时需要删掉。
    终端输入:rm ~/Library/Caches/CocoaPods/search_index.json
    删除成功后,再执行pod search。
    执行pod search
    终端输入:pod search JYWKWebView(不区分大小写)
    输出:Creating search index for spec repo ‘master’.. Done!,稍等片刻······就会出现所有带有afnetworking字段的类库。

六、错误信息s.source_files解决办法

验证.podspec文件是否合法过程中遇到过一个问题就是:

image.png

s.source_files  = 'Classes/*.{h,m}'
s.source_files  = 'Classes/DropDownMenu.{h,m}'
s.source_files  = 'Classes'
s.source_files  = 'Classes/**/*.{h,m}'

然后就是无休止的修改s.source_files,上面这几种路径格式我都试过了,也确认路径层次没有问题但是验证就是通不过,还是上图的错误。不知道是不是bug。然后在网上看到别人的路径设置,也跟着试了下,针对我的项目结构,先把s.source_files路径设置为:

s.source_files = "JYWKWebView/JYWKWebView.h"

然后就莫名的验证成功了,并且后续也上传CocoaPods成功了!但是这样上传的项目在后续pod下载的时候只有JYWKWebView.h这一个文件。所以还得重新修改上传。
之后再回头将s.source_files修改回来,将release版本升级为1.0.1、然后在上传CocoaPods:

s.source_files = "JYWKWebView/*.{h,m}"

并且也上传成功了,到这就大功告成了。至于原因没搞清楚,反正就是成功了。

参考文章:
https://www.cnblogs.com/lurenq/p/6785781.html
https://www.cnblogs.com/weiming4219/p/7699699.html
https://blog.csdn.net/conglin1991/article/details/55096422

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