【cocoapods】基础 私有库 : 创建、使用、更新、集成第三方库

cocoapods 私有库 : 创建、使用、更新 ; 技术有先后,一起学习 !

一、 制作私有库

创建自己的私有库仓库

a: 找一个可以存放仓库索引的库 ,一般可以用github、gitlab、码云等,我用的是github,创建过程不赘述,假如我创建的私有库名字是 mySpecPod 地址https://github.com/name/mySpecRepo.git ,注意尽量是空的空,先不要存放其他东西;

b: 创建自己的私有库

pod repo add mySpecPod https://github.com/name/mySpecRepo.git
以上的指令是 创建一个仓库 名字是 mySpecPod 地址: https://github.com/name/mySpecRepo.git 执行完后 在 ~/.cocoapods/repos 目录下会存在我们的私有库分支 mySpecPod ,master是cocoapods 默认的分支;

c: 创建一个存在代码的仓库,这里我还是选择是 github ,注意之前我以为这个仓库a步骤的仓库是同一个,走了弯路,实际a是存在仓库索引的库,本步骤才是存在我们代码的位置,

成功后clone到本地,假如我的仓库地址是:https://github.com/name/myTestPodProject.git

d: 将自己的代码提交到 https://github.com/name/myTestPodProject.git , 并打tag,这一步主要是打tag,在下一步的 .specpod 文件中 version的值就是根据你的tag去索引的;

git tag 1.0.0 ; git push --tags ;

e: 制作索引文件,进入我们clone 的项目的根目录,执行以下的指令

pod spec create SpecPodSDK
执行完成后在项目根目录会生成 SpecPodSDK.podspec 文件,关于这个文件非常重要,最终cocoapods 将根据它的配置来将私有库的内容加载到宿主工程: 以下给出相关的解释,可能刚创建成功会有很多英文的注释,下面的是我自己注释的:

Pod::Spec.new do |spec|

# �����私有库名字
  spec.name         = "SpecPodSDK"

# �����版本号,要跟链接代码库的最新的tag 一致;
  spec.version      = "1.0.0"

# 搜索关键字 ����
  spec.summary      = "SpecPodSDK"

# �����pod私有库描述
  spec.description  = "SpecPodSDK�xxx@gmail.com"

# 代码仓库主页
  spec.homepage     = "https://github.com/name/myTestPodProject"

# LICENSE
  spec.license      = "MIT"

# ��作者信息
  spec.author       = { "xxxx" => "xxx@gmail.com" }

# ��平台部署:iOS ���� ������
  spec.platform              = :ios
  spec.ios.deployment_target = '9.0'

# 仓库引用����
  spec.source        = { :git => "https://github.com/name/myTestPodProject.git", :tag => "#{spec.version}" }

# �引用的源代码文件,非常重要,里面的路径要相对的.specpod文件定位
  spec.source_files  = "SpecPodSDK/libs/*.{h,m}"

# 设置自动引用计数
  spec.requires_arc = true

# 引用的系统Frameworks库
# spec.framework = "UIKit"
spec.framework = "Foundation"

# 引用的自定义Frameworks库
 spec.vendored_frameworks = "/xxx/xxx.framework"

# 依赖的系统lib库,假如你有依赖libsqlite3.tdb 库,可以省略lib前缀,.tdb 后缀
  spec.libraries = 'sqlite3'

# �依赖自定义lib库,假如你有依赖的自定义的.a文件
  # spec.vendored_libraries = 'SpecPodSDK/libs/libRobotPenSDK.a'

end

为了更好的集成使用,这里还是总结下所有的吧

name:框架名
version:当前版本(注意,是当前版本,假如你后续更新了新版本,需要修改此处)
summary:简要描述,在pod search ZCPKit的时候会显示该信息 ,每一个版本的主要功能。
description:详细描述
homepage:代码私有库的https地址
license:开源协议 MIT 不用修改啦
author:作者
source:源码git地址
platform:支持最低ios版本
source_files:源文件(可以包含.h和.m)
public_header_files:头文件(.h文件)
resources:资源文件(配置的文件都会被放到mainBundle中)
resource_bundles:资源文件(配置的文件会放到你自己指定的bundle中)
frameworks:依赖的系统框架
vendored_frameworks:依赖的非系统框架
libraries:依赖的系统库
vendored_libraries:依赖的非系统的静态库
dependency:依赖的三方库

以上知识冰山一角的配置,关于多个库的依赖其实最难的,举一反三,这里制作入门介绍,有兴趣自己探究;

e: 检验.specpod 文件是否合理

pod lib lint --allow-warnings --verbose
--verbose: 可以查看具体的日志 ;
--allow-warnings : 允许有日志 ;
还有很多相关配置 ,
如果输出: 代表成功

TALRobotPencilSDK passed validation.

常见的失败: a 、代码仓库地址不正确 b、 source_file 目录不对 c、指定的部署iOS版本,这个在你pod install 如果跟你项目的ios 不兼容就会报错 等等

f : 将私有库代码代码推到远程私有索引库

pod repo push mySpecPod SpecPodSDK.podspec--allow-warnings
a、mySpecPod 是我们在b创建的自己的私有索引库 b、SpecPodSDK.specpod 配置的对外使用的代码仓库的索引信息 ;
常见的错误是 mySpecPod库可能初始化错误,在执行此命令之前保证有一个初始化文件存在,比如readme文件;

h: 验证我们的私有库

pod search SpecPodSDK
如果找不到根据具体的报错信息寻找解决方法;

i: install 私有库

a、 配置podfile 文件

# 非常关键: 这是我们私有库索引的仓库地址
source 'https://github.com/name/mySpecRepo.git'

# 1. 注意一定要把注释打开 2. 和自由库的部署版本一定要兼容
 platform :ios, '9.0'

target 'myTestPodProject' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!
  inhibit_all_warnings!


  # Pods for TALRobotPencil-YHZZ
  pod 'SpecPodSDK', '~> 1.0.0'

end


这里最关键可能忘记添加私有库索引仓库的地址,我就是

到此制作私有库的步骤就完啦

更新私有库

a: 在代码仓库里将私改的内容提交

b: 制作tag 1.1.0

git tag 1.1.0 ; git push --tags

c: 修改本地specpod文件 ,注意非常关键 除了配置你修改的部分(添加新的文件、库、info 配置) 最重要是设置version 要跟b步骤tag 一致

d: 验证 pod lib

pod lib lint --allow-warnings --verbose
除了错误,十有八九是source 、库、tag 、.a文件 不对 ,根据提示修改即可

e: 将 specpod 推到自己的私有库

pod repo push mySpecPod SpecPodSDK.specpod --allow-warnings

f: e步骤完毕,你会发现在 ~/.cocoapods/repos/mySpecPod/SpecPodSDK 会有你打tag的文件夹 ,里面就是该版本的索引信息

后面的验证跟制作私有库的验证步骤一致: h步骤 到最后一步 。。。。

三、集成第三方库

正确的写法:

#dependency 跟其他的关键字还是有区别,我就是遇到这个坑,在dependency后面加上一个 = 号,导致总是失败,还有就是 dependency 没有 dependencies 字段 只有一个一个加
spec.dependency 'SDWebImage', '~> 5.0.6'
spec.dependency 'Masonry', '~> 1.1.0'

其他检测步骤和上传步骤跟之前一样

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

推荐阅读更多精彩内容