制作自己的带有Example工程的CocoaPods

一、创建github仓库

步骤1 创建新仓库

15547098780565.jpg

这里我们设置仓库为公开的。

步骤2 新建一个文件夹,将我们刚才在github上创建的库clone下来

git clone https://github.com/Shaw003/PrivatePodDemo.git

可以看到如下的目录结构


15546889925231.jpg

步骤3 创建Pod本地库。

#该命令会从github上CocoaPods的库中下载一个pod模版
#这里笔者创建了一个名为PrivatePodDemo的Pod库
pod lib create PrivatePodDemo
#之后终端会询问你几个问题,默认左侧选项,选择默认可直接回车
#选择运行平台,笔者这里选择了iOS
What platform do you want to use?? [ iOS / macOS ]
 > 
ios
#选择语言,笔者这里选择了Swift
What language do you want to use?? [ Swift / ObjC ]
 > 
swift
#你希望创建一个带有示例工程的库么?笔者这里选择是
Would you like to include a demo application with your library? [ Yes / No ]
 > 
yes
#使用测试框架么?笔者这里选择否
Which testing frameworks will you use? [ Quick / None ]
 > none
#是否要进行基于视图的测试,其实具体含义我也不太清楚,笔者这里选择否
Would you like to do view based testing? [ Yes / No ]
 > no

之后终端会自动打开你的Example工程,可以看到文件目录结构如下所示:


15546892403075.jpg

最外层的<PrivatePodDemo>就是步骤2从github上clone下来的文件夹,<PrivatePodDemo/PrivatePodDemo>是步骤3输入的名称

步骤4 编辑PrivatePodDemo.podspec文件

内容如下所示:

Pod::Spec.new do |s|
  s.name             = 'PrivatePodDemo'
  s.version          = '0.1.0'
  s.summary          = 'A short description of PrivatePodDemo.'

