组件化之二 使用Cocoapods创建私有podspec

组件化之一 frameWork

前言

Cocoapods是非常好用的一个iOS依赖管理工具,使用它可以方便的管理和更新项目中所使用到的第三方库,以及将自己的项目中的公共组件交由它去管理。实际开发中,像组件化之一中讲的一样,大型项目中有很多公共化组件可以做成私有化库,独立于项目工程,减少耦合和维护成本

整体先说明一下创建一个私有的podspec包括如下那么几个步骤:

  1. 创建并设置一个私有的Spec Repo,事先创建好该私有的Spec Repo的仓库。
  2. 创建Pod所需要的项目工程文件,并且有可访问的项目版本控制地址。
  3. 创建Pod所对应的podspec文件。
  4. 本地测试配置好的podspec文件是否可用。
  5. 向私有的Spec Repo中提交podspec。
  6. 在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。
    更新维护podspec。

版本控制这里用git,个人没有私有账户,所以过程中创建的都是public项目

1、创建一个spec仓库,作为私有化Spec Repo的远端地址,先来说第一步,什么是Spec Repo?它是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端在GitHub上
屏幕快照 2017-05-11 下午8.01.57.png

创建私有化Spec Repo,进入.cocoaPods文件你会看到创建的结果

# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add WSPodTestSpec https://github.com/Anny-github/WSPodTestSpec.git
屏幕快照 2017-05-11 下午8.07.18.png

屏幕快照 2017-05-11 下午8.10.40.png
创建Pod工程

1、如果你已经有了一个git上的项目,就不用进行这一步了,如果没有,先cd到目标文件夹,再z执行pod lib create podTestLibrary
之后他会问你四个问题,1.是否需要一个例子工程;2.选择一个测试框架;3.是否基于View测试;4.类的前缀;4个问题的具体介绍可以去看官方文档,我这里选择的是1.yes;2.Specta/Expecta;3.yes;4.PTL。 问完这4个问题他会自动执行pod install命令创建项目并生成依赖。


屏幕快照 2017-05-11 下午8.25.20.png

以上是项目生成的目录结构及相关介绍。

2、完善项目文件
接下来就是向Pod文件夹中添加库文件和资源,并配置podspec文件,我把自己写的两个类放入Pod/Classes中,然后进入Example文件夹执行pod update命令,再打开项目工程可以看到,刚刚添加的组件已经在Pods子工程下Development Pods/LoadingViewLibrary中了


屏幕快照 2017-05-11 下午8.31.34.png

可以看到,pods中的LoadingViewLibrary的Classes中已经添加好了文件,现在要把修改push到远端,这个时候,我们发现还没有对应的git仓库,所以上面创建仓库一样,再创建一个pod文件的仓库,LoadingViewLibrary


屏幕快照 2017-05-12 上午9.18.21.png
如此一来,就可以把本地的LoadingViewLibrary推到远端了
git add .
git commit -m "initial Pod"
git remote add origin https://github.com/Anny-github/LoadingViewLibrary.git
git push origin master  //如果失败rejected,使用git push -f origin master 强制push

注:这里需要注意的是每当你向Pod中添加了新的文件或者以后更新了podspec的版本都需要重新执行一遍pod update命令。

因为podspec文件中获取Git版本控制的项目还需要tag号,所以我们要打上一个tag,并推送tag到远端。

git tag 0.0.1
git push --tags
修改并验证podspec文件

podspec文件将lib中用到的包括资源、源码、需要引用的framework,以及第三库等等组织起来,是我们创建私有Pod的重要文件

1、接下来开始编辑podspec文件了,它是一个Ruby的文件,把编辑器的格式改成Ruby就能看到语法高亮,下面我贴上我的podspec文件,并在后面以注释的形式说明每个字段的含义,没有涉及到的字段可以去官方文档查阅

