Cocoapods是iOS的一个依赖管理工具,支持swift和OC语言。支持超过10000个第三方开源库。使用它可以方便的管理和更新项目中使用到的第三方库。也可以将自己的项目中的公共组件交由它去管理。当我们的项目想要抽出来作为一个第三方库交由cocoapods去管理,并且只是给内部人员使用,那么就需要使用私有库。每种语言发展到一个阶段,就会出现响应的依赖管理工具,例如 Java 语言的 Maven,nodejs 的 npm。随着 iOS 开发者的增多,CocoaPods的出现是必然的。
安装cocoapods:
gem服务器在国外,提供了非常丰富的终端应用程序!gem服务器需要一个ruby的运行环境,mac电脑上本身有ruby的运行环境。但是gem服务器具有防火墙,不易访问,淘宝制作了一个镜像文件,每隔15分钟就去与gem服务器进行一次数据同步,所以国内人使用只需要访问淘宝的镜像文件就可以。
第一步:查看gem原 gem source –l
第二步:添加源(淘宝源)sudo gem sources -a https://ruby.taobao.org/
第三步:查看源 gem source –l
第四步:删除ruby源 sudo gem sources -r https://rubygems.org/
第五步:再次查看源,此时只有淘宝源 gem source –l
第六步:安装Cocopods(gem服务器会自动帮助我们安装) sudo gem install cocoapods
第七步:设置源 pod setup 将会在终端看到Setup completed代表成功(还有一点需要注意,pod setup 在执行时,会输出 Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods 目录下的master下面,如果你等太久,可以试着 cd 到那个目录,用 du -sh * 来查看下载进度。你也可以使用 CocoaPods 的镜像索引来提高下载速度。所有的项目的 Podspec 文件都托管在 https://github.com/CocoaPods/Specs。第一次执行pod setup时,CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods 目录下,这个索引文件比较大,有 80M 左右。所以第一次更新时非常慢,笔者就更新了将近一个小时才完成。)
也可以删除podrepo中的东西。可以使用下面的命令:
pod repo remove master //删除本地的repo
//删除完了也可以再加上
pod repo add master https://github.com/CocoaPods/Specs
创建私有库:
1:创建私有的 spec Repo
先来说第一步,什么是Spec Repo?他是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,他实际是一个Git仓库remote端
在GitHub上,但是当你使用了Cocoapods后他会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。这个master目录的结构是这个样子的
.
├── Specs
└── [SPEC_NAME]
└── [VERSION]
└── [SPEC_NAME].podspec
创建私有的spec repo
进入到~/.cocoapods/repos目录下,然后在终端输入:
pod repo add LFDBusSpec http://****.****.cn/****/LeFinancePods.git
LFDBusSpec:本地私有的Spec Repo的名字。
http://****.cn/****/LeFinancePods.git:申请一个git远程仓库用来管理每次podSpec文件的变化。
此时如果成功的话进入到~/.cocoapods/repos目录下就可以看到LFDBusSpec这个目录了。至此第一步创建私有Spec Repo完成。当然此时这个文件夹是个空的。
创建pod项目工程文件:
使用命令创建一个pod项目:
pod lib create LFDBusPrivateProject,之后他会问你四个问题,1.是否需要一个例子工程;2.选择一个测试框架;3.是否基于View测试;4.类的前缀;4个问题的具体介绍可以去看官方文档,我这里选择的是1.yes;2.Specta/Expecta;3.yes;4.PTL。 问完这4个问题他会自动执行pod install命令创建项目并生成依赖。创建完成之后就可以打开你创建的pod项目啦。项目的结构是:
PodTestLibrary
├── Example #demo APP
│ ├── PodTestLibrary
│ ├── PodTestLibrary.xcodeproj
│ ├── PodTestLibrary.xcworkspace
│ ├── Podfile #demo APP 的依赖描述文件
│ ├── Podfile.lock
│ ├── Pods #demo APP 的依赖文件
│ └── Tests
├── LICENSE #开源协议 默认MIT
├── Pod #组件的目录
│ ├── Assets #资源文件
│ └── Classes #类文件
├── PodTestLibrary.podspec #第三步要创建的podspec文件
└── README.md #markdown格式的README
在Class项目中有一个Replaceme的文件,将自己写好的framework放到classs文件夹即可。
编辑podSpec文件:
Pod::Spec.new do |s|
s.name = 'LeNetworkFrame' //私有库的名字
s.version = '0.1.1' //每次提交的tag值
s.summary = 'this is a summary' //总结
s.description = <<-DESC //描述
LeFinance Cashier SDK for iOS. Including Pay functions.
DESC
s.homepage = 'http://****/****/NetworkPrivatePod' //私有库的地址,主页,这里要填写可以访问到的地址,不然验证不通过
s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2' //截图
s.license = { :type => 'MIT', :file => 'LICENSE' } //开源协议
s.author = { '1203646961@qq.com' => 'xuli5@le.com' } //作者信息
s.source = { :git => 'http://legitlab.letv.cn/finance_mobile/NetworkPrivatePod.git', :tag => s.version.to_s }
//项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>' //多媒体介绍地址
s.ios.deployment_target = '8.0' //支持的平台及版本
s.source_files = 'LeNetworkFrame/Classes//.{h,m}' //代码源文件地址,/
表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
s.resource_bundles = {
'LeNetworkFrame' => ['LeNetworkFrame/Assets/*.png']
} //资源文件地址
s.public_header_files = 'Pod/Classes/*/.h' //公开头文件地址
s.frameworks = 'UIKit', 'MapKit' //所需的framework,多个用逗号隔开
s.dependency 'AFNetworking' //依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
s.dependency 'Mantle'
end
验证podspec文件,进入到podspec文件的上级目录中,在终端输入:
pod lib lint 验证通过后就可以将私有库的项目打上tag值推送到远端啦。
向spec repo提交podspec
向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。 向我们的私有Spec Repo提交podspec只需要一个命令
进入到podspec所在的文件的上层目录后,在终端输入:
pod repo push LFDBusSpec LFDBusFrameWork.podspec
LFDBusSpec:本地私有spec repo的名字,
LFDBusFrameWork.podspec:podspec文件的名字
完成之后这个组件库就添加到我们的私有Spec Repo中了,可以进入到~/.cocoapods/repos/WTSpecs目录下查看
├── LICENSE
├── LFDBusSpec
│ └── 0.1.0
│ └──LFDBusFrameWork
└── README.md
再去看我们的Spec Repo远端仓库,也有了一次提交,这个podspec也已经被Push上去了。至此,我们的这个组件库就已经制作添加完成了,使用pod search命令就可以查到我们自己的库了
在完成这一系列步骤之后,我们就可以在正式项目中使用这个私有的Pod了只需要在项目的Podfile里增加以下一行代码即可
pod 'LFDBusFrameWork'
然后执行pod update,更新库依赖,然后打卡项目可以看到,我们自己的库文件已经出现在Pods子项目中的Pods子目录下了,而不再是Development Pods。
pod update首先回去repo spec中查找到podspec文件,通过source.name验证是否与podfile中的名字是否一致,验证成功后,就会根据 Podspec 中的 s.source_files 找到需要导入代码文件,并通过其他的数据找到对应的配置文件或资源文件等。最后,将其下载到本地项目中。
比较好的文章:
http://blog.wtlucky.com/blog/2015/02/26/create-private-podspec/
http://www.jianshu.com/p/fb202af858fd
网友评论