CocoaPods建立私有仓库
CocoaPods
是iOS下的第三方包管理工具,有些不想开源的,或者复用的代码,我们可以创建一个私有仓库,通过CocoaPods来管理它们。
如何创建一个私有库?
- 给模块项目打一个tag
因为配置pod信息的时候可以用tag指定版本号
打tag
git tag -m "New tag" '0.1'
把tag推到远程仓库
git push --tags
- 拉取项目(私有仓)到pods管理目录下
先在托管仓库(github,Coding等)创建一个私有仓(一个文件夹)
这里我用的Coding托管的项目,至于为什么不用github(Coding私有库是免费的,墙内环境下访问速度超快,而且是中文的😊)
pod repo add [私有项目名(repo库)] [clone地址]
$ pod repo add NNASpec https://git.coding.net/Leben-NNA/NNASpec.git
拉取完项目,会默认存在~/.cocoapods/repos这个目录下面,这里面有个master文件夹存的是缓存到本地的开源库的pods的.podspec.json格式配置信息,跟master同级你就会发现NNASpec(拉取的repo仓)的文件夹
~/.cocoapods/repos 大致目录结构
├── repos
└── NNASpec
└── [VERSION]
└── [SPEC_NAME].podspec
- 到要上传文件的项目里创建podspec配置文件
这里要先到项目里(最好是readme,license文件同级)
创建podspec文件
$ pod spec create NNATree
podspec创建也可以使用一个叫CocoaPods的Xcode插件生成
创建好podspec文件以后,打开编辑会发现里面有很多参数需要配置,有很多注释信息说明参数作用
这里就举个栗子:(下面是我填写的配置信息)
注意:复制的时候删除后面的注释信息
Pod::Spec.new do |s|
s.name = "NNATree" # 这里要跟上面创建的spec文件名一致
s.version = "0.1" # 这里使用之前的tag
s.summary = "Create a tree by tableview."
s.homepage = "https://git.coding.net/Leben-NNA/NNAMultilevelTree.git"
s.license = "MIT"
s.author = { "Leben NNA" => "leben.nna@gmail.com" }
s.platform = :ios, "7.0"
s.ios.deployment_target = "7.0"
s.source = { :git => "https://git.coding.net/Leben-NNA/NNAMultilevelTree.git", :tag => "0.1" } # 这里使用之前的tag
s.source_files = 'MultilevelTree/*.{h,m}'
s.framework = "UIKit"
s.requires_arc = true
# s.dependency "AFNetworking", "~> 2.2.4"
end
一些参数的注释:
name: 导入pod后的目录名
version: 当前版本号
deployment_target: 配置的target
prefix_header_file: 预编译头文件路径,将该文件的内容插入到Pod的pch文件内
source: 来源的具体路径,是http链接还是本地路径
requires_arc: 是否需要arc
source_files: 指定该目录下包含哪些文件
其他可选参数还包括:
dependency: 指定依赖,如果依赖的库不存在或者依赖库的版本不符合要求将会报错
libraries: 指定导入的库,比如sqlite3
frameworks: 指定导入的framework
weak_frameworks: 弱链接,比如说一个项目同时兼容iOS6和iOS7,但某一个framework只在iOS7上有,这时候如果用强链接,那么在iOS7上运行就会crash,使用weak_frameworks可以避免这种情况。
通配符说明:
a{bb,bc}def.{h,m}表示四个文件abbdef.h abbdef.m abcdef.h abcdef.m
*.{h,m,mm}表示所有的.h .m .mm文件
Class/**/*.{h,m}表示Class目录下的所有.h .m文件
4. 测试下podspec配置文件是否有错误
$ pod lib lint // 验证是否有合格
$ pod spec lint // 这个也可以验证
- 提交代码
# 提交代码
git commit -a -m "PodTest 0.1"
# 将本地的master分支推送到远程仓库
git push origin master
- 创建一个trunk账号(用于上传到公共库Cocoapods)
$ sudo gem install cocoapods // 先更新下Cocoapods版本
$ pod trunk register 邮箱 '昵称' --verbose // 填写账号信息,注册完要去邮箱点一个验证邮件(邮箱最好和git的邮箱保持一致)
$ pod trunk me // 验证完成后可以查看账号信息
- 提交podspec到私有库
# pod repo push [repo仓名] [podspec文件名]
$ pod repo push NNASpec NNATree.podspec
完成之后这个私有库就添加到我们的私有Spec Repo中,可以进入到~/.cocoapods/repos目录下查看
同时远端仓里也完成了推送
顺便把提交到cocoapods(公共库)的方法也提一句吧,前面的步骤都一样只需要用到上一步注册了的trunk提交就可以了
# 提交podspec文件到trunk
pod trunk push NNATree.podspec
- 使用库
Podfile中填写
source 'https://github.com/CocoaPods/Specs.git' // 公共库
source 'https://git.coding.net/Leben-NNA/NNASpec.git' // 私有库
platform :ios, '7.0'
pod 'NNATree/Tree', '0.1' // 使用某一个部分
pod 'NNATree', '0.1' // 使用整个库
然后在终端输入账号密码就可以引入私有库了
值得注意的一点:如果添加了私有库就需要加入source,默认是不需要添加的,source是用于找到仓库的,
source公共库和私有库的顺序会影响查找顺序,假如公共库和私有库都有名字为AAA的轮子,如果公共库写在前面,就先在公共库中查找,如果找到了,就不会在私有库中找。
- 删除一个私有库
$ pod repo remove NNASpec
这样就从本地删除了
当然我们还可以通过下面的代码添加回来
$ pod repo add NNASpec git@coding.net:Leben-NNA/NNASpec.git
- 如果想删除私有Spec Repo下的某一个podspec,此时只需要cd到
~/.cocoapods/repos/NNASpec
目录下,删掉库目录
$ rm -Rf NNATree
然后再将git的变动push到远端仓库即可
git add --all .
git commit -m "remove unuseful pods"
git push origin master
备注:本文抄袭自项目模块化处理之Cocoapods 私有库管理,略有删改。