# This description is used to generate tags and improve search results.
#   * Think: What does it do? Why did you write it? What is the focus?
#   * Try to keep it short, snappy and to the point.
#   * Write the description between the DESC delimiters below.
#   * Finally, don't worry about the indent, CocoaPods strips it!

  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  s.homepage         = 'https://github.com/Shaw003/PrivatePodDemo'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'Shaw' => 'shawtun1211@163.com' }
  s.source           = { :git => 'https://github.com/Shaw003/PrivatePodDemo.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://www.jianshu.com/u/596fa2382f62'
  # 如果需要设置语言版本的话可以这样做
  s.swift_version = '4.2'
  s.ios.deployment_target = '8.0'

  s.source_files = 'PrivatePodDemo/Classes/**/*'
  
  # s.resource_bundles = {
  #   'PrivatePodDemo' => ['PrivatePodDemo/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
  s.dependency 'Alamofire'
  s.dependency 'WCDB.swift', '1.0.7.5'
end

以上按照自己的情况修改即可,值得注意的是两个地方,

关注点1: s.dependency

如果你开发的库引用到了别的第三方库,可以使用s.dependency字段来写你引用了哪些三方库,值得注意的是,如果引用了多个,需要写多个s.dependency,举例:

  s.dependency 'Alamofire'
  s.dependency 'WCDB.swift'

关注点2: s.source_files

这里它默认写的路径是PrivatePodDemo/Classes/**/*,我们可以打开对应的文件夹,发现默认有一个Replace.swift的文件,这样给人的理解是,我们可以将希望通过Pod分享出去的源代码放到<PrivatePodDemo/PrivatePodDemo/PrivatePodDemo/Classes>文件夹下,当我们对这里的源代码有任何修改的时候,都需要先设置工作路径为包含Podfile文件的目录,然后执行pod install命令。

首先我们找到并删除掉Classes文件夹中的Replace.swift,以我们自己的代码对其进行替换,替换后的目录结构如下所示,

15546902220665.jpg

这里我们尝试删除掉Replace.swift文件,并将你的工程代码文件拖入到这里,这时候我们可以执行pod install

// 这里我们发现`Podfile`文件在`Example`文件夹中
cd PrivatePodDemo/PrivatePodDemo/Example
文件
pod install

执行完毕后,我们可以看到,在Xcode中,目录结构已变成如下所示,


15546904522536.jpg

我们对工程进行编译一下,发现没有报错,编译通过。

步骤5 提交git

操作1 提交到本地仓库
git add -A
git commit -m "commit code"

在尝试提交git时时会报一个错误,


15546906498061.jpg

原因是因为创建pod lib时已经包括了.git文件了,此时需要终端切换工作路径到<PrivatePodDemo/PrivatePodDemo>

cd PrivatePodDemo/
ls -a
15546907455017.jpg
操作2 删除.git文件

此时只需要删除.git文件即可,执行如下命令:

rm -rf .git

删除后,我们再尝试添加到本地仓库,执行命令

操作3 提交到远端
git commit -m "commit code"
git push

提交后我们发现只提交了一个PrivatePodDemo的空文件夹,里面什么都没有,这时候我们可以删除远端刚才的提交,重新提交一次

操作4 删除远端提交
git rm -r --cached PrivatePodDemo
git commit -m "删除错误提交"
git push

删除完成后我们重复操作1,再次提交就可以了。

步骤6 创建git tag

此处创建的tag需要和podspec文件中s.version字段保持一致,这里我们写0.1.0

git tag 0.1.0
git push --tags

二、 上传Pod

步骤1 验证pod

执行如下命令进行验证

pod spec lint

等了一会,发现验证不通过,原因有一个错误和几个警告,我们看下错误信息

- ERROR | [iOS] file patterns: The `source_files` pattern did not match any file.

这时,我们可以对PrivatePodDemo.podspec文件进行如下修改

s.source_files = 'PrivatePodDemo/PrivatePodDemo/Classes/**/*'

再次执行验证,我们可以忽略警告

pod spec lint --allow-warnings

这次验证结果

PrivatePodDemo.podspec passed validation.

验证通过了,这时你可能会问,那刚才第一次在编辑s.source_files字段时为什么不直接写成最后一次修改这样呢?具体原因我还不太清楚,不过经过我测试发现,source_files两种写法,
写法1:PrivatePodDemo/Classes/**/*
写法2:PrivatePodDemo/PrivatePodDemo/Classes/**/*

如果采用 写法1 在执行pod install命令时,可以正常获取保存在Classes文件夹中的代码;当执行pod spec lint命令时却由于没找打源码文件而未能验证通过。
如果采用 写法2 则在执行pod install命令时,无法正常获取到保存在Classes文件夹中的代码,而执行pod spec lint命令时却能验证通过。
因此,笔者采用了先用 写法1 提交到github的仓库,再修改为 写法2 去进行验证的方式。

步骤2 上传Pod

由于之前我们创建的这个示例工程的名字不太好,和线上的有冲突了,我们这里修改.podspec文件名为PrivatePodDemo001.podspec,同时,调整文件内的s.name = 'PrivatePodDemo001'
接下来执行命令

pod trunk push PrivatePodDemo001.podspec --allow-warnings

等待一会,出现如下内容,说明上传成功了


15547083693595.jpg

步骤3 搜索Pod

直接输入如下指令

pod search PrivatePodDemo001

报错了,提示如下:

[!] Unable to find a pod with name, author, summary, or description matching `PrivatePodDemo001`

这时我们可以尝试重新设置一下pod的索引

rm ~/Library/Caches/CocoaPods/search_index.json
pod setup

之后再执行一下搜索就可以搜到了。


15547088234370.jpg

三、 示例工程验证

步骤1 新建一个工程

使用pod 'PrivatePodDemo001'可以将需要的源码下载下来。

15547092987659.jpg

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

推荐阅读更多精彩内容