【iOS】制作Cocoapods库

注册trunk

终端执行以下命令,这里的作者名和podspec中设置的s.author保持一致

$ pod trunk register 邮箱 '作者名称’  

收到邮件并确认之后再执行以下命令

$ pod trunk me

创建一个pod库

如果当前已经存在一个 project,创建pod也非常简单:

$ pod spec create PodName

随后编辑podspec文件并执行

$ pod spec lint PodName.podspec

然而创建并配置工程这种费力的活交给 cocoapods 会更好。
所以我们这里使用 pod lib create PodName 去创建一个pod,过程如下:

$ pod lib create YDDemoSDK
  Cloning `https://github.com/CocoaPods/pod-template.git` into `YDDemoSDK`.
  Configuring YDDemoSDK template.

------------------------------

To get you started we need to ask a few questions, this should only take a minute.

If this is your first time we recommend running through with the guide: 
 - https://guides.cocoapods.org/making/using-pod-lib-create.html
 ( hold cmd and double click links to open in a browser. )


What platform do you want to use?? [ iOS / macOS ]
 > iOS

What language do you want to use?? [ Swift / ObjC ]
 > Objc

 Would you like to include a demo application with your library? [ Yes / No ]
 > Yes

Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > None

Would you like to do view based testing? [ Yes / No ]
 > No

What is your class prefix?
 > YD

Running pod install on your new library.

Analyzing dependencies
Fetching podspec for `YDDemoSDK` from `../`
Downloading dependencies
Installing YDDemoSDK (0.1.0)
Generating Pods project
Integrating client project

[!] Please close any current Xcode sessions and use `YDDemoSDK.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

[!] Automatically assigning platform ios with version 9.3 on target YDDemoSDK_Example because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.

 Ace! you're ready to go!
 We will start you off by opening your project in Xcode
  open 'YDDemoSDK/Example/YDDemoSDK.xcworkspace'

To learn more about the template see `https://github.com/CocoaPods/pod-template.git`.
To learn more about creating a new pod, see `http://guides.cocoapods.org/making/making-a-cocoapod`.

替换代码

将Classes文件夹下的代码替换为自己将要发布的代码

编辑podspec

.podspec 文件描述了一个 pod 库的版本。它详细说明了这个 pod 库中源码应该从哪里取出、应用怎样的构建设置以及其他基本的信息,比如名称、版本、描述等。
podspec 文件的内容如下:

Pod::Spec.new do |s|
s.name          = 'YDDemoSDK' #项目名
s.version       = '0.0.1' #相应的版本号
s.summary       = 'A short description of YDDemoSDK.' #简述
s.description   = <<‐ DESC #详细描述
TODO: Add long description of the pod here.
DESC

s.homepage      = 'https://github.com/herody/YDDemoSDK' #项目主页
s.license       = { :type => 'MIT', :file => 'LICENSE' } #开源协议
s.author        = { 'herody' => '314622981@qq.com' } #作者
s.platform      = :ios, '8.0' #支持的平台
s.requires_arc  = true #arc和mrc选项
spec.compiler_flags = '-DOS_OBJECT_USE_OBJC=0', '-Wno-format'  #A list of flags which should be passed to the compiler.

s.libraries     = 'z', 'sqlite3' #表示依赖的系统类库,比如libz.dylib等
s.frameworks    = 'UIKit','AVFoundation' #表示依赖的系统framework
s.ios.vendored_frameworks = 'YDDemoSDK/Classes/YDKit.framework' # 依赖的第三方/自己的framework
s.vendored_libraries = 'YDDemoSDK/Classes/libWeChatSDK.a' #表示依赖第三方/自己的 .a 库
#依赖的第三方的或者自己的静态库文件必须以lib为前缀进行命名,否则会出现找不到的情况,这一点非常重要

s.preserve_paths = "IMPORTANT.txt","Frameworks/*.framework"  #Any file that should not be removed after being downloaded.

#平台信息
s.platform      = :ios, '7.0' 
s.ios.deployment_target = '7.0'

#文件配置项
s.source        = { :git => 'https://github.com/herody/YDDemoSDK.git', :tag => s.version.to_s }
#配置项目的目标路径,如果不是本地开发,pod init/update会从这个路去拉去代码

s.source_files = 'YDDemoSDK/Classes/**/*.{h,m}' #你的源码位置

#cocoapods 官方推荐使用 resource_bundles,因为 resources  指定的资源会被直接拷贝到目标应用中,
#因此不会被 Xcode 优化,在编译生成 product 时,与目标应用的图片资源以及其他同样使用 resources 的 Pod 的图片一起打包为一个 Assets.car 文件。
#这样全部混杂在一起,就使得资源文件容易产生命名冲突。而 resource_bundles 指定的资源,
#会被编译到独立的 bundle 中,bundle 名就是你的 pod 名,
#这样就很大程度上减小了资源名冲突问题,并且 Xcode 会对 bundle 进行优化。
#一个 bundle 包含一个 Assets.car,获取图片的时候要严格指定 bundle 的位置,
#很好的隔离了各个库或者一个库下的资源文件。
#s.resources     = ['YDDemoSDK/Assets/*.png'] #资源,比如图片,音频文件,xib等资源
s.resource_bundles = {
    'MapBox' => ['MapView/Map/Resources/*.png'],
    'OtherResources' => ['MapView/Map/OtherResources/*.png']
  }
s.public_header_files = 'YDDemoSDK/Classes/YDDemoSDK.h'   #需要对外开放的头文件

#依赖的项目内容 可以多个
s.dependency 'YYModel'
s.dependency 'AFNetworking' '2.3'
#s.static_framework = true
end

项目调试

进入Example目录,执行

$ pod install

随后运行项目,保证项目正确性

进行本地校验

推送之前,先在本地进行校验

$ pod lib lint PodName.podspec

如果使用了其他私有库,需要指定其他私有库的仓库地址和公有库仓库的地址

$ pod lib lint PodName.podspec --verbose --sources='私有库地址,https://github.com/CocoaPods/Specs.git'

将代码push到远程仓库

在github上创建远程仓库,并将本地代码推送到远程仓库

$ git status -- 查看当前git存了什么文件
$ git add . -- 将所有文件缓存到待提交文件区域
$ git commit -m "上传工程" -- 提交文件,写上备注
$ git remote add origin 远程仓库地址 -- 添加要推送的远程仓库地址
$ git push -u origin master -- 将代码推送到远程仓库的master分支

为项目打标签

这时候直接进行远程校验会报错,需要先为项目打标签

$ git tag "0.0.1"
$ git push --tags

远程校验

打完标签之后,再进行远程校验,远程校验与本地校验几乎一致,命令如下

$ pod spec lint PodName.podspec

上传spec

$ pod trunk push PodName.podspec --allow-warnings

最后验证

终端执行以下命令进行搜索

$ pod search PodName

如果没有搜索到,就删除本地索引库,再进行尝试

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