Pod::Spec.new do |s|
  s.name             = 'LoadingViewLibrary'
  s.version          = '0.0.1'
  s.summary          = 'test for private pod.'
  s.description      = <<-DESC
       test private pod,this is a class used to loading view
                       DESC

  s.homepage         = 'https://baidu.com'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'Anny-github' => 'wenshanshan1991@163.con' }
  s.source           = { :git => 'https://github.com/Anny-github/LoadingViewLibrary.git', :tag => '0.0.1'}
  s.ios.deployment_target = '8.0'

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

  # s.resource_bundles = {
  #   'LoadingViewLibrary' => ['LoadingViewLibrary/Assets/*.png']
  # }

  s.public_header_files = 'LoadingViewLibrary/Classes/**/*.h'
  s.frameworks = 'UIKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end

2、编辑完podspec文件后,需要对其进行验证,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行一下命令,两个任选一个都可以

pod lib lint                    //不予许警告和错误
pod lib lint --allow-warnings   //允许警告

可能会遇到的问题,提示会将有错误的用>指出来,一般会有标点等格式错误,最重要的是s.source_files和source不能搞错


屏幕快照 2017-05-12 上午9.35.56.png

验证通过是这个样子的:


屏幕快照 2017-05-12 上午9.39.21.png
现在只能ssh说明个podspec符合验证,但是不一定能使用。
本地创建xcode工程TestPodSpec,测试创建的pod能否可用

1、创建Podfile文件,链接本地pod地址,可以通过Finder的前往,查看这个地址是否存在,能找到证明链接地址没错


屏幕快照 2017-05-12 上午9.44.30.png
platform :ios,'8.0'
target 'TestPodSpec' do
pod 'LoadingViewLibrary' , :podspec => '/Users/Hammer/Desktop/LoadingViewLibrary/LoadingViewLibrary.podspec'
inhibit_all_warnings!
end

2、保存好Podfile后,pod install,下面是成功了


屏幕快照 2017-05-12 上午9.48.25.png

打开TestPodSpec.xcworkspace,查看Pods目录下,是否install好了本地的私有库LoadingViewLibrary


屏幕快照 2017-05-12 上午9.48.09.png

看到上面,就证明安装成功,运行demo测试一下。
提交本地podspec到Specs仓库

向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。 向我们的私有Spec Repo提交podspec只需要一个命令

pod repo push  WSPodTestSpec LoadingViewLibrary.podspec

至此,我们的私有podspec已经创建完成,这个时候就可以像pod search AFNetworking一样,搜索自己的podspec库了,死不死挺过瘾😁


屏幕快照 2017-05-12 上午9.58.47.png
问题小结

1、执行pod lib create (组件库) 出错

提示错误:rubygems/core_ext/kernel_require.rb:120:in `require': cannot load such file -- colored2  
         (LoadError)

 解决办法:
     输入上面提示的colored2的两条gem命令即可解决问题
   sudo gem install colored2
   sudo gem update --system

2、添加组件库到私有spec repo仓库后 执行 pod search搜索不到。

方法一:
        先确认你本地仓库上面确实有你新创建的组件库,这时候可以先删除search缓存文件
    rm ~/Library/Caches/CocoaPods/search_index.json
    ,删除后从新执行pod search ***

    方法二:
    1.切换到某个项目(含有podfile文件)下
    2.执行pod update(提示不能更新)
    3.尝试 pod repo update —verbose获取详细信息,我记得是提示我删除一个 index.lock文件,
4.删除后从新 执行  pod repo update —verbose  会更新本地私有库和master仓库
5.执行pod search ***   创建search索引,可以搜到

3、提交本地podspec到Specs仓库的时候出错,提示repo 文件夹下的spec repo is not clean

方法一: cd到spec repo 文件夹下,执行 git  clean -f
方法二:cd到spec repo 文件夹下,执行  git  stash

2.其他关于pod的问题:
Cocoapods环境配置 :http://blog.csdn.net/cbl643966855/article/details/51120497Cocoapods使用私有库遇到的坑:http://www.jianshu.com/p/1e5927eeb341http://blog.csdn.net/andanlan/article/details/50515434Cocoapods安装或更新出错:http://blog.csdn.net/lindir/article/details/52980526Cocoapods search无法搜索:http://blog.csdn.net/yuanmengong886/article/details/57083919

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

推荐阅读更多精彩